meta-sovereign 0.49.17 → 0.50.0

package/README.hi.md

@@ -1,6 +1,20 @@
 # meta-sovereign (languages: [en](README.md) • [zh](README.zh.md) • hi • [ru](README.ru.md))
 
-`meta-sovereign` एक व्यक्तिगत **meta profile sovereign** सिस्टम है: ऐसा unified inbox, CRM और automation platform जिसका स्वामित्व सचमुच उपयोगकर्ता के पास रहता है। यह local-first और privacy-respecting है, और VK, Telegram, X, WhatsApp, Facebook, LinkedIn, career.habr.com, hh.ru, superjob.ru तथा email providers से contacts, chats, email और patterns को एक जगह लाता है।
+**आप जिन भी नेटवर्क पर बात करते हैं, उन सबके लिए एक इनबॉक्स, एक संपर्क सूची और एक ही ऑटोमेशन — आपकी अपनी मशीन पर।**
+
+meta-sovereign **किसी व्यक्ति या संगठन को ऑनलाइन दर्शाता है**। Telegram, VK, WhatsApp, Facebook और Instagram, X, LinkedIn, ईमेल, GitHub, Upwork, PeoplePerHour और जॉब बोर्ड (career.habr.com, hh.ru, superjob.ru और अन्य) जोड़ें और हर बातचीत एक ही ऐप से करें। Local-first और open source: आपके संदेश, संपर्क और कुंजियाँ आपके अपने स्टोर में रहती हैं, एन्क्रिप्टेड बैकअप के साथ और बीच में कोई क्लाउड नहीं।
+
+### किसके लिए
+
+| कौन / क्या            | meta-sovereign कैसे मदद करता है                                                                                                                            |
+| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **व्यक्ति**           | सभी चैट एक जगह, लंबे समय से चुप लोगों से फिर जुड़ना, जो कहा गया वह याद रखना (तथ्य), हर जॉब साइट पर एक जैसा CV।                                             |
+| **बिक्री**            | हर नेटवर्क के लीड एक CRM में, नियम से ऑडियंस, mass-personal outreach जिसमें हर संदेश एक ही बार और शालीनता से जाता है, फ़ॉलो-अप, तेज़ उत्तर।                |
+| **मार्केटिंग**        | ऑडियंस को broadcast, Telegram चैनल, LinkedIn और X पर पोस्ट, community सदस्य हमेशा ताज़ा, एक opt-out सूची जिसे हर स्वचालित भेजना मानता है।                  |
+| **उपयोगकर्ता सहायता** | हर आने वाले संदेश के लिए एक Operator कतार, VK community या Telegram Business खाते से उत्तर, सुरक्षित ड्राफ़्ट के रूप में auto-reply, तथ्यों का ज्ञान-आधार। |
+| **संगठन**             | ब्रांड, दुकान या प्रोजेक्ट के लिए वही उपकरण: उसके खाते, उसके संपर्क, उसका डेटा उसकी अपनी मशीन पर। टीम मोड (कई ऑपरेटर) रोडमैप में है।                       |
+
+हर परिदृश्य के लिए आज क्या चलता है, क्या आंशिक है और आगे क्या है — रोडमैप में: [`docs/ROADMAP.hi.md`](docs/ROADMAP.hi.md)।
 
 ## अभी चलाकर देखें (install नहीं)
 
@@ -41,9 +55,11 @@ 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)।
 
 ## SPA को server से जोड़ें
 
