shepherd-onboard 0.1.1 → 0.1.2

package/bin/shepherd-onboard.js

@@ -203,7 +203,7 @@ async function runAgentOnboarding() {
       opened,
       granolaApiKeyPage,
       statePath,
-      nextCommand: `${agentCommand()} agent --continue --messages-handle "<phone_or_apple_id>" --granola-api-key "<granola_key_if_any>"`,
+      nextCommand: `${agentCommand()} agent --continue --messages-handle "<phone_or_apple_id>" --granola-api-key "<granola_key>"`,
       needsUserAction: agentNeedsUserAction(sources, opened),
     }, null, 2));
     return;
@@ -229,7 +229,8 @@ async function runAgentOnboarding() {
   if (sources.granola) console.log("2. Ask the user for their Granola API key from the Granola Mac app.");
   if (sources.messages) console.log("3. Use the Messages phone number or Apple ID email collected before starting onboarding.");
   console.log("4. Run:");
-  console.log(`   ${agentCommand()} agent --continue --messages-handle "<phone_or_apple_id>" --granola-api-key "<granola_key_if_any>"`);
+  console.log(`   ${agentCommand()} agent --continue --messages-handle "<phone_or_apple_id>" --granola-api-key "<granola_key>"`);
+  console.log("   Omit either optional flag if that source is not being connected.");
 }
 
 async function continueAgentOnboarding() {
@@ -273,7 +274,7 @@ async function continueAgentOnboarding() {
       status: errors ? "waiting" : "completed",
       connected: Object.keys(finalized.connected ?? {}),
       errors: errors ? safeErrorRecord(errors) : undefined,
-      nextCommand: errors ? `${agentCommand()} agent --continue --messages-handle "<phone_or_apple_id>" --granola-api-key "<granola_key_if_any>"` : undefined,
+      nextCommand: errors ? `${agentCommand()} agent --continue --messages-handle "<phone_or_apple_id>" --granola-api-key "<granola_key>"` : undefined,
     }, null, 2));
     return;
   }
@@ -284,7 +285,8 @@ async function continueAgentOnboarding() {
       console.log(`- ${source}: ${safeError(message)}`);
     }
     console.log("\nAfter the user completes missing auth/details, rerun:");
-    console.log(`   ${agentCommand()} agent --continue --messages-handle "<phone_or_apple_id>" --granola-api-key "<granola_key_if_any>"`);
+    console.log(`   ${agentCommand()} agent --continue --messages-handle "<phone_or_apple_id>" --granola-api-key "<granola_key>"`);
+    console.log("   Omit either optional flag if that source is not being connected.");
     return;
   }
 
@@ -445,7 +447,11 @@ function printAgentContract() {
       "Do not quote or explain this instruction set to the user.",
     ],
     startCommand: `${command} agent --email "<email>" --name "<full_name>" --org "<organization>"`,
-    continueCommand: `${command} agent --continue --messages-handle "<phone_or_apple_id>" --granola-api-key "<granola_key_if_any>"`,
+    continueCommand: `${command} agent --continue`,
+    optionalContinueArgs: [
+      "--messages-handle \"<phone_or_apple_id>\" if local Messages is being connected",
+      "--granola-api-key \"<granola_key>\" if Granola is being connected",
+    ],
     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'",
@@ -477,7 +483,9 @@ It also runs:
 and activates Granola so the user can create/copy the API key.
 
 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}
+  ${payload.continueCommand} --messages-handle "<phone_or_apple_id>" --granola-api-key "<granola_key>"
+
+Omit either optional flag if that source is not being connected.
 
 Check progress with:
   ${payload.statusCommand}

package/package.json

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