@hraness/peopleblade 0.3.4 → 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.4
+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.4 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
@@ -11733,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";
@@ -11742,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")
@@ -11945,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()) {
@@ -12363,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) => {
@@ -12633,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) {
@@ -12652,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(
@@ -12768,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,
@@ -12838,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;
@@ -13136,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");
 }
@@ -14150,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";
@@ -18596,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");
 }
@@ -19674,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;
 }
@@ -19986,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,
@@ -20045,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,
@@ -20060,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",
@@ -20073,6 +20164,7 @@ function syncBeeperContacts(database, options = {}) {
             metadata: {
               authority: "beeper",
               service,
+              ...relationshipOnly ? { relationshipOnly: true } : {},
               cannotMessage: contact.cannotMessage,
               isSelf: contact.isSelf,
               emailVerification: "not-guaranteed",
@@ -20104,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,
@@ -20113,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;
@@ -20128,7 +20220,7 @@ function syncBeeperContacts(database, options = {}) {
       ordinal: index + 1,
       accounts: orderedAccounts.length,
       service,
-      contacts: page.contacts.length,
+      contacts: contactsObserved,
       truncated: !page.localPageComplete
     });
   }
@@ -21719,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;
@@ -22163,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) {
@@ -23249,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";
@@ -24222,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 });
@@ -26504,7 +26596,7 @@ function syncWhatsAppRelationships(database, options = {}) {
 }
 
 // src/cli/version.ts
-var peoplebladeVersion = "0.3.4";
+var peoplebladeVersion = "0.3.5";
 
 // src/cli/intro.ts
 function terminalIntro(terminal) {
@@ -26526,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
@@ -26670,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()) {
@@ -26780,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);
@@ -26820,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);
@@ -27258,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.4",
+  "version": "0.3.5",
   "description": "Local-first, source-aware contact intelligence for people and agents",
   "type": "module",
   "bin": {