@@ -61,33 +77,25 @@ SPA server को इस क्रम में चुनता है ([`js/src
 
 ## यह क्या करता है
 
-- **Unified inbox**: VK, Telegram, X, WhatsApp, Facebook, LinkedIn, career.habr.com, hh.ru, superjob.ru और email।
-- **CV synchronisation**: LinkedIn, hh.ru, Habr Career, Naukri, VietnamWorks, TopCV और SuperJob — हर profile को अपने ही browser से पढ़ें, field दर field अंतर देखें और तय किए गए values वापस लिखें ([`docs/CV-SYNC.hi.md`](docs/CV-SYNC.hi.md))।
-- **Greetings**: VK, Telegram, WhatsApp, Messenger, X और email पर "hi" या greeting sticker से बातचीत शुरू करें, जैसे [konard/vk-bot](https://github.com/konard/vk-bot) करता है — UI में stickers चुनें, देखें किसे क्या जाएगा, और messages के बीच pause के साथ भेजें ([`docs/GREETINGS.hi.md`](docs/GREETINGS.hi.md))।
-- **Personal CRM**: contacts, communities, group memberships, intersections और mass-personal outreach।
-- **Personal memory**: conversations से structured `question → answer` facts।
-- **Conversation automation platform**: pattern editors, reply-variation editors और n8n-style dialog graphs।
-- **Portable data store**: binary [Doublets](https://github.com/linksplatform/doublets-rs) + text [Links Notation](https://github.com/link-foundation/links-notation), automated backups और `.lino` import/export।
-- **Local-first runtime**: user-owned devices के बीच WebRTC sync और optional self-hosted personal cloud।
-- **Two stacks**: JS + Rust/WebAssembly default stack और pure Rust server/microservice variant; on-disk format साझा है।
-
-पूर्ण requirement → status mapping [`docs/REQUIREMENTS.hi.md`](docs/REQUIREMENTS.hi.md) में है; per-issue case studies [`docs/case-studies/`](docs/case-studies/) में हैं।
-
-Telegram क्लाइंट की हर सुविधा — समर्थित, आंशिक, रोकी हुई या असमर्थित, और API या वेब ऐप से पहुँच — [`docs/FEATURES.hi.md`](docs/FEATURES.hi.md) में दर्ज है।
+- **एकीकृत इनबॉक्स**: 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।
+- **स्मृति**: बातचीत से निकाले गए `प्रश्न → उत्तर` तथ्य, चैट में जाँच के साथ।
+- **अभिवादन**: VK, Telegram, WhatsApp, Messenger, X और ईमेल पर "hi" या स्टिकर से बातचीत शुरू करें, [konard/vk-bot](https://github.com/konard/vk-bot) की तरह ([`docs/GREETINGS.hi.md`](docs/GREETINGS.hi.md))।
+- **CV सिंक**: LinkedIn, hh.ru, Habr Career, Naukri, VietnamWorks, TopCV और SuperJob पर आपके अपने ब्राउज़र से, फ़ील्ड-दर-फ़ील्ड ([`docs/CV-SYNC.hi.md`](docs/CV-SYNC.hi.md))।
+- **आपका डेटा सुरक्षित**: crash-safe लोकल स्टोर ([Doublets](https://github.com/linksplatform/doublets-rs) + [Links Notation](https://github.com/link-foundation/links-notation)), स्वचालित schema migrations ([`docs/DATA-MIGRATIONS.hi.md`](docs/DATA-MIGRATIONS.hi.md)), streamed एन्क्रिप्टेड बैकअप, भरी डिस्क का प्रबंधन, एन्क्रिप्टेड secrets, एक लोकल सर्वर जो दूसरी साइटों को मना करता है।
+- **हर जगह**: वेब ऐप, सर्वर सहित डेस्कटॉप ऐप, मोबाइल shells, आपके उपकरणों के बीच WebRTC सिंक, ऑफ़लाइन लिखे को बाद में भेजना; pure-Rust सर्वर वही on-disk format उपयोग करता है।
+- **चार भाषाएँ**: ऐप और हर दस्तावेज़ अंग्रेज़ी, रूसी, हिंदी और चीनी में।
+
+हर नेटवर्क की हर सुविधा — समर्थित, आंशिक या असमर्थित, और API या वेब ऐप से पहुँच: [`docs/FEATURES.hi.md`](docs/FEATURES.hi.md)। हर आवश्यकता और उसका प्रमाण: [`docs/REQUIREMENTS.hi.md`](docs/REQUIREMENTS.hi.md)।
 
 ## स्थिति
 
-issue #1 का prototype implement हो चुका है और PR #2 में track है:
-
-- **Data layer (R-A\*)**: `DualStore` Doublets binary और Links Notation text को lock-step में रखता है; AES-256-GCM backups और `secret:*` link encryption (केवल `MS_SECRET_PASSPHRASE` सेट होने पर; बाक़ी store encrypted नहीं) उपलब्ध हैं।
-- **Service connectors (R-E\*)**: VK, Telegram, X, WhatsApp, Facebook, LinkedIn, career.habr.com, hh.ru, superjob.ru और email के archive parsers तथा live connectors।
-- **Pattern matching और automation (R-C\*)**: `inferRegex`, `simplifyRegex`, `compilePeg`, fuzzy reply variation extraction और `createGraph` / `runGraph`।
-- **CRM (R-D\*)**: contact aggregation, audience DSL, mass-personal outreach, profile और resume sync envelopes।
-- **CV synchronisation (R-V\*)**: सात job platforms के declarative browser plans, cross-platform diff, चुनिंदा writes और हर run के लिए HTML/screenshot artifacts वाली redacted telemetry stream।
-- **Distribution (R-F\*)**: NPM library, CLI, local server, Electron shell, Capacitor mobile shell और Docker web + WebRTC microservices।
-- **Stacks (R-G\*)**: JS server + React SPA + Rust/WASM heavy workloads, साथ में pure Rust server।
-- **Hardening (R-K\*)**: soft delete by default, AES-256-GCM master-key vault, multiple unlock methods और encrypted export।
-- **Browser publishing (R-L\*)**: GitHub Pages CI workflow, public SPA URL और user-first README/user guide।
+आवश्यकताएँ R-A से R-Z24 पूरी हैं और CI में Linux, macOS और Windows पर Node, Bun और Deno के साथ जाँची जाती हैं, Chromium में browser end-to-end tests के साथ। Tests नकली सर्वर उपयोग करते हैं: किसी असली खाते से कुछ नहीं भेजा जाता, और केवल Telegram के संदेश-प्रदर्शन को असली स्टोर पर भी जाँचा गया। परिदृश्य-वार स्थिति और अगले कदम (लाइव खातों पर जाँच, OAuth साइन-इन, टीम मोड, बिक्री pipeline, अभियान परिणाम): [`docs/ROADMAP.hi.md`](docs/ROADMAP.hi.md)।
 
 ## Repository structure
 

package/README.md

@@ -1,6 +1,20 @@
 # meta-sovereign (languages: en • [zh](README.zh.md) • [hi](README.hi.md) • [ru](README.ru.md))
 
-A personal **meta profile sovereign** system — a unified inbox + CRM + automation platform that the user actually owns. Local-first, privacy-respecting, with all your contacts, chats, email, and patterns from VK, Telegram, X, WhatsApp, Facebook, LinkedIn, career.habr.com, hh.ru, superjob.ru, email, GitHub, Upwork, and PeoplePerHour providers.
+**One inbox, one contact book and one set of automations for every network you speak through — running on your own machine.**
+
+meta-sovereign represents **a person or an organisation online**. Connect Telegram, VK, WhatsApp, Facebook and Instagram, X, LinkedIn, email, GitHub, Upwork, PeoplePerHour and job boards (career.habr.com, hh.ru, superjob.ru and more), and work every conversation from one app. Local-first and open source: your messages, contacts and keys stay in a store you own, with encrypted backups and no cloud in between.
+
+### Built for
+
+| Who / what        | How meta-sovereign helps                                                                                                                                         |
+| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Individuals**   | All your chats in one place, reconnect with people gone quiet, remember what was said (facts), one CV on every job site.                                         |
+| **Sales**         | Leads from every network in one CRM, audiences by rule, mass-personal outreach that sends each message once and politely, follow-ups, fast replies.              |
+| **Marketing**     | Broadcasts to audiences, posts to Telegram channels, LinkedIn and X, community members kept fresh, an opt-out list every automated send honours.                 |
+| **User support**  | One Operator queue for every incoming message, answers from a VK community or Telegram Business account, auto-replies as safe drafts, a knowledge base of facts. |
+| **Organisations** | The same tools for a brand, a shop or a project: its accounts, its contacts, its data on its own machine. Team mode (several operators) is on the roadmap.       |
+
+What works for each scenario today, what is partial and what comes next is in the roadmap: [`docs/ROADMAP.md`](docs/ROADMAP.md).
 
 ## Try it now (no install)
 
@@ -41,9 +55,11 @@ 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.
 
 ## Connect the SPA to your server
 
@@ -61,34 +77,25 @@ The full user-facing flow — install nothing, install Rust server, install JS s
 
 ## What it does
 
-- **Unified inbox** spanning VK, Telegram, X, WhatsApp, Facebook, LinkedIn, career.habr.com, hh.ru, superjob.ru, email, GitHub, Upwork, and PeoplePerHour.
-- **CV synchronisation** across LinkedIn, hh.ru, Habr Career, Naukri, VietnamWorks, TopCV and SuperJob: read every profile through your own browser, see the differences field by field, and push the agreed values back ([`docs/CV-SYNC.md`](docs/CV-SYNC.md)).
-- **Greetings**: open dialogs on VK, Telegram, WhatsApp, Messenger, X and email with a "hi" or a greeting sticker, the way [konard/vk-bot](https://github.com/konard/vk-bot) does — pick stickers in the UI, preview who gets what, send with a pause between messages ([`docs/GREETINGS.md`](docs/GREETINGS.md)).
-- **Chat** with the connected Telegram account 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).
-- **Personal CRM**: contacts, communities, group memberships, intersections, mass-personal outreach.
-- **Personal memory**: structured `question → answer` facts captured automatically from conversations.
-- **Conversation automation platform**: pattern editors, reply-variation editors, n8n-style dialog graphs.
-- **Portable data store**: dual binary ([Doublets](https://github.com/linksplatform/doublets-rs)) + text ([Links Notation](https://github.com/link-foundation/links-notation)) representation, automated backups, `.lino` import/export.
-- **Local-first runtime**: WebRTC sync between user-owned devices, optional self-hosted personal cloud.
-- **Two stacks**: JS + Rust/WebAssembly (default) and pure Rust (server/microservice variant). The on-disk format is shared.
-
-The full requirement → status mapping lives in [`docs/REQUIREMENTS.md`](docs/REQUIREMENTS.md); the per-issue case studies live in [`docs/case-studies/`](docs/case-studies/).
-
-Every Telegram client feature, with what is supported, partial, parked or not supported, and whether it is reachable by API or web app, is tracked in [`docs/FEATURES.md`](docs/FEATURES.md).
+- **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.
+- **Memory**: structured `question → answer` facts captured from conversations, checked in the chat.
+- **Greetings**: open dialogs on VK, Telegram, WhatsApp, Messenger, X and email with a "hi" or a greeting sticker, the way [konard/vk-bot](https://github.com/konard/vk-bot) does ([`docs/GREETINGS.md`](docs/GREETINGS.md)).
+- **CV synchronisation** across LinkedIn, hh.ru, Habr Career, Naukri, VietnamWorks, TopCV and SuperJob through your own browser, field by field ([`docs/CV-SYNC.md`](docs/CV-SYNC.md)).
+- **Your data, safe**: a crash-safe local store ([Doublets](https://github.com/linksplatform/doublets-rs) binary + [Links Notation](https://github.com/link-foundation/links-notation) text), automatic schema migrations ([`docs/DATA-MIGRATIONS.md`](docs/DATA-MIGRATIONS.md)), streamed encrypted backups, full-disk handling, encrypted secrets, a local server that refuses other sites.
+- **Everywhere you are**: the hosted web app, a desktop app with the server inside, mobile shells, WebRTC sync between your own devices, offline writes replayed later; a pure-Rust server variant shares the on-disk format.
+- **Four languages**: the app and every document are in English, Russian, Hindi and Chinese.
+
+Every feature, network by network, with what is supported, partial or not supported and whether it is reachable by API or web app: [`docs/FEATURES.md`](docs/FEATURES.md). Every requirement with its evidence: [`docs/REQUIREMENTS.md`](docs/REQUIREMENTS.md).
 
 ## Status
 
-The prototype targeted by issue #1 is implemented and tracked in PR #2:
-
-- **Data layer (R-A\*)**: `DualStore` keeps Doublets binary + Links Notation text in lock-step, with AES-256-GCM encrypted backups (`createBackupScheduler`) and `secret:*` link encryption (only when `MS_SECRET_PASSPHRASE` is set; the rest of the store is not encrypted).
-- **Service connectors (R-E\*)**: archive parser + live API connector for VK, Telegram, X, WhatsApp, Facebook, LinkedIn, career.habr.com, hh.ru, superjob.ru, email, GitHub, Upwork, and PeoplePerHour.
-- **Pattern matching and automation (R-C\*)**: `inferRegex` / `simplifyRegex` / `compilePeg`, fuzzy reply-variation extraction, and an n8n-style automation graph (`createGraph` + `runGraph`).
-- **CRM (R-D\*)**: contact aggregation, audience DSL, mass-personal outreach, profile and resume sync envelopes.
-- **CV synchronisation (R-V\*)**: declarative browser plans for seven job platforms, cross-platform diff, selective writes, and a redacted telemetry stream with HTML/screenshot artifacts for every run.
-- **Distribution (R-F\*)**: NPM library, CLI (`js/bin/meta-sovereign.js`), local server (`meta-sovereign serve`), Electron shell, Capacitor mobile shell, Docker microservices for web + WebRTC.
-- **Stacks (R-G\*)**: default JS server + React SPA + Rust/WASM heavy workloads; alternative pure-Rust server (`meta-sovereign-rs serve`).
-- **Hardening (R-K\*)**: soft-delete by default, AES-256-GCM master-key vault with multi-method unlock, encrypted export.
-- **Browser publishing (R-L\*)**: GitHub Pages CI workflow, SPA on a public URL, user-first README and user guide.
+Requirements R-A to R-Z24 are done and checked in CI on Node, Bun and Deno across Linux, macOS and Windows, with browser end-to-end tests in Chromium. Tests use fakes: nothing is sent from a real account in tests, and only Telegram's message display was also checked against a real store. The scenario-by-scenario state and the next steps (live verification, guided sign-in, team mode, a sales pipeline, campaign results) are in [`docs/ROADMAP.md`](docs/ROADMAP.md).
 
 ## Repository structure
 

package/README.ru.md

@@ -1,6 +1,20 @@
 # meta-sovereign (languages: [en](README.md) • [zh](README.zh.md) • [hi](README.hi.md) • ru)
 
-`meta-sovereign` — персональная система **meta profile sovereign**: единый inbox, CRM и платформа автоматизации, которыми реально владеет пользователь. Система local-first, уважает приватность и собирает контакты, чаты, почту и паттерны из VK, Telegram, X, WhatsApp, Facebook, LinkedIn, career.habr.com, hh.ru, superjob.ru и email-провайдеров.
+**Один inbox, одна книга контактов и одни автоматизации для всех сетей, через которые вы общаетесь, — на вашем собственном компьютере.**
+
+meta-sovereign представляет **человека или организацию в интернете**. Подключите Telegram, VK, WhatsApp, Facebook и Instagram, X, LinkedIn, почту, GitHub, Upwork, PeoplePerHour и сайты вакансий (career.habr.com, hh.ru, superjob.ru и другие) и ведите все разговоры в одном приложении. Local-first и open source: сообщения, контакты и ключи остаются в вашем хранилище, с зашифрованными резервными копиями и без облака посередине.
+
+### Для кого
+
+| Кто / что       | Чем помогает meta-sovereign                                                                                                                                              |
+| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| **Люди**        | Все чаты в одном месте, возобновить общение с теми, кто давно молчит, помнить, что было сказано (факты), одно резюме на всех сайтах вакансий.                            |
+| **Продажи**     | Лиды из всех сетей в одной CRM, аудитории по правилам, массово-персональные рассылки, где каждое сообщение уходит один раз и вежливо, follow-up, быстрые ответы.         |
+| **Маркетинг**   | Рассылки по аудиториям, посты в каналы Telegram, LinkedIn и X, актуальные участники сообществ, список отписавшихся, который соблюдает каждая автоматическая отправка.    |
+| **Поддержка**   | Одна очередь оператора для всех входящих, ответы от имени сообщества VK или аккаунта Telegram Business, автоответы как безопасные черновики, база знаний из фактов.      |
+| **Организации** | Те же инструменты для бренда, магазина или проекта: его аккаунты, его контакты, его данные на его компьютере. Командный режим (несколько операторов) — в дорожной карте. |
+
+Что уже работает для каждого сценария, что частично и что дальше — в дорожной карте: [`docs/ROADMAP.ru.md`](docs/ROADMAP.ru.md).
 
 ## Попробовать сразу (без установки)
 
@@ -41,9 +55,11 @@ 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).
 
 ## Подключение SPA к серверу
 
@@ -61,33 +77,25 @@ SPA выбирает сервер в таком порядке ([`js/src/web/dis
 
 ## Что умеет система
 
-- **Единый inbox** для VK, Telegram, X, WhatsApp, Facebook, LinkedIn, career.habr.com, hh.ru, superjob.ru и email.
-- **Синхронизация CV** между LinkedIn, hh.ru, Habr Career, Naukri, VietnamWorks, TopCV и SuperJob: прочитать каждый профиль через собственный браузер, увидеть различия по полям и записать согласованные значения обратно ([`docs/CV-SYNC.ru.md`](docs/CV-SYNC.ru.md)).
-- **Приветствия**: начинать диалоги в VK, Telegram, WhatsApp, Messenger, X и email с «привет» или стикера-приветствия, как это делает [konard/vk-bot](https://github.com/konard/vk-bot), — выбрать стикеры в интерфейсе, посмотреть, кому что уйдёт, и отправить с паузой между сообщениями ([`docs/GREETINGS.ru.md`](docs/GREETINGS.ru.md)).
-- **Personal CRM**: контакты, сообщества, членства в группах, пересечения, массовый персонализированный outreach.
-- **Personal memory**: структурированные факты `question → answer`, автоматически извлеченные из разговоров.
-- **Платформа conversation automation**: редакторы паттернов, варианты ответов, n8n-style dialog graphs.
-- **Переносимое хранилище**: бинарное [Doublets](https://github.com/linksplatform/doublets-rs) + текстовое [Links Notation](https://github.com/link-foundation/links-notation), автоматические backup, `.lino` import/export.
-- **Local-first runtime**: WebRTC sync между устройствами пользователя, optional self-hosted personal cloud.
-- **Два стека**: JS + Rust/WebAssembly по умолчанию и pure Rust server/microservice variant. On-disk format общий.
-
-Полная карта requirement → status находится в [`docs/REQUIREMENTS.ru.md`](docs/REQUIREMENTS.ru.md); per-issue case studies — в [`docs/case-studies/`](docs/case-studies/).
-
-Каждая функция клиента Telegram — поддерживается, частично, в парковке или нет, и доступна ли через API или веб-приложение — учтена в [`docs/FEATURES.ru.md`](docs/FEATURES.ru.md).
+- **Единый 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: быстрые ответы, приветствие и сообщение об отсутствии, часы работы, чат-боты.
+- **Память**: структурированные факты `вопрос → ответ` из разговоров, с проверкой прямо в чате.
+- **Приветствия**: начинать диалоги в VK, Telegram, WhatsApp, Messenger, X и почте с «привет» или стикера, как [konard/vk-bot](https://github.com/konard/vk-bot) ([`docs/GREETINGS.ru.md`](docs/GREETINGS.ru.md)).
+- **Синхронизация резюме** между LinkedIn, hh.ru, Habr Career, Naukri, VietnamWorks, TopCV и SuperJob через ваш собственный браузер, поле за полем ([`docs/CV-SYNC.ru.md`](docs/CV-SYNC.ru.md)).
+- **Ваши данные в безопасности**: локальное хранилище, переживающее сбои ([Doublets](https://github.com/linksplatform/doublets-rs) + [Links Notation](https://github.com/link-foundation/links-notation)), автоматические миграции схемы ([`docs/DATA-MIGRATIONS.ru.md`](docs/DATA-MIGRATIONS.ru.md)), потоковые зашифрованные резервные копии, работа при полном диске, зашифрованные секреты, локальный сервер, который не пускает чужие сайты.
+- **Везде, где вы**: веб-приложение, настольное приложение со встроенным сервером, мобильные оболочки, WebRTC-синхронизация между вашими устройствами, офлайн-записи, которые доотправляются позже; вариант сервера на чистом Rust использует тот же формат на диске.
+- **Четыре языка**: приложение и все документы — на английском, русском, хинди и китайском.
+
+Каждая функция по каждой сети — поддерживается, частично или нет, и доступна ли через API или веб-приложение: [`docs/FEATURES.ru.md`](docs/FEATURES.ru.md). Каждое требование с подтверждением: [`docs/REQUIREMENTS.ru.md`](docs/REQUIREMENTS.ru.md).
 
 ## Статус
 
-Прототип для issue #1 реализован и отслежен в PR #2:
-
-- **Data layer (R-A\*)**: `DualStore` держит Doublets binary и Links Notation text в lock-step, поддерживает AES-256-GCM backups и encryption для `secret:*` links (только при заданной `MS_SECRET_PASSPHRASE`; остальное хранилище не шифруется).
-- **Service connectors (R-E\*)**: archive parsers и live API connectors для VK, Telegram, X, WhatsApp, Facebook, LinkedIn, career.habr.com, hh.ru, superjob.ru и email.
-- **Pattern matching and automation (R-C\*)**: `inferRegex`, `simplifyRegex`, `compilePeg`, fuzzy reply-variation extraction и `createGraph` / `runGraph`.
-- **CRM (R-D\*)**: contact aggregation, audience DSL, mass-personal outreach, profile и resume sync envelopes.
-- **Синхронизация CV (R-V\*)**: декларативные browser plans для семи job platforms, cross-platform diff, выборочная запись и redacted telemetry с HTML/screenshot artifacts для каждого запуска.
-- **Distribution (R-F\*)**: NPM library, CLI, local server, Electron shell, Capacitor mobile shell, Docker microservices для web + WebRTC.
-- **Stacks (R-G\*)**: JS server + React SPA + Rust/WASM heavy workloads; alternative pure Rust server.
-- **Hardening (R-K\*)**: soft-delete by default, AES-256-GCM master-key vault, несколько методов unlock, encrypted export.
-- **Browser publishing (R-L\*)**: GitHub Pages CI workflow, публичный SPA URL, README и user guide для пользователя.
+Требования R-A–R-Z24 выполнены и проверяются в CI на Node, Bun и Deno в Linux, macOS и Windows, с браузерными end-to-end тестами в Chromium. Тесты используют подделки: ничего не отправляется с реального аккаунта, и только отображение сообщений Telegram дополнительно проверено на реальном хранилище. Состояние по сценариям и следующие шаги (проверка на живых аккаунтах, вход по OAuth, командный режим, воронка продаж, результаты кампаний) — в [`docs/ROADMAP.ru.md`](docs/ROADMAP.ru.md).
 
 ## Структура репозитория
 

package/README.zh.md

@@ -1,6 +1,20 @@
 # meta-sovereign (languages: [en](README.md) • zh • [hi](README.hi.md) • [ru](README.ru.md))
 
-`meta-sovereign` 是个人 **meta profile sovereign** 系统：用户自己拥有的统一收件箱、CRM 和自动化平台。它优先本地运行，尊重隐私，汇总来自 VK、Telegram、X、WhatsApp、Facebook、LinkedIn、career.habr.com、hh.ru、superjob.ru 以及电子邮件提供商的联系人、聊天、邮件和模式数据。
+**为您使用的每个网络提供同一个收件箱、同一本通讯录和同一套自动化——运行在您自己的电脑上。**
+
+meta-sovereign 在网上**代表一个人或一个组织**。连接 Telegram、VK、WhatsApp、Facebook 和 Instagram、X、LinkedIn、电子邮件、GitHub、Upwork、PeoplePerHour 以及招聘网站（career.habr.com、hh.ru、superjob.ru 等），在一个应用中处理所有对话。本地优先、开源：您的消息、联系人和密钥保存在您自己的存储中，有加密备份，中间没有云。
+
+### 适用对象
+
+| 谁 / 什么    | meta-sovereign 如何帮助                                                                                                  |
+| ------------ | ------------------------------------------------------------------------------------------------------------------------ |
+| **个人**     | 所有聊天集中一处，重新联系久未联系的人，记住说过的话（事实），在每个招聘网站上保持同一份简历。                           |
+| **销售**     | 来自每个网络的潜在客户汇入一个 CRM，按规则划分受众，大规模个性化外联（每条消息只发一次、礼貌有节奏），跟进，快速回复。   |
+| **市场营销** | 向受众群发，在 Telegram 频道、LinkedIn 和 X 发帖，社区成员保持最新，每次自动发送都遵守退订名单。                         |
+| **用户支持** | 所有来信进入一个 Operator 队列，以 VK 社区或 Telegram Business 账号回复，自动回复以安全草稿形式出现，事实构成知识库。    |
+| **组织**     | 同样的工具服务于品牌、店铺或项目：它的账号、它的联系人、它的数据都在它自己的电脑上。团队模式（多名操作员）已列入路线图。 |
+
+每个场景今天能用什么、哪些是部分支持、下一步做什么，请见路线图：[`docs/ROADMAP.zh.md`](docs/ROADMAP.zh.md)。
 
 ## 立即试用（无需安装）
 
@@ -41,9 +55,11 @@ 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)。
 
 ## 将 SPA 连接到服务器
 
@@ -61,33 +77,25 @@ SPA 按以下顺序选择服务器（[`js/src/web/discover.js`](js/src/web/disco
 
 ## 功能概览
 
-- **统一收件箱**：覆盖 VK、Telegram、X、WhatsApp、Facebook、LinkedIn、career.habr.com、hh.ru、superjob.ru 和电子邮件。
-- **简历同步**：覆盖 LinkedIn、hh.ru、Habr Career、Naukri、VietnamWorks、TopCV 和 SuperJob——通过你自己的浏览器读取每份简历，逐字段查看差异，再把商定的内容写回去（[`docs/CV-SYNC.zh.md`](docs/CV-SYNC.zh.md)）。
-- **问候**：像 [konard/vk-bot](https://github.com/konard/vk-bot) 那样，用一句“你好”或一个问候贴纸在 VK、Telegram、WhatsApp、Messenger、X 和电子邮件中开启对话——在界面中挑选贴纸，预览谁会收到什么，并在消息之间留出间隔发送（[`docs/GREETINGS.zh.md`](docs/GREETINGS.zh.md)）。
-- **个人 CRM**：联系人、社区、群组成员、交集、批量个性化触达。
-- **个人记忆**：自动从对话中抽取结构化 `question → answer` 事实。
-- **对话自动化平台**：模式编辑器、回复变体编辑器、类似 n8n 的对话图。
-- **可移植数据存储**：二进制 [Doublets](https://github.com/linksplatform/doublets-rs) + 文本 [Links Notation](https://github.com/link-foundation/links-notation) 双表示，自动备份，`.lino` 导入/导出。
-- **本地优先运行时**：用户自有设备之间 WebRTC 同步，可选自托管个人云。
-- **双技术栈**：JS + Rust/WebAssembly（默认）和纯 Rust 服务器/微服务变体。磁盘格式共享。
-
-完整的需求到状态映射见 [`docs/REQUIREMENTS.zh.md`](docs/REQUIREMENTS.zh.md)；每个 issue 的案例研究在 [`docs/case-studies/`](docs/case-studies/)。
-
-每项 Telegram 客户端功能（已支持、部分、搁置或不支持，以及能否通过 API 或网页应用访问）记录在 [`docs/FEATURES.zh.md`](docs/FEATURES.zh.md)。
+- **统一收件箱**：覆盖 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 的快捷回复、问候与离开消息、营业时间和聊天机器人。
+- **记忆**：从对话中提取结构化的 `问题 → 答案` 事实，并可在聊天中核对。
+- **问候**：像 [konard/vk-bot](https://github.com/konard/vk-bot) 一样，在 VK、Telegram、WhatsApp、Messenger、X 和电子邮件中用一句“你好”或问候贴纸开启对话（[`docs/GREETINGS.zh.md`](docs/GREETINGS.zh.md)）。
+- **简历同步**：通过您自己的浏览器在 LinkedIn、hh.ru、Habr Career、Naukri、VietnamWorks、TopCV 和 SuperJob 之间逐字段同步（[`docs/CV-SYNC.zh.md`](docs/CV-SYNC.zh.md)）。
+- **数据安全**：抗崩溃的本地存储（[Doublets](https://github.com/linksplatform/doublets-rs) + [Links Notation](https://github.com/link-foundation/links-notation)），自动数据结构迁移（[`docs/DATA-MIGRATIONS.zh.md`](docs/DATA-MIGRATIONS.zh.md)），流式加密备份，磁盘写满时的处理，加密的密钥，拒绝其他网站访问的本地服务器。
+- **随处可用**：网页应用、内置服务器的桌面应用、移动外壳、设备间 WebRTC 同步、离线写入稍后补发；纯 Rust 服务器使用相同的磁盘格式。
+- **四种语言**：应用和所有文档都有英文、俄文、印地文和中文版本。
+
+逐个网络的每项功能——已支持、部分支持或不支持，以及是否可通过 API 或网页应用实现：[`docs/FEATURES.zh.md`](docs/FEATURES.zh.md)。每条需求及其证据：[`docs/REQUIREMENTS.zh.md`](docs/REQUIREMENTS.zh.md)。
 
 ## 状态
 
-issue #1 目标原型已实现并在 PR #2 中跟踪：
-
-- **数据层（R-A\*）**：`DualStore` 让 Doublets 二进制和 Links Notation 文本保持同步，支持 AES-256-GCM 静态加密备份和 `secret:*` 链接加密（仅在设置了 `MS_SECRET_PASSPHRASE` 时；存储的其余部分不加密）。
-- **服务连接器（R-E\*）**：VK、Telegram、X、WhatsApp、Facebook、LinkedIn、career.habr.com、hh.ru、superjob.ru 和 email 的归档解析器与可用 live API 连接器。
-- **模式匹配和自动化（R-C\*）**：`inferRegex`、`simplifyRegex`、`compilePeg`、模糊回复变体抽取和 `createGraph` / `runGraph`。
-- **CRM（R-D\*）**：联系人聚合、audience DSL、批量个性化触达、资料和简历同步 envelope。
-- **简历同步（R-V\*）**：七个求职平台的声明式浏览器计划、跨平台差异比较、可选择字段的写入，以及每次运行都带 HTML/截图产物的脱敏遥测流。
-- **分发（R-F\*）**：NPM 库、CLI、本地服务器、Electron shell、Capacitor 移动 shell、Docker web + WebRTC 微服务。
-- **技术栈（R-G\*）**：默认 JS server + React SPA + Rust/WASM 重型任务；纯 Rust 服务器作为替代。
-- **加固（R-K\*）**：默认软删除、AES-256-GCM 主密钥 vault、多种解锁方式、加密导出。
-- **浏览器发布（R-L\*）**：GitHub Pages CI workflow、公开 SPA URL、面向用户的 README 和用户指南。
+需求 R-A 至 R-Z24 均已完成，并在 CI 中于 Linux、macOS 和 Windows 上用 Node、Bun 和 Deno 检查，另有 Chromium 浏览器端到端测试。测试使用模拟服务：测试中不会从真实账号发送任何内容，只有 Telegram 的消息显示另外在真实存储上核对过。各场景的状态与下一步（真实账号验证、OAuth 登录、团队模式、销售管道、活动结果）见 [`docs/ROADMAP.zh.md`](docs/ROADMAP.zh.md)。
 
 ## 仓库结构
 

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,42 @@
+// Local address-book imports, with the same parser and plan as the app.
+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 ?? '.meta-sovereign';
+    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?.();
+    }
+  },
+});