shepherd-onboard 0.1.5 → 0.1.6

package/README.md

@@ -27,7 +27,8 @@ The command:
 - creates or reuses the organization, including case-insensitive and close-name matches
 - opens Google authorization for Gmail, Docs, and Calendar consent
 - opens Slack authorization
-- opens Granola's API key screen with `open 'granola://settings/connectors/api-keys'`
+- opens the Granola desktop app with `open -b com.granola.app`
+- directs the coding agent/user to Granola Settings -> Connectors -> API keys
 - collects the Granola API key after opening the Granola screen when Granola is enabled
 - sets up local macOS Messages raw sync with a background LaunchAgent
 - starts raw polling/backfill for connected sources

package/bin/shepherd-onboard.js

@@ -597,7 +597,8 @@ function printAgentContract() {
     ],
     statusCommand: `${command} agent --status`,
     expectedResult: "Cloud sources start raw polling/backfill in the customer-facing Shepherd environment. Local Messages starts via a macOS LaunchAgent when run on macOS. Downstream wiki, memory, and summary compilers remain outside this onboarding flow.",
-    granolaApiKeyCommand: "open 'granola://settings/connectors/api-keys'",
+    granolaApiKeyCommand: "open -b com.granola.app",
+    granolaApiKeyPath: "Granola desktop app -> Settings -> Connectors -> API keys",
   };
 
   if (args.json) {
@@ -642,9 +643,13 @@ Add skip flags for sources the user did not select:
 - --no-messages
 
 That command creates/reuses the customer user and org, opens Google/Slack browser auth, and saves local state.
-It also runs:
-  open 'granola://settings/connectors/api-keys'
-and activates Granola so the user can create/copy the API key.
+If Granola is selected, it also opens the Granola desktop app. Use local computer control to navigate Granola to:
+  Settings -> Connectors -> API keys
+Then have the user create/copy the API key.
+
+If Granola did not come forward, run:
+  ${payload.granolaApiKeyCommand}
+Then navigate the visible Granola app to Settings -> Connectors -> API keys.
 
 After Google/Gmail/Docs/Calendar and Slack browser auth is complete, and after the user has copied a Granola API key from the opened Granola screen if they want Granola, run:
   ${payload.continueCommand} --messages-handle "<phone_or_apple_id>" --granola-api-key "<granola_key>"
@@ -840,8 +845,8 @@ async function openOrPrint(url, opts) {
 async function openGranolaApiKeys(opts = {}) {
   const deepLink = "granola://settings/connectors/api-keys";
   if (opts.noOpen) {
-    console.log(`Granola API keys: ${deepLink}`);
-    return { opened: false, target: deepLink };
+    console.log("Granola API keys: open the Granola desktop app -> Settings -> Connectors -> API keys");
+    return { opened: false, target: "Granola Settings -> Connectors -> API keys" };
   }
 
   if (platform() !== "darwin") {
@@ -850,21 +855,25 @@ async function openGranolaApiKeys(opts = {}) {
   }
 
   console.log("\nOpening Granola API keys");
-  const deepLinkResult = await execFileQuiet("open", [deepLink], { ignoreError: true, captureError: true });
-  await sleep(700);
-  const activateResult = await execFileQuiet("osascript", [
+  const bundleResult = await execFileQuiet("open", ["-b", "com.granola.app"], { ignoreError: true, captureError: true });
+  await sleep(500);
+  await execFileQuiet("open", [deepLink], { ignoreError: true, captureError: true });
+  await sleep(500);
+  const activateByBundleResult = await execFileQuiet("osascript", [
     "-e",
     'tell application id "com.granola.app" to activate',
   ], { ignoreError: true, captureError: true });
+  const activateByNameResult = await execFileQuiet("open", ["-a", "Granola"], { ignoreError: true, captureError: true });
 
-  if (deepLinkResult.error || activateResult.error) {
+  if (bundleResult.error && activateByBundleResult.error && activateByNameResult.error) {
     await execFileQuiet("open", ["-a", "Granola"], { ignoreError: true });
   }
 
   return {
     opened: true,
-    target: deepLink,
-    fallback: "If Granola does not land on the API key screen, open Settings -> Connectors -> API keys in Granola.",
+    target: "Granola Settings -> Connectors -> API keys",
+    attemptedDeepLink: deepLink,
+    fallback: "Use local computer control to navigate Granola to Settings -> Connectors -> API keys.",
   };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shepherd-onboard",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Customer-facing Shepherd raw sync onboarding CLI",
   "type": "module",
   "bin": {