@hraness/peopleblade 0.3.3 → 0.3.5

package/README.md

@@ -15,7 +15,7 @@ Installation includes the pinned runtime dependencies Zod 4.4.3 and Effect 3.22.
 ## Install
 
 ```bash
-bun add --global @hraness/peopleblade@0.3.3
+bun add --global @hraness/peopleblade@0.3.5
 peopleblade --version
 peopleblade init
 peopleblade stats --json
@@ -51,7 +51,7 @@ execution runtime.
 path. When both variables are set, they must name the same executable. The
 bridge still requires exact Ghostget 0.17.3 before invoking a provider operation.
 
-PeopleBlade 0.3.3 contains the reviewed Ghostget-backed Beeper, Google, and WhatsApp
+PeopleBlade 0.3.5 contains the reviewed Ghostget-backed Beeper, Google, and WhatsApp
 live sync commands. Running them requires the separately installed public
 `@hraness/ghostget` 0.17.3 package. Beeper support is bounded to account-aware
 `contacts.list@3` reads, `contacts.search@1`, `messaging.search@2`, and the separate
@@ -59,7 +59,9 @@ body-free interaction exporter. `contacts.search@1` executes the official Beeper
 CLI 0.6.2 executable pinned by Ghostget; `contacts.list@3` and `messaging.search@2`
 use Ghostget's bounded Desktop-loopback read paths. The exporter is macOS arm64 only
 and reports lower-bound interaction counts from complete one-to-one conversations
-only. See
+only. If a history participant is absent from the current contact page, PeopleBlade
+preserves its exact account-scoped coordinate as a relationship-only resource; it
+does not join that resource by name or another fuzzy field. See
 [peopleblade.com/sources](https://peopleblade.com/sources) for the complete provider
 guide. A database previously synced by PeopleBlade 0.1.1 through Wrench 0.16.7
 must run `peopleblade beeper rebind --auth beeper-main --confirm --json` once after

package/dist/peopleblade.js

@@ -3,8 +3,8 @@
 var __require = import.meta.require;
 
 // src/cli/main.ts
-import { closeSync as closeSync9, constants as constants9, existsSync as existsSync5, fstatSync as fstatSync8, openSync as openSync9, readSync as readSync3 } from "fs";
-import { resolve as resolve6 } from "path";
+import { closeSync as closeSync9, constants as constants9, existsSync as existsSync6, fstatSync as fstatSync8, mkdirSync as mkdirSync3, openSync as openSync9, readSync as readSync3 } from "fs";
+import { join as join7, resolve as resolve7 } from "path";
 import { ZodError } from "zod";
 
 // src/local/contacts.ts
@@ -6424,7 +6424,7 @@ function parseGranolaImportJson(raw) {
 var paper_theme_default = `/* @hraness/design-kit paper-theme.css, portable contract 1.
  * Generated by scripts/generate-paper-theme.ts from src/palettes.ts.
  * Opt in with data-hraness-theme="paper". Import after existing theme rules.
- * No imports, asset requests, resets, component recipes, or runtime dependencies.
+ * No imports, asset requests, resets, layout recipes, or runtime dependencies.
  * Appearance uses inherited color-scheme; set data-theme on the boundary for
  * an explicit island. A root without a mode follows the operating system.
  * A non-paper data-palette on the boundary retains its selected colors.
@@ -6487,6 +6487,41 @@ var paper_theme_default = `/* @hraness/design-kit paper-theme.css, portable cont
 [data-hraness-theme="paper"]:where([data-theme="dark"], .dark:not([data-theme="light"])) { color-scheme: dark; }
 [data-hraness-theme="paper"][data-theme="light"] { color-scheme: light; }
 
+/* Opted-in shared headers retain their layout and receive the shared paint
+ * contract, including snapshots used with older component releases. */
+@layer components.hraness-design-kit.legacy {
+/* Keep the browser aliases in separate feature queries: CSS optimizers can
+ * collapse adjacent aliases to the prefixed property and lose Chromium blur. */
+:where([data-hraness-theme="paper"]) .hraness-marketing-header, .hraness-marketing-header:where([data-hraness-theme="paper"]) {
+  --hraness-marketing-header-background: var(--hraness-marketing-background);
+  --hraness-marketing-header-backdrop: none;
+  background: var(--hraness-marketing-header-background);
+}
+
+@supports (-webkit-backdrop-filter: blur(1px)) {
+  :where([data-hraness-theme="paper"]) .hraness-marketing-header, .hraness-marketing-header:where([data-hraness-theme="paper"]) {
+    --hraness-marketing-header-background: color-mix(in oklch, var(--hraness-marketing-background) 82%, transparent);
+    --hraness-marketing-header-backdrop: blur(14px) saturate(1.4);
+    -webkit-backdrop-filter: var(--hraness-marketing-header-backdrop);
+  }
+}
+
+@supports (backdrop-filter: blur(1px)) {
+  :where([data-hraness-theme="paper"]) .hraness-marketing-header, .hraness-marketing-header:where([data-hraness-theme="paper"]) {
+    --hraness-marketing-header-background: color-mix(in oklch, var(--hraness-marketing-background) 82%, transparent);
+    --hraness-marketing-header-backdrop: blur(14px) saturate(1.4);
+    backdrop-filter: var(--hraness-marketing-header-backdrop);
+  }
+}
+
+@media (prefers-reduced-transparency: reduce), (forced-colors: active) {
+  :where([data-hraness-theme="paper"]) .hraness-marketing-header, .hraness-marketing-header:where([data-hraness-theme="paper"]) {
+    --hraness-marketing-header-background: var(--hraness-marketing-background);
+    --hraness-marketing-header-backdrop: none;
+  }
+}
+}
+
 :root[data-hraness-theme="paper"]:where(:not([data-palette]), [data-palette="paper"]),
 [data-hraness-theme="paper"]:where(:not([data-palette]), [data-palette="paper"]) {
   --background: light-dark(#f8f7f4, #12100f);
@@ -6605,6 +6640,7 @@ var paper_theme_default = `/* @hraness/design-kit paper-theme.css, portable cont
     --control-border: ButtonText;
     --primary: Highlight;
     --primary-foreground: HighlightText;
+    --plain-link: LinkText;
     --accent: Highlight;
     --accent-foreground: HighlightText;
     --focus: Highlight;
@@ -6619,19 +6655,228 @@ var paper_theme_default = `/* @hraness/design-kit paper-theme.css, portable cont
 }
 `;
 
+// styles/vendor/hraness-lantern/lantern-material.css
+var lantern_material_default = `/* Lantern is an opt-in material, independent of palette and typography.
+ * All paint is deterministic CSS. No texture is placed over meaningful content. */
+@layer base {
+  [data-hraness-material="lantern"] {
+    --hraness-material-module: 6rem;
+    --hraness-material-warm: #d49a54;
+    --hraness-material-cool: #8d9fc5;
+    --hraness-material-plane: var(--surface, var(--ui-background, Canvas));
+    --hraness-material-ink: var(--foreground, var(--ui-foreground, CanvasText));
+    --hraness-material-muted: var(--muted, var(--ui-muted-foreground, CanvasText));
+    --hraness-material-seam: color-mix(in oklch, var(--hraness-material-ink) 7%, var(--hraness-material-plane));
+    --hraness-material-edge: color-mix(in oklch, white 18%, transparent);
+    --hraness-material-shade: color-mix(in oklch, black 14%, transparent);
+    --hraness-material-warm-plane: color-mix(in oklch, var(--hraness-material-warm) 12%, var(--hraness-material-plane));
+    --hraness-material-inset: inset 2px 3px 6px color-mix(in oklch, black 9%, transparent), inset -1px -1px 2px color-mix(in oklch, white 12%, transparent);
+    --hraness-material-lift: inset 0 1px 0 var(--hraness-material-edge), -3px -3px 10px color-mix(in oklch, white 4%, transparent), 2px 4px 8px color-mix(in oklch, black 7%, transparent), 8px 18px 40px color-mix(in oklch, black 9%, transparent);
+    --hraness-material-focus: var(--focus, var(--ui-ring, Highlight));
+    --hraness-material-duration: 160ms;
+  }
+}
+
+@layer components.hraness-design-kit.legacy {
+  /* A quiet, opaque reading plane. The seam belongs to the surface perimeter. */
+  :where([data-hraness-material="lantern"], [data-hraness-material="lantern"] *):is(.hraness-material-pane) {
+    background-color: var(--hraness-material-plane);
+    border: 1px solid var(--hraness-material-seam);
+    border-radius: var(--radius-lg, 0.75rem);
+    color: var(--hraness-material-ink);
+    min-inline-size: 0;
+  }
+  :where([data-hraness-material="lantern"], [data-hraness-material="lantern"] *):is(.hraness-material-pane[data-depth="raised"]) {
+    box-shadow: var(--hraness-material-lift);
+  }
+  :where([data-hraness-material="lantern"], [data-hraness-material="lantern"] *):is(.hraness-material-pane[data-depth="inset"]) {
+    background-color: color-mix(in oklch, var(--background, Canvas) 70%, var(--hraness-material-plane));
+    box-shadow: var(--hraness-material-inset);
+  }
+
+  /* A translucent enclosure, only where content actually passes behind it.
+   * Resolve these tokens on the chrome itself for nested palette islands. */
+  :where([data-hraness-material="lantern"], [data-hraness-material="lantern"] *):is(.hraness-material-chrome) {
+    --hraness-material-chrome-paint: var(--surface, var(--ui-background, Canvas));
+    --hraness-material-chrome-blur: none;
+    background-color: var(--hraness-material-chrome-paint);
+    border-block-end: 1px solid var(--hraness-material-seam);
+    box-shadow: inset 0 1px 0 var(--hraness-material-edge), 0 4px 12px color-mix(in oklch, black 4%, transparent);
+  }
+  /* Bind the compiled TopBar's public paint seam at its own surface boundary. */
+  :where([data-hraness-material="lantern"], [data-hraness-material="lantern"] *):is(.hraness-material-chrome.hraness-design-top-bar[data-surface="glass"]) {
+    --hraness-design-top-bar-background: var(--hraness-material-chrome-paint);
+    --hraness-design-top-bar-backdrop: var(--hraness-material-chrome-blur);
+  }
+  @supports (-webkit-backdrop-filter: blur(1px)) {
+    :where([data-hraness-material="lantern"], [data-hraness-material="lantern"] *):is(.hraness-material-chrome) {
+      --hraness-material-chrome-paint: color-mix(in oklch, var(--surface, var(--ui-background, Canvas)) 90%, transparent);
+      --hraness-material-chrome-blur: blur(20px) saturate(1.1);
+      -webkit-backdrop-filter: var(--hraness-material-chrome-blur);
+    }
+  }
+  @supports (backdrop-filter: blur(1px)) {
+    :where([data-hraness-material="lantern"], [data-hraness-material="lantern"] *):is(.hraness-material-chrome) {
+      --hraness-material-chrome-paint: color-mix(in oklch, var(--surface, var(--ui-background, Canvas)) 90%, transparent);
+      --hraness-material-chrome-blur: blur(20px) saturate(1.1);
+      backdrop-filter: var(--hraness-material-chrome-blur);
+    }
+  }
+
+  /* Glazing uses shaded faces rather than drawn seams, with a warm band
+   * of transmitted light. Its edges suggest a rounded enclosure without
+   * distorting the document, blurring text, or masking brand artwork. */
+  :where([data-hraness-material="lantern"], [data-hraness-material="lantern"] *):is(.hraness-material-wall) {
+    background-color: var(--background, var(--ui-background, Canvas));
+    background-image:
+      var(--hraness-material-wall-grain, none),
+      var(--hraness-material-wall-cells, linear-gradient(145deg, color-mix(in oklch, white 5%, transparent), transparent 48%, color-mix(in oklch, black 7%, transparent))),
+      radial-gradient(ellipse at 60% 110%, color-mix(in oklch, var(--hraness-material-warm) 22%, transparent), transparent 68%),
+      linear-gradient(110deg, color-mix(in oklch, var(--hraness-material-cool) 14%, transparent), transparent 38%, color-mix(in oklch, white 4%, transparent) 65%, transparent);
+    background-size: 64px 64px, var(--hraness-material-wall-cell-size, var(--hraness-material-module)) var(--hraness-material-wall-cell-size, var(--hraness-material-module)), 100% 100%, 100% 100%;
+    background-position: 0 0, center top, center top, center top;
+    color: var(--hraness-material-ink);
+  }
+
+  /* A terminal remains a readable document. Source lines scroll intact;
+   * only its enclosure catches light. Syntax spans inherit semantic colors. */
+  :where([data-hraness-material="lantern"], [data-hraness-material="lantern"] *):is(.hraness-material-terminal) {
+    min-inline-size: 0;
+    overflow: hidden;
+    border: 1px solid var(--hraness-material-seam);
+    border-radius: .875rem;
+    background: var(--hraness-material-plane);
+    color: var(--hraness-material-ink);
+    box-shadow: var(--hraness-material-lift);
+  }
+  :where([data-hraness-material="lantern"], [data-hraness-material="lantern"] *):is(.hraness-material-terminal__bar) {
+    padding: .8rem 1.25rem;
+    background: linear-gradient(to bottom, color-mix(in oklch, white 5%, var(--hraness-material-plane)), var(--hraness-material-plane));
+    box-shadow: inset 0 1px 0 var(--hraness-material-edge), 0 1px 3px color-mix(in oklch, black 8%, transparent);
+    color: var(--hraness-material-muted);
+    font: .8125rem/1.5 var(--font-mono, ui-monospace, monospace);
+  }
+  :where([data-hraness-material="lantern"], [data-hraness-material="lantern"] *):is(.hraness-material-code) {
+    min-inline-size: 0;
+    max-inline-size: 100%;
+    margin: 0;
+    padding: 1.25rem;
+    overflow: auto;
+    background: var(--hraness-material-plane);
+    color: var(--hraness-material-ink);
+    font: .875rem/1.75 var(--font-mono, ui-monospace, monospace);
+    white-space: pre;
+    overflow-wrap: normal;
+    word-break: normal;
+    tab-size: 2;
+  }
+  :where([data-hraness-material="lantern"], [data-hraness-material="lantern"] *):is(.hraness-material-code) code {
+    background: none;
+    padding: 0;
+    font: inherit;
+    white-space: inherit;
+    overflow-wrap: inherit;
+    word-break: inherit;
+  }
+
+  /* Plain HTML control adapters. Compiled UI primitives use the public
+   * lanternControlStyles recipes through their documented controlXstyle seam.
+   * Edge paint uses background images, leaving focus shadows and outlines alone. */
+  :where([data-hraness-material="lantern"], [data-hraness-material="lantern"] *):is(.hraness-material-control) {
+    background-image: linear-gradient(to bottom, var(--hraness-material-edge), transparent 2px);
+  }
+  :where([data-hraness-material="lantern"], [data-hraness-material="lantern"] *):is(.hraness-material-input) {
+    background-image: linear-gradient(to bottom, var(--hraness-material-shade), transparent 4px);
+    caret-color: var(--hraness-material-focus);
+  }
+  :where([data-hraness-material="lantern"], [data-hraness-material="lantern"] *):is(.hraness-material-choice[aria-pressed="true"], .hraness-material-choice[aria-selected="true"], .hraness-material-choice[data-selected]) {
+    background-color: var(--hraness-material-warm-plane);
+    color: var(--hraness-material-ink);
+    background-image: linear-gradient(to top, var(--hraness-material-warm), var(--hraness-material-warm) 2px, transparent 2px);
+  }
+  :where([data-hraness-material="lantern"], [data-hraness-material="lantern"] *):is(.hraness-material-control:disabled, .hraness-material-control[aria-disabled="true"], .hraness-material-control[data-disabled], .hraness-material-input:disabled) {
+    background-image: none;
+  }
+
+  /* A collection is a readable sequence, never a requirement to fill a grid.
+   * Products own grouping, columns and the meaning of each row. */
+  :where([data-hraness-material="lantern"], [data-hraness-material="lantern"] *):is(.hraness-material-rows) {
+    margin: 0;
+    padding: 0;
+    list-style: none;
+  }
+  :where([data-hraness-material="lantern"], [data-hraness-material="lantern"] *):is(.hraness-material-rows > * + *) {
+    border-block-start: 1px solid var(--hraness-material-seam);
+  }
+  :where([data-hraness-material="lantern"], [data-hraness-material="lantern"] *):is(.hraness-material-disclosure > summary) {
+    cursor: pointer;
+    min-block-size: 2.75rem;
+    padding-block: 0.75rem;
+  }
+  :where([data-hraness-material="lantern"], [data-hraness-material="lantern"] *):is(.hraness-material-disclosure > summary:focus-visible) {
+    outline: 2px solid var(--hraness-material-focus);
+    outline-offset: 3px;
+  }
+  [data-hraness-material="lantern"] ::selection {
+    background-color: var(--hraness-material-warm-plane);
+    color: var(--hraness-material-ink);
+  }
+
+  @media (prefers-reduced-motion: reduce) {
+    [data-hraness-material="lantern"] { --hraness-material-duration: 0ms; }
+  }
+  @media (prefers-reduced-transparency: reduce) {
+    :where([data-hraness-material="lantern"], [data-hraness-material="lantern"] *):is(.hraness-material-chrome) {
+      --hraness-material-chrome-paint: var(--surface, var(--ui-background, Canvas));
+      --hraness-material-chrome-blur: none;
+    }
+    :where([data-hraness-material="lantern"], [data-hraness-material="lantern"] *):is(.hraness-material-wall) { background-image: none; }
+  }
+  @media (forced-colors: active) {
+    [data-hraness-material="lantern"] {
+      --hraness-material-plane: Canvas;
+      --hraness-material-ink: CanvasText;
+      --hraness-material-muted: CanvasText;
+      --hraness-material-seam: CanvasText;
+      --hraness-material-focus: Highlight;
+      --hraness-material-warm-plane: Canvas;
+      --hraness-material-warm: Highlight;
+      --hraness-material-edge: transparent;
+      --hraness-material-inset: none;
+      --hraness-material-lift: none;
+    }
+    :where([data-hraness-material="lantern"], [data-hraness-material="lantern"] *):is(.hraness-material-wall, .hraness-material-chrome, .hraness-material-pane, .hraness-material-terminal, .hraness-material-terminal__bar, .hraness-material-code) {
+      --hraness-material-chrome-paint: Canvas;
+      --hraness-material-chrome-blur: none;
+      background-color: Canvas;
+      background-image: none;
+      box-shadow: none;
+    }
+    :where([data-hraness-material="lantern"], [data-hraness-material="lantern"] *):is(.hraness-material-control, .hraness-material-input, .hraness-material-choice) { background-image: none; }
+    :where([data-hraness-material="lantern"], [data-hraness-material="lantern"] *):is(.hraness-material-choice[aria-pressed="true"], .hraness-material-choice[aria-selected="true"], .hraness-material-choice[data-selected]) {
+      background-color: Highlight;
+      color: HighlightText;
+      background-image: none;
+    }
+  }
+}
+`;
+
 // src/local/workspace-assets.ts
 var workspaceHtml = `<!doctype html>
-<html lang="en" data-hraness-theme="paper"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
+<html lang="en" data-hraness-theme="paper" data-hraness-material="lantern"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
 <title>PeopleBlade \xB7 Local workspace</title><link rel="stylesheet" href="/workspace.css"><script src="/workspace.js" defer></script></head>
-<body><a class="skip" href="#workspace">Skip to contacts</a><header><a class="brand" href="/">PeopleBlade<span>LOCAL WORKSPACE</span></a><p>Your people. Your machine.</p><span class="privacy">No cloud sync \xB7 no enrichment calls</span></header>
-<main id="workspace"><section id="unlock" class="unlock"><span class="eyebrow">PRIVATE BY DEFAULT</span><h1>Open your local contact book.</h1><p>Select the access file printed by <code>peopleblade ui</code>. It connects this tab to that running process only. The file is not uploaded to a remote service.</p><label class="file-label">Workspace access file<input id="access-file" type="file" accept="application/json,.json"></label><p class="muted">Keep the terminal running. Closing it locks the workspace. Notes never leave this machine.</p></section>
+<body><a class="skip" href="#workspace">Skip to contacts</a><header class="workspace-header hraness-material-chrome"><a class="brand" href="/">PeopleBlade<span>LOCAL WORKSPACE</span></a><p>Your people. Your machine.</p><span class="privacy">No cloud sync \xB7 no enrichment calls</span></header>
+<main id="workspace"><section id="unlock" class="unlock hraness-material-pane"><span class="eyebrow">PRIVATE BY DEFAULT</span><h1>Open your local contact book.</h1><p>Select the access file printed by <code>peopleblade ui</code>. It connects this tab to that running process only. The file is not uploaded to a remote service.</p><label class="file-label">Workspace access file<input id="access-file" type="file" accept="application/json,.json"></label><p class="muted">Keep the terminal running. Closing it locks the workspace. Notes never leave this machine.</p></section>
 <section id="book" hidden><div class="page-heading"><div><span class="eyebrow">YOUR RELATIONSHIPS</span><h1>Contact book</h1></div><button id="lock" type="button">Lock workspace</button></div>
 <form id="filters" class="filters"><label class="search">Search contacts<input id="search" name="search" type="search" placeholder="Name, company, title, email, phone\u2026" maxlength="200"></label><label>Source<select id="source"><option value="">All sources</option><option>apple</option><option>beeper</option><option>google</option><option>imessage</option><option>linkedin</option><option>instagram</option><option>whatsapp</option><option>x</option></select></label><label>Email<select id="email"><option value="">Any email</option><option value="yes">Has email</option><option value="no">Needs email</option></select></label><label>Contact preference<select id="dnc"><option value="all">All contacts</option><option value="exclude">May contact</option><option value="only">Do not contact</option></select></label><button type="submit">Search</button><button id="reset" type="button">Reset</button></form>
-<div class="workspace-grid"><section class="records" aria-label="Contacts"><div class="table-toolbar"><span id="range" aria-live="polite"></span><div><label>Sort <select id="sort"><option value="interactions">Interactions</option><option value="name">Name</option><option value="organization">Company</option><option value="last-contact">Last interaction</option></select></label><button id="direction" type="button" aria-label="Toggle sort direction">Descending \u2193</button></div></div><div class="table-scroll" tabindex="0" aria-label="Scrollable contacts"><table><caption class="sr-only">Local contacts; open a person to inspect details and notes.</caption><thead><tr><th scope="col">Person</th><th scope="col">Company</th><th scope="col">Interactions</th></tr></thead><tbody id="rows"></tbody></table></div><div id="empty" class="empty" hidden>No matches. Try another search or import a source with the CLI.</div><nav class="pagination" aria-label="Contact pages"><button id="previous" type="button">\u2190 Previous</button><span id="page"></span><button id="next" type="button">Next \u2192</button></nav><p class="live-note">Live view: imports and identity reviews can move rows between pages. Refresh after changes.</p></section>
-<aside id="detail" class="detail" aria-label="Contact details"><div class="empty"><h2>A little context goes a long way.</h2><p>Open a person to see their contact methods, sources and private notes.</p></div></aside></div></section>
+<div class="workspace-grid"><section class="records hraness-material-pane" aria-label="Contacts"><div class="table-toolbar"><span id="range" aria-live="polite"></span><div><label>Sort <select id="sort"><option value="interactions">Interactions</option><option value="name">Name</option><option value="organization">Company</option><option value="last-contact">Last interaction</option></select></label><button id="direction" type="button" aria-label="Toggle sort direction">Descending \u2193</button></div></div><div class="table-scroll" tabindex="0" aria-label="Scrollable contacts"><table><caption class="sr-only">Local contacts; open a person to inspect details and notes.</caption><thead><tr><th scope="col">Person</th><th scope="col">Company</th><th scope="col">Interactions</th></tr></thead><tbody id="rows"></tbody></table></div><div id="empty" class="empty" hidden>No matches. Try another search or import a source with the CLI.</div><nav class="pagination" aria-label="Contact pages"><button id="previous" type="button">\u2190 Previous</button><span id="page"></span><button id="next" type="button">Next \u2192</button></nav><p class="live-note">Live view: imports and identity reviews can move rows between pages. Refresh after changes.</p></section>
+<aside id="detail" class="detail hraness-material-pane" aria-label="Contact details"><div class="empty"><h2>A little context goes a long way.</h2><p>Open a person to see their contact methods, sources and private notes.</p></div></aside></div></section>
 <p id="status" role="status" aria-live="polite"></p></main><footer>PeopleBlade \xB7 Local authority, reviewable identity, private notes.</footer></body></html>`;
 var workspaceCss = paper_theme_default + `
-:root{--bg:var(--background);--panel:var(--surface);--text:var(--foreground);--soft:var(--secondary)}*{box-sizing:border-box}body{margin:0;background:var(--bg);color:var(--text);font:14px/1.55 var(--font-text)}button,input,select,textarea{font:inherit;color:inherit}button,input,select,textarea{border:1px solid var(--line);border-radius:7px;background:var(--panel);padding:9px 12px}button{cursor:pointer;font-weight:550}button:hover{border-color:var(--primary);background:var(--soft)}button:disabled{opacity:.45;cursor:default}a{color:var(--primary)}:focus-visible{outline:3px solid var(--primary);outline-offset:3px}header{display:flex;align-items:center;gap:30px;padding:22px 32px;border-bottom:1px solid var(--line);background:var(--panel)}header p{color:var(--muted);margin:0}.brand{color:var(--text);font-size:22px;line-height:1.1;text-decoration:none;font-weight:650;letter-spacing:-.7px}.brand span{display:block;font-size:9px;letter-spacing:1.8px;color:var(--muted);margin-top:8px}.privacy{margin-left:auto;border:1px solid var(--line);border-radius:99px;padding:6px 12px;font-size:11px;color:var(--muted)}main{max-width:1600px;margin:auto;padding:36px 32px}h1{font-size:34px;line-height:1.2;letter-spacing:-1px;font-weight:550;margin:8px 0 24px}h2{font-size:21px;line-height:1.3;letter-spacing:-.5px;margin:0 0 12px}.eyebrow{font-size:10px;letter-spacing:2px;color:var(--muted);font-weight:650}.unlock{max-width:600px;margin:7vh auto;padding:36px;background:var(--panel);border:1px solid var(--line);border-radius:12px}.unlock p{color:var(--muted)}.file-label{display:grid;gap:8px;margin:25px 0}.page-heading{display:flex;align-items:center;justify-content:space-between}.page-heading button{margin-bottom:20px}.filters{display:flex;gap:10px;align-items:end;margin-bottom:20px;flex-wrap:wrap}.filters label{display:grid;gap:5px;font-size:11px;color:var(--muted)}.filters input,.filters select{font-size:13px;color:var(--text);min-height:42px}.filters .search{flex:1;min-width:220px}.workspace-grid{display:grid;grid-template-columns:minmax(420px,1.4fr) minmax(320px,1fr);gap:20px;align-items:start}.records,.detail{border:1px solid var(--line);background:var(--panel);border-radius:10px;overflow:hidden}.table-toolbar{display:flex;justify-content:space-between;align-items:center;gap:12px;padding:13px 16px;border-bottom:1px solid var(--line);color:var(--muted);font-size:12px;flex-wrap:wrap}.table-toolbar>div{display:flex;align-items:center;gap:6px}.table-toolbar select,.table-toolbar button{padding:5px 8px;font-size:12px}.table-scroll{overflow:auto;max-height:65vh}table{width:100%;border-collapse:collapse;text-align:left}th{position:sticky;top:0;background:var(--soft);font-size:10px;text-transform:uppercase;letter-spacing:1px;color:var(--muted);z-index:1}th,td{padding:11px 16px;border-bottom:1px solid var(--line);vertical-align:top}td{font-size:12px}td small{display:block;color:var(--muted);margin-top:2px}td button{padding:0;border:0;background:none;text-align:left;font-size:13px;color:var(--text)}tr.selected{background:var(--soft)}tr:hover{background:var(--soft)}.pagination{display:flex;justify-content:space-between;align-items:center;padding:14px 16px;font-size:12px}.pagination button{font-size:12px;padding:6px 10px}.live-note{font-size:10px;color:var(--muted);padding:0 16px 12px;margin:0}.detail{padding:24px;position:sticky;top:20px;max-height:83vh;overflow:auto}.detail h2{font-size:25px}.detail dl{display:grid;grid-template-columns:90px 1fr;gap:8px;margin:22px 0}.detail dt{font-size:11px;color:var(--muted)}.detail dd{margin:0;font-size:12px;overflow-wrap:anywhere}.detail dd span{display:block}.pill{display:inline-block;border:1px solid var(--line);border-radius:99px;padding:2px 8px;margin:0 4px 5px 0;color:var(--muted);font-size:10px}.notes-heading{border-top:1px solid var(--line);padding-top:22px;margin-top:24px;display:flex;justify-content:space-between;align-items:center}.notes-heading h3{margin:0;font-weight:550}.note-card{border-bottom:1px solid var(--line);padding:16px 0}.note-card>button{font-size:12px;padding:5px 9px;margin:8px 6px 0 0}.note-meta{font-size:10px;color:var(--muted);margin:4px 0 10px}.note-title{font-size:14px;font-weight:600;margin:0}.markdown{font-size:13px;overflow-wrap:anywhere}.markdown h1,.markdown h2,.markdown h3{font-size:17px;margin:12px 0}.markdown pre{overflow:auto;background:var(--soft);padding:12px;border-radius:6px}.markdown img{display:none}.markdown blockquote{margin-left:0;padding-left:12px;border-left:3px solid var(--line);color:var(--muted)}.markdown p{margin:8px 0}.markdown td,.markdown th{padding:5px;position:static}.editor{display:grid;gap:10px}.editor label{display:grid;gap:4px;font-size:11px;color:var(--muted)}.editor textarea{min-height:230px;resize:vertical;font-family:ui-monospace,SFMono-Regular,monospace;font-size:12px;tab-size:2}.editor-actions{display:flex;gap:6px;flex-wrap:wrap}.editor-actions button{font-size:12px}.primary{background:var(--primary);color:var(--primary-foreground)}.primary:hover{background:var(--primary);color:var(--primary-foreground)}.empty{padding:44px 22px;color:var(--muted);text-align:center}.empty h2{font-size:21px}.muted{color:var(--muted);font-size:12px}.danger{color:var(--danger)}#status{background:var(--panel);border:1px solid var(--line);padding:12px 16px;border-radius:8px}#status:empty{display:none}footer{color:var(--muted);font-size:11px;text-align:center;padding:20px}.skip{position:absolute;left:12px;top:-100px;padding:8px;background:var(--panel);z-index:5}.skip:focus{top:8px}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border:0}[hidden]{display:none!important}
+` + lantern_material_default + `
+:root{--bg:var(--background);--panel:var(--surface);--text:var(--foreground);--soft:var(--secondary)}*{box-sizing:border-box}body{margin:0;background:var(--bg);color:var(--text);font:14px/1.55 var(--font-text)}button,input,select,textarea{font:inherit;color:inherit}button,input,select,textarea{border:1px solid var(--line);border-radius:7px;background:var(--panel);padding:9px 12px}button{cursor:pointer;font-weight:550}button:hover{border-color:var(--primary);background:var(--soft)}button:disabled{opacity:.45;cursor:default}a{color:var(--primary)}:focus-visible{outline:3px solid var(--primary);outline-offset:3px}header{display:flex;align-items:center;gap:30px;padding:22px 32px;border-bottom:1px solid var(--hraness-material-seam);background-color:var(--hraness-material-chrome-paint)}header p{color:var(--muted);margin:0}.brand{color:var(--text);font-size:22px;line-height:1.1;text-decoration:none;font-weight:650;letter-spacing:-.7px}.brand span{display:block;font-size:9px;letter-spacing:1.8px;color:var(--muted);margin-top:8px}.privacy{margin-left:auto;border:1px solid var(--line);border-radius:99px;padding:6px 12px;font-size:11px;color:var(--muted)}main{max-width:1600px;margin:auto;padding:36px 32px}h1{font-size:34px;line-height:1.2;letter-spacing:-1px;font-weight:550;margin:8px 0 24px}h2{font-size:21px;line-height:1.3;letter-spacing:-.5px;margin:0 0 12px}.eyebrow{font-size:10px;letter-spacing:2px;color:var(--muted);font-weight:650}.unlock{max-width:600px;margin:7vh auto;padding:36px;background:var(--hraness-material-plane);border:1px solid var(--hraness-material-seam);border-radius:12px;color:var(--hraness-material-ink)}.unlock p{color:var(--muted)}.file-label{display:grid;gap:8px;margin:25px 0}.page-heading{display:flex;align-items:center;justify-content:space-between}.page-heading button{margin-bottom:20px}.filters{display:flex;gap:10px;align-items:end;margin-bottom:20px;flex-wrap:wrap}.filters label{display:grid;gap:5px;font-size:11px;color:var(--muted)}.filters input,.filters select{font-size:13px;color:var(--text);min-height:42px}.filters .search{flex:1;min-width:220px}.workspace-grid{display:grid;grid-template-columns:minmax(420px,1.4fr) minmax(320px,1fr);gap:20px;align-items:start}.records,.detail{border:1px solid var(--hraness-material-seam);background:var(--hraness-material-plane);border-radius:10px;color:var(--hraness-material-ink);overflow:hidden}.table-toolbar{display:flex;justify-content:space-between;align-items:center;gap:12px;padding:13px 16px;border-bottom:1px solid var(--line);color:var(--muted);font-size:12px;flex-wrap:wrap}.table-toolbar>div{display:flex;align-items:center;gap:6px}.table-toolbar select,.table-toolbar button{padding:5px 8px;font-size:12px}.table-scroll{overflow:auto;max-height:65vh}table{width:100%;border-collapse:collapse;text-align:left}th{position:sticky;top:0;background:var(--soft);font-size:10px;text-transform:uppercase;letter-spacing:1px;color:var(--muted);z-index:1}th,td{padding:11px 16px;border-bottom:1px solid var(--line);vertical-align:top}td{font-size:12px}td small{display:block;color:var(--muted);margin-top:2px}td button{padding:0;border:0;background:none;text-align:left;font-size:13px;color:var(--text)}tr:hover{background:var(--soft)}tr.selected,tr.selected:hover{background:var(--hraness-material-warm-plane);color:var(--hraness-material-ink)}tr.selected td small,tr.selected td button{color:var(--hraness-material-ink)}.pagination{display:flex;justify-content:space-between;align-items:center;padding:14px 16px;font-size:12px}.pagination button{font-size:12px;padding:6px 10px}.live-note{font-size:10px;color:var(--muted);padding:0 16px 12px;margin:0}.detail{padding:24px;position:sticky;top:20px;max-height:83vh;overflow:auto}.detail h2{font-size:25px}.detail dl{display:grid;grid-template-columns:90px 1fr;gap:8px;margin:22px 0}.detail dt{font-size:11px;color:var(--muted)}.detail dd{margin:0;font-size:12px;overflow-wrap:anywhere}.detail dd span{display:block}.pill{display:inline-block;border:1px solid var(--line);border-radius:99px;padding:2px 8px;margin:0 4px 5px 0;color:var(--muted);font-size:10px}.notes-heading{border-top:1px solid var(--line);padding-top:22px;margin-top:24px;display:flex;justify-content:space-between;align-items:center}.notes-heading h3{margin:0;font-weight:550}.note-card{border-bottom:1px solid var(--line);padding:16px 0}.note-card>button{font-size:12px;padding:5px 9px;margin:8px 6px 0 0}.note-meta{font-size:10px;color:var(--muted);margin:4px 0 10px}.note-title{font-size:14px;font-weight:600;margin:0}.markdown{font-size:13px;overflow-wrap:anywhere}.markdown h1,.markdown h2,.markdown h3{font-size:17px;margin:12px 0}.markdown pre{overflow:auto;background:var(--soft);padding:12px;border-radius:6px}.markdown img{display:none}.markdown blockquote{margin-left:0;padding-left:12px;border-left:3px solid var(--line);color:var(--muted)}.markdown p{margin:8px 0}.markdown td,.markdown th{padding:5px;position:static}.editor{display:grid;gap:10px}.editor label{display:grid;gap:4px;font-size:11px;color:var(--muted)}.editor textarea{min-height:230px;resize:vertical;font-family:ui-monospace,SFMono-Regular,monospace;font-size:12px;tab-size:2}.editor-actions{display:flex;gap:6px;flex-wrap:wrap}.editor-actions button{font-size:12px}.primary{background:var(--primary);color:var(--primary-foreground)}.primary:hover{background:var(--primary);color:var(--primary-foreground)}.empty{padding:44px 22px;color:var(--muted);text-align:center}.empty h2{font-size:21px}.muted{color:var(--muted);font-size:12px}.danger{color:var(--danger)}#status{background:var(--panel);border:1px solid var(--line);padding:12px 16px;border-radius:8px}#status:empty{display:none}footer{color:var(--muted);font-size:11px;text-align:center;padding:20px}.skip{position:absolute;left:12px;top:-100px;padding:8px;background:var(--panel);z-index:5}.skip:focus{top:8px}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border:0}[hidden]{display:none!important}
+@media(forced-colors:active){tr.selected,tr.selected:hover{background:Highlight;color:HighlightText}tr.selected td small,tr.selected td button{color:HighlightText}}
 @media(max-width:1000px){.workspace-grid{grid-template-columns:1fr}.detail{position:static;max-height:none}.privacy{display:none}}@media(max-width:600px){header{padding:18px;gap:18px}header p{font-size:11px}main{padding:26px 14px}.unlock{padding:22px;margin:25px 0}h1{font-size:28px}.filters{gap:8px}.filters label{flex:1;min-width:125px}.filters .search{flex-basis:100%}th,td{padding:10px}.detail{padding:18px}.table-toolbar{padding:10px}.page-heading{align-items:start}.page-heading button{font-size:11px}.table-scroll{max-height:50vh}}
 `;
 function workspaceClient() {
@@ -6701,6 +6946,7 @@ function workspaceClient() {
       el("rows").replaceChildren();
       for (const person of result.items) {
         const row = node("tr", "", selectedPerson === person.id ? "selected" : "");
+        row.dataset.personId = String(person.id);
         const name = node("td");
         const open = node("button", person.displayName);
         open.type = "button";
@@ -6945,6 +7191,9 @@ function workspaceClient() {
       }
       activeEditor = null;
       selectedPerson = id;
+      for (const row of el("rows").querySelectorAll("tr[data-person-id]")) {
+        row.classList.toggle("selected", row.dataset.personId === String(id));
+      }
       target.replaceChildren();
       target.append(node("span", `PERSON ${id} \xB7 ${result.memberCount} SOURCE RECORD${result.memberCount === 1 ? "" : "S"}`, "eyebrow"), node("h2", result.contact.displayName));
       const pills = node("div");
@@ -11484,6 +11733,57 @@ function addConfirmedPerson(database, args) {
   }
 }
 
+// src/local/menubar.ts
+import { existsSync as existsSync3 } from "fs";
+import { dirname as dirname4, resolve as resolve3 } from "path";
+var SETTLE_MS = 400;
+function resolveMenubarBinary(environment = process.env) {
+  const candidates = [
+    environment.PEOPLEBLADE_DESKTOP,
+    resolve3(dirname4(process.execPath), "peopleblade-menubar"),
+    resolve3(import.meta.dir, "../../desktop/target/release/peopleblade-menubar"),
+    resolve3(import.meta.dir, "../../desktop/target/debug/peopleblade-menubar")
+  ];
+  for (const candidate of candidates) {
+    if (candidate !== undefined && candidate !== "" && existsSync3(candidate))
+      return candidate;
+  }
+  return null;
+}
+async function launchMenubar(asJson) {
+  const binary = resolveMenubarBinary();
+  if (binary === null) {
+    const message = "The PeopleBlade menu bar is not installed. Build it with `cargo build --release --manifest-path desktop/Cargo.toml` or set PEOPLEBLADE_DESKTOP.";
+    if (asJson)
+      console.log(JSON.stringify({ error: message }));
+    else
+      console.error(message);
+    return 1;
+  }
+  let child;
+  try {
+    child = Bun.spawn([binary], { stdin: "ignore", stdout: "ignore", stderr: "pipe" });
+  } catch {
+    console.error("The PeopleBlade menu bar could not start.");
+    return 1;
+  }
+  child.unref();
+  const settled = await Promise.race([
+    child.exited.then((code) => code),
+    Bun.sleep(SETTLE_MS).then(() => null)
+  ]);
+  if (settled !== null && settled !== 0) {
+    console.error("The PeopleBlade menu bar exited during startup.");
+    return 1;
+  }
+  const alreadyRunning = settled === 0;
+  if (asJson)
+    console.log(JSON.stringify({ running: true, alreadyRunning }));
+  else
+    console.log(alreadyRunning ? "PeopleBlade menu bar is already running." : "PeopleBlade menu bar is running.");
+  return 0;
+}
+
 // src/local/providers/apple.ts
 import { Database as Database3 } from "bun:sqlite";
 import { createHash as createHash3 } from "crypto";
@@ -11493,7 +11793,7 @@ import {
   realpathSync as realpathSync4
 } from "fs";
 import { homedir as homedir2 } from "os";
-import { join as join5, resolve as resolve3 } from "path";
+import { join as join5, resolve as resolve4 } from "path";
 var EMAIL_PATTERN2 = /^(?=[\x21-\x7E]+$)[^@\s]+@[^@\s]+\.[^@\s]+$/u;
 function clean(value) {
   if (typeof value !== "string")
@@ -11696,7 +11996,7 @@ function rowsByOwner(database, table, names) {
   return grouped;
 }
 function sourceDatabasePaths(directory) {
-  const base = realpathSync4(resolve3(directory));
+  const base = realpathSync4(resolve4(directory));
   const sourceDirectory = join5(base, "Sources");
   const sourceIdentity = lstatSync5(sourceDirectory);
   if (!sourceIdentity.isDirectory() || sourceIdentity.isSymbolicLink()) {
@@ -12114,7 +12414,8 @@ var methodSchema = z10.object({
 var contactSchema = z10.object({
   person: personSchema,
   resource: resourceSchema,
-  methods: z10.array(methodSchema).max(1000)
+  methods: z10.array(methodSchema).max(1000),
+  existingIdentityPolicy: z10.literal("preserve").optional()
 }).strict().superRefine((contact, context) => {
   const coordinates = new Set;
   contact.methods.forEach((method, index) => {
@@ -12384,6 +12685,7 @@ function materializeContactSourceSnapshot(database, snapshot, sourceRealmId, sou
     ordinal += 1;
     const prior = getRow3(database, `SELECT id,person_id,source_realm_id FROM provider_resources
       WHERE provider=? AND account_key=? AND resource_type=? AND resource_id=?`, snapshot.provider, snapshot.accountKey, contact.resource.type, contact.resource.id);
+    const preserveIdentity = prior !== null && contact.existingIdentityPolicy === "preserve";
     let personId;
     let providerResourceId;
     if (prior === null) {
@@ -12403,47 +12705,54 @@ function materializeContactSourceSnapshot(database, snapshot, sourceRealmId, sou
       }
       personId = prior.person_id;
       providerResourceId = prior.id;
-      const person = contact.person;
-      run2(database, `UPDATE people SET display_name=?,given_name=?,middle_name=?,family_name=?,name_prefix=?,
-        name_suffix=?,nickname=?,organization=?,department=?,title=?,birthday=?,metadata_json=? WHERE id=?`, person.displayName, person.givenName, person.middleName, person.familyName, person.namePrefix, person.nameSuffix, person.nickname, person.organization, person.department, person.title, person.birthday, canonicalJson(person.metadata), personId);
-      run2(database, `UPDATE provider_resources SET username=?,profile_url=?,profile_url_identity_eligible=?,name_identity_eligible=?,display_name=?,active=1,
-        last_seen_run_id=?,metadata_json=?,source_realm_id=coalesce(source_realm_id,?) WHERE id=?`, contact.resource.username, contact.resource.profileUrl, contact.resource.profileUrlIdentityEligible ? 1 : 0, contact.resource.nameIdentityEligible ? 1 : 0, contact.resource.displayName, sourceRunId, canonicalJson(contact.resource.metadata), sourceRealmId, providerResourceId);
-    }
-    run2(database, "UPDATE contact_methods SET active=0 WHERE provider_resource_id=?", providerResourceId);
-    for (const method of contact.methods) {
-      run2(database, `INSERT INTO contact_methods(
-        person_id,kind,value,normalized_value,label,is_primary,confidence,first_seen_run_id,last_seen_run_id,
-        metadata_json,provider_resource_id,active,identity_eligible
-      ) VALUES (?,?,?,?,?,?,?,?,?,?,?,1,?)
-      ON CONFLICT(person_id,kind,normalized_value,label) DO UPDATE SET
-        value=excluded.value,is_primary=excluded.is_primary,confidence=excluded.confidence,
-        last_seen_run_id=excluded.last_seen_run_id,metadata_json=excluded.metadata_json,
-        provider_resource_id=excluded.provider_resource_id,active=1,
-        identity_eligible=excluded.identity_eligible`, personId, method.kind, method.value, method.normalizedValue, method.label, method.primary ? 1 : 0, method.confidence, sourceRunId, sourceRunId, canonicalJson(method.metadata), providerResourceId, method.identityEligible ? 1 : 0);
-    }
-    run2(database, "UPDATE person_field_observations SET active=0 WHERE provider_resource_id=?", providerResourceId);
-    const observedFields = [
-      ["display_name", contact.person.displayName],
-      ["given_name", contact.person.givenName],
-      ["middle_name", contact.person.middleName],
-      ["family_name", contact.person.familyName],
-      ["name_prefix", contact.person.namePrefix],
-      ["name_suffix", contact.person.nameSuffix],
-      ["nickname", contact.person.nickname],
-      ["organization", contact.person.organization],
-      ["department", contact.person.department],
-      ["title", contact.person.title],
-      ["birthday", contact.person.birthday]
-    ];
-    for (const [field, fieldValue] of observedFields) {
-      if (fieldValue === null)
-        continue;
-      run2(database, `INSERT INTO person_field_observations(
-        provider_resource_id,field,value,basis,priority,active,first_seen_run_id,last_seen_run_id,metadata_json
-      ) VALUES (?,?,?,?,?,1,?,?,?)
-      ON CONFLICT(provider_resource_id,field,value,basis) DO UPDATE SET
-        priority=excluded.priority,active=1,last_seen_run_id=excluded.last_seen_run_id,
-        metadata_json=excluded.metadata_json`, providerResourceId, field, fieldValue, contact.person.observationBasis, contact.person.observationPriority, sourceRunId, sourceRunId, canonicalJson(contact.person.metadata));
+      if (preserveIdentity) {
+        run2(database, `UPDATE provider_resources SET active=1,last_seen_run_id=?,
+          source_realm_id=coalesce(source_realm_id,?) WHERE id=?`, sourceRunId, sourceRealmId, providerResourceId);
+      } else {
+        const person = contact.person;
+        run2(database, `UPDATE people SET display_name=?,given_name=?,middle_name=?,family_name=?,name_prefix=?,
+          name_suffix=?,nickname=?,organization=?,department=?,title=?,birthday=?,metadata_json=? WHERE id=?`, person.displayName, person.givenName, person.middleName, person.familyName, person.namePrefix, person.nameSuffix, person.nickname, person.organization, person.department, person.title, person.birthday, canonicalJson(person.metadata), personId);
+        run2(database, `UPDATE provider_resources SET username=?,profile_url=?,profile_url_identity_eligible=?,name_identity_eligible=?,display_name=?,active=1,
+          last_seen_run_id=?,metadata_json=?,source_realm_id=coalesce(source_realm_id,?) WHERE id=?`, contact.resource.username, contact.resource.profileUrl, contact.resource.profileUrlIdentityEligible ? 1 : 0, contact.resource.nameIdentityEligible ? 1 : 0, contact.resource.displayName, sourceRunId, canonicalJson(contact.resource.metadata), sourceRealmId, providerResourceId);
+      }
+    }
+    if (!preserveIdentity) {
+      run2(database, "UPDATE contact_methods SET active=0 WHERE provider_resource_id=?", providerResourceId);
+      for (const method of contact.methods) {
+        run2(database, `INSERT INTO contact_methods(
+          person_id,kind,value,normalized_value,label,is_primary,confidence,first_seen_run_id,last_seen_run_id,
+          metadata_json,provider_resource_id,active,identity_eligible
+        ) VALUES (?,?,?,?,?,?,?,?,?,?,?,1,?)
+        ON CONFLICT(person_id,kind,normalized_value,label) DO UPDATE SET
+          value=excluded.value,is_primary=excluded.is_primary,confidence=excluded.confidence,
+          last_seen_run_id=excluded.last_seen_run_id,metadata_json=excluded.metadata_json,
+          provider_resource_id=excluded.provider_resource_id,active=1,
+          identity_eligible=excluded.identity_eligible`, personId, method.kind, method.value, method.normalizedValue, method.label, method.primary ? 1 : 0, method.confidence, sourceRunId, sourceRunId, canonicalJson(method.metadata), providerResourceId, method.identityEligible ? 1 : 0);
+      }
+      run2(database, "UPDATE person_field_observations SET active=0 WHERE provider_resource_id=?", providerResourceId);
+      const observedFields = [
+        ["display_name", contact.person.displayName],
+        ["given_name", contact.person.givenName],
+        ["middle_name", contact.person.middleName],
+        ["family_name", contact.person.familyName],
+        ["name_prefix", contact.person.namePrefix],
+        ["name_suffix", contact.person.nameSuffix],
+        ["nickname", contact.person.nickname],
+        ["organization", contact.person.organization],
+        ["department", contact.person.department],
+        ["title", contact.person.title],
+        ["birthday", contact.person.birthday]
+      ];
+      for (const [field, fieldValue] of observedFields) {
+        if (fieldValue === null)
+          continue;
+        run2(database, `INSERT INTO person_field_observations(
+          provider_resource_id,field,value,basis,priority,active,first_seen_run_id,last_seen_run_id,metadata_json
+        ) VALUES (?,?,?,?,?,1,?,?,?)
+        ON CONFLICT(provider_resource_id,field,value,basis) DO UPDATE SET
+          priority=excluded.priority,active=1,last_seen_run_id=excluded.last_seen_run_id,
+          metadata_json=excluded.metadata_json`, providerResourceId, field, fieldValue, contact.person.observationBasis, contact.person.observationPriority, sourceRunId, sourceRunId, canonicalJson(contact.person.metadata));
+      }
     }
     if (writeSourceRecords) {
       run2(database, `INSERT INTO source_records(
@@ -12519,7 +12828,7 @@ function importContactSourceSnapshot(database, value) {
       source_rows: snapshot.contacts.length,
       people_created: peopleCreated,
       people_matched: peopleMatched,
-      methods_touched: snapshot.contacts.reduce((sum, contact) => sum + contact.methods.length, 0),
+      methods_touched: snapshot.contacts.reduce((sum, contact) => sum + (contact.existingIdentityPolicy === "preserve" && existingCoordinates.has(`${contact.resource.type}\x00${contact.resource.id}`) ? 0 : contact.methods.length), 0),
       interactions_touched: snapshot.interactions.length,
       resources_removed: resourcesRemoved,
       reconciled: reconcile,
@@ -12589,7 +12898,7 @@ function sha2563(value) {
 
 // node_modules/@hraness/ghostget/dist/client.js
 import { spawn, spawnSync } from "child_process";
-import { existsSync as existsSync3 } from "fs";
+import { existsSync as existsSync4 } from "fs";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import { types as nodeTypes } from "util";
 var PORTABLE_OPERATION_IDENTITY_VERSION = 1;
@@ -12887,10 +13196,10 @@ function boundedMessage(value) {
 }
 function cliSourcePath() {
   const besideSource = fileURLToPath2(new URL("./cli.ts", import.meta.url));
-  if (existsSync3(besideSource))
+  if (existsSync4(besideSource))
     return besideSource;
   const packagedSource = fileURLToPath2(new URL("../src/cli.ts", import.meta.url));
-  if (existsSync3(packagedSource))
+  if (existsSync4(packagedSource))
     return packagedSource;
   throw new Error("the installed Ghostget CLI source is unavailable");
 }
@@ -13901,7 +14210,7 @@ var GHOSTGET_VERSION = "0.17.3";
 
 // node_modules/@hraness/ghostget/dist/beeper-client.js
 import { spawnSync as spawnSync2 } from "child_process";
-import { existsSync as existsSync4 } from "fs";
+import { existsSync as existsSync5 } from "fs";
 import { fileURLToPath as fileURLToPath3 } from "url";
 import { types as nodeTypes3 } from "util";
 import { types as nodeTypes2 } from "util";
@@ -18347,10 +18656,10 @@ function fail22(message) {
 }
 function cliSourcePath2() {
   const besideSource = fileURLToPath3(new URL("./cli.ts", import.meta.url));
-  if (existsSync4(besideSource))
+  if (existsSync5(besideSource))
     return besideSource;
   const packagedSource = fileURLToPath3(new URL("../src/cli.ts", import.meta.url));
-  if (existsSync4(packagedSource))
+  if (existsSync5(packagedSource))
     return packagedSource;
   return fail22("the installed Ghostget CLI source is unavailable");
 }
@@ -19425,6 +19734,28 @@ function contactMethods(contact, service) {
     });
   return methods;
 }
+function contactsWithRelationshipParticipants(directoryContacts, interactions) {
+  const contacts = [...directoryContacts];
+  const known = new Set(contacts.map((contact) => contact.id));
+  const relationshipOnlyIds = new Set;
+  for (const interaction of [...interactions].sort((left, right) => left.contactId.localeCompare(right.contactId))) {
+    if (known.has(interaction.contactId))
+      continue;
+    contacts.push({
+      accountId: interaction.accountId,
+      id: interaction.contactId,
+      fullName: null,
+      username: null,
+      phoneNumber: null,
+      email: null,
+      isSelf: false,
+      cannotMessage: null
+    });
+    known.add(interaction.contactId);
+    relationshipOnlyIds.add(interaction.contactId);
+  }
+  return { contacts, relationshipOnlyIds };
+}
 function sameExecution(left, right) {
   return left.authId === right.authId && left.authSha256 === right.authSha256 && left.adapterSha256 === right.adapterSha256 && left.contractSha256 === right.contractSha256;
 }
@@ -19737,8 +20068,12 @@ function syncBeeperContacts(database, options = {}) {
     if (pageAccount === undefined)
       throw new Error("Beeper account disappeared during sequential sync.");
     const service = normalizeService(pageAccount);
-    const contacts = page.contacts.filter((contact) => contact.isSelf !== true && contact.id !== pageAccount.user.id);
-    const skippedSelf = page.contacts.length - contacts.length;
+    const directoryContacts = page.contacts.filter((contact) => contact.isSelf !== true && contact.id !== pageAccount.user.id);
+    const skippedSelf = page.contacts.length - directoryContacts.length;
+    const accountInteractions = interactionExport?.output.interactions.filter((interaction) => interaction.accountId === pageAccount.accountId) ?? [];
+    const relationshipContacts = contactsWithRelationshipParticipants(directoryContacts, accountInteractions);
+    const contacts = relationshipContacts.contacts;
+    const contactsObserved = page.contacts.length + contacts.length - directoryContacts.length;
     const relationshipProjection = interactionExport === null ? null : projectBeeperContactInteractions(interactionExport.output, contacts.map((contact) => ({
       rawAccountId: pageAccount.accountId,
       accountKey: realmAccountKey,
@@ -19796,7 +20131,9 @@ function syncBeeperContacts(database, options = {}) {
       sourceRealm: sourceRealm(pageAccount),
       contacts: contacts.map((contact) => {
         const display = contactDisplayName(contact);
+        const relationshipOnly = relationshipContacts.relationshipOnlyIds.has(contact.id);
         return {
+          ...relationshipOnly ? { existingIdentityPolicy: "preserve" } : {},
           person: {
             displayName: display.value,
             givenName: null,
@@ -19811,7 +20148,10 @@ function syncBeeperContacts(database, options = {}) {
             birthday: null,
             observationBasis: display.basis,
             observationPriority: display.priority,
-            metadata: { createdBy: "beeper-contact", service }
+            metadata: {
+              createdBy: relationshipOnly ? "beeper-direct-interaction" : "beeper-contact",
+              service
+            }
           },
           resource: {
             type: "user",
@@ -19824,6 +20164,7 @@ function syncBeeperContacts(database, options = {}) {
             metadata: {
               authority: "beeper",
               service,
+              ...relationshipOnly ? { relationshipOnly: true } : {},
               cannotMessage: contact.cannotMessage,
               isSelf: contact.isSelf,
               emailVerification: "not-guaranteed",
@@ -19855,7 +20196,7 @@ function syncBeeperContacts(database, options = {}) {
     accountResults.push({
       realm_id: realm.id,
       service,
-      contacts_seen: page.contacts.length,
+      contacts_seen: contactsObserved,
       contacts_imported: imported.people_created,
       contacts_matched: imported.people_matched,
       contacts_skipped_self: skippedSelf,
@@ -19864,7 +20205,7 @@ function syncBeeperContacts(database, options = {}) {
       truncated: !page.localPageComplete,
       cached: imported.cached
     });
-    contactsSeen += page.contacts.length;
+    contactsSeen += contactsObserved;
     contactsImported += imported.people_created;
     contactsMatched += imported.people_matched;
     contactsSkippedSelf += skippedSelf;
@@ -19879,7 +20220,7 @@ function syncBeeperContacts(database, options = {}) {
       ordinal: index + 1,
       accounts: orderedAccounts.length,
       service,
-      contacts: page.contacts.length,
+      contacts: contactsObserved,
       truncated: !page.localPageComplete
     });
   }
@@ -21470,7 +21811,7 @@ import { Database as Database4 } from "bun:sqlite";
 import { createHash as createHash6 } from "crypto";
 import { lstatSync as lstatSync6, realpathSync as realpathSync5 } from "fs";
 import { homedir as homedir3 } from "os";
-import { join as join6, resolve as resolve4 } from "path";
+import { join as join6, resolve as resolve5 } from "path";
 var DEFAULT_IMESSAGE_DATABASE = join6(homedir3(), "Library", "Messages", "chat.db");
 var DEFAULT_IMESSAGE_ACCOUNT = "imessage-main";
 var DEFAULT_IMESSAGE_PAGE_SIZE = 1000;
@@ -21914,7 +22255,7 @@ function syncIMessageRelationships(database, options = {}) {
   const pageSize = options.pageSize ?? DEFAULT_IMESSAGE_PAGE_SIZE;
   if (!Number.isSafeInteger(pageSize) || pageSize < 1 || pageSize > MAX_PAGE_SIZE)
     throw new Error(`iMessage page size must be between 1 and ${MAX_PAGE_SIZE}`);
-  const requestedPath = resolve4(options.messagesDatabase ?? DEFAULT_IMESSAGE_DATABASE);
+  const requestedPath = resolve5(options.messagesDatabase ?? DEFAULT_IMESSAGE_DATABASE);
   const identity = lstatSync6(requestedPath);
   const uid = typeof process.getuid === "function" ? process.getuid() : null;
   if (!identity.isFile() || identity.isSymbolicLink() || identity.size < 1 || identity.size > MAX_DATABASE_BYTES || uid !== null && identity.uid !== uid) {
@@ -23000,7 +23341,7 @@ function instagramStatsAll(database) {
 // src/local/providers/x-archive.ts
 import { createHash as createHash8 } from "crypto";
 import { closeSync as closeSync7, constants as constants7, fstatSync as fstatSync6, openSync as openSync7, readSync as readSync2 } from "fs";
-import { resolve as resolve5 } from "path";
+import { resolve as resolve6 } from "path";
 
 // src/local/archive/x-zip-file.ts
 import { readSync } from "fs";
@@ -23973,7 +24314,7 @@ function sha256Descriptor(descriptor, size) {
 async function readArchive2(path) {
   if (typeof path !== "string" || path.length < 1 || path.includes("\x00"))
     throw new Error("X archive path is invalid");
-  const locator = resolve5(path);
+  const locator = resolve6(path);
   const descriptor = openSync7(locator, constants7.O_RDONLY | (constants7.O_NOFOLLOW ?? 0));
   try {
     const before = fstatSync6(descriptor, { bigint: true });
@@ -26255,7 +26596,20 @@ function syncWhatsAppRelationships(database, options = {}) {
 }
 
 // src/cli/version.ts
-var peoplebladeVersion = "0.3.3";
+var peoplebladeVersion = "0.3.5";
+
+// src/cli/intro.ts
+function terminalIntro(terminal) {
+  if (terminal.isTTY !== true || terminal.term === "dumb" || (terminal.columns ?? 80) < 48)
+    return "";
+  return `  .--.--.
+ /______/_   peopleblade
+| o  --- |   Your contacts, notes, and context.
+|___ --- |
+  |____|
+
+`;
+}
 
 // src/cli/main.ts
 var usage = `PeopleBlade \u2014 local-first contact intelligence
@@ -26264,6 +26618,8 @@ Usage: peopleblade [--db PATH] <command>
 
 Core:
   init                              Create or migrate the local database
+  menubar                           Launch the detached menu-bar companion
+  outputs                           Print the agent outputs directory
   backup [PATH]                     Create a consistent private SQLite backup
   migrate rolodex --from PATH       Back up and migrate a legacy Rolodex database once
   list [--search TEXT] [--limit N]  Search the local contact book
@@ -26408,7 +26764,7 @@ function yesNo(value, label) {
 async function readNoteMarkdown(path) {
   const maximum = 65536;
   if (path !== "-") {
-    const descriptor = openSync9(resolve6(path), constants9.O_RDONLY | constants9.O_NONBLOCK | (constants9.O_NOFOLLOW ?? 0));
+    const descriptor = openSync9(resolve7(path), constants9.O_RDONLY | constants9.O_NONBLOCK | (constants9.O_NOFOLLOW ?? 0));
     try {
       const before = fstatSync8(descriptor);
       if (!before.isFile() || before.nlink !== 1 || before.size > maximum || typeof process.getuid === "function" && before.uid !== process.getuid()) {
@@ -26490,6 +26846,8 @@ async function main(argv) {
   const asJson = flag(args, "--json");
   const autoAccept = flag(args, "--auto-accept");
   if (args.length === 0 || args[0] === "--help" || args[0] === "-h") {
+    if (!asJson)
+      process.stdout.write(terminalIntro({ isTTY: process.stdout.isTTY, columns: process.stdout.columns, term: process.env.TERM }));
     console.log(usage);
     return;
   }
@@ -26516,13 +26874,30 @@ async function main(argv) {
     print({ database: databasePath, initialized: true, ...result }, asJson);
     return;
   }
+  if (command === "menubar") {
+    if (args.length !== 1)
+      fail3("menubar takes no arguments.");
+    process.exitCode = await launchMenubar(asJson);
+    return;
+  }
+  if (command === "outputs") {
+    if (args.length !== 1)
+      fail3("outputs takes no arguments.");
+    const directory = join7(peoplebladeDirectory(), "outputs");
+    mkdirSync3(directory, { recursive: true, mode: 448 });
+    if (asJson)
+      print({ outputs: directory }, true);
+    else
+      console.log(directory);
+    return;
+  }
   if (command === "migrate" && subcommand === "rolodex") {
     const options = [...rest];
     const source = valueAfter(options, "--from") ?? fail3("migrate rolodex requires --from PATH.");
     const backup = valueAfter(options, "--backup") ?? standardBackupPath("legacy-rolodex", databasePath);
     if (options.length > 0)
       fail3(`Unknown argument: ${options[0]}`);
-    if (!existsSync5(source))
+    if (!existsSync6(source))
       fail3(`Legacy Rolodex does not exist: ${source}`);
     backupLocalDatabase(source, backup);
     print({ database: databasePath, legacyBackup: backup, ...migrateLegacyRolodex(source, databasePath) }, asJson);
@@ -26556,7 +26931,7 @@ ${verification}`) });
     print(await signOutCloud(), asJson);
     return;
   }
-  if (!existsSync5(databasePath))
+  if (!existsSync6(databasePath))
     fail3("Run `peopleblade init` or `peopleblade migrate rolodex --from PATH` first.");
   if (command === "backup") {
     const destination = subcommand ?? standardBackupPath("manual", databasePath);
@@ -26994,7 +27369,7 @@ ${verification}`) });
       const from = valueAfter(options, "--from") ?? fail3("notes import requires --from granola.json or --from -.");
       if (options.length)
         fail3(`Unknown argument: ${options[0]}`);
-      const payload = from === "-" ? parseGranolaImportJson(await new Response(Bun.stdin).text()) : readGranolaImportFile(resolve6(from));
+      const payload = from === "-" ? parseGranolaImportJson(await new Response(Bun.stdin).text()) : readGranolaImportFile(resolve7(from));
       printImport(importGranolaMeetings(database, payload), true);
       return;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hraness/peopleblade",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "Local-first, source-aware contact intelligence for people and agents",
   "type": "module",
   "bin": {