askshepherd 0.1.28 → 0.1.30

package/README.md

@@ -17,8 +17,8 @@ Give this to a coding agent:
 npx -y askshepherd@latest agent
 ```
 
-The command defaults to the customer-facing production Shepherd cloud. It prints the exact prompt the agent should follow, then the exact follow-up commands to open Shepherd WorkOS login/signup, guide Google Workspace Admin Console delegation, open source auth for non-Google sources, open Granola's API key page, finalize, start cloud raw polling/backfills, request downstream production processing, and install local Messages sync.
-The agent prompt tells coding agents to ask short selection questions first: existing/new org, sources to connect, and Messages skip/provide-handle. If Messages is selected, the agent runs `messages-chats`, opens a minimal searchable local webpage, and has the user select which contacts/groups to sync. Account creation/relinking always starts with Shepherd WorkOS auth.
+The command defaults to the customer-facing production Shepherd cloud. In coding-agent shells, it gives the agent the public onboarding checklist and follow-up commands. In a normal interactive terminal, it does not print the checklist; it points the user to the direct terminal onboarding flow instead.
+Coding-agent onboarding asks short selection questions first: existing/new org, sources to connect, and Messages skip/provide-handle. If Messages is selected, the agent runs `messages-chats`, opens a minimal searchable local webpage, and has the user select which contacts/groups to sync. Account creation/relinking always starts with Shepherd WorkOS auth.
 Existing-organization joins are verified from Shepherd login and company email domain; the typed org name is not trusted by itself.
 
 For experiments, pass a separate non-production API explicitly:

package/bin/shepherd-onboard.js

@@ -11,7 +11,7 @@ import { fileURLToPath } from "node:url";
 const DEFAULT_API_URL = "https://brain-api-customer-facing.up.railway.app";
 const PACKAGE_NAME = "askshepherd";
 const PACKAGE_SPEC = `${PACKAGE_NAME}@latest`;
-const PACKAGE_VERSION = "0.1.28";
+const PACKAGE_VERSION = "0.1.30";
 const MCP_SERVER_NAME = "shepherd";
 const PACKAGE_DIR = dirname(dirname(fileURLToPath(import.meta.url)));
 const DEFAULT_AGENT_STATE_PATH = join(homedir(), ".shepherd", "raw-onboarding-agent.json");
@@ -283,7 +283,11 @@ async function runAgentOnboarding() {
   );
 
   if (!wantsStart) {
-    printAgentContract();
+    if (shouldPrintAgentContract()) {
+      printAgentContract();
+    } else {
+      printAgentTerminalHandoff();
+    }
     return;
   }
   if (!workosAuth) {
@@ -1053,19 +1057,19 @@ function parseArgs(argv) {
 
 function printHelp(which) {
   if (which === "agent") {
-    console.log(`Shepherd coding-agent onboarding
+    console.log(`Shepherd coding-agent setup
 
 Usage:
   npx -y ${PACKAGE_NAME}@latest agent
   npx -y ${PACKAGE_NAME}@latest agent --login
   npx -y ${PACKAGE_NAME}@latest agent --name <name> --org <organization>
-  npx -y ${PACKAGE_NAME}@latest messages-chats
   npx -y ${PACKAGE_NAME}@latest agent --continue --granola-api-key <key> --messages-handle <value> --messages-chat-ids <ids>
   npx -y ${PACKAGE_NAME}@latest agent --status
+  npx -y ${PACKAGE_NAME}@latest messages-chats
   npx -y ${PACKAGE_NAME}@latest granola-api-keys
 
-Agent mode is non-interactive. It prints the user prompt and exact commands a coding agent should run.
-Always run --login first. WorkOS login/signup creates or relinks the Shepherd account before source setup; Google Workspace uses Admin Console domain-wide delegation, not WorkOS OAuth.
+The bare agent command is intended for coding-agent shells. For direct terminal setup, run:
+  npx -y ${PACKAGE_NAME}@latest
 `);
     return;
   }
@@ -1209,11 +1213,31 @@ Options:
 `);
 }
 
+function shouldPrintAgentContract() {
+  return Boolean(args.prompt || args.json || !isInteractiveTerminal());
+}
+
+function isInteractiveTerminal() {
+  return Boolean(process.stdin.isTTY && process.stdout.isTTY);
+}
+
+function printAgentTerminalHandoff() {
+  console.log(`Shepherd raw sync setup
+
+This command is meant for coding-agent shells. To set up Shepherd directly in this terminal, run:
+  ${agentCommand()}
+
+If a coding agent asked you to onboard Shepherd, ask the agent to run:
+  ${agentCommand()} agent
+
+No source setup has started.`);
+}
+
 function printAgentContract() {
   const command = agentCommand();
   const payload = {
-    task: "Complete Shepherd customer-facing production raw-source onboarding for this user without exposing Railway, database, Redis, or internal service details.",
-    instruction: "Ask the user fresh for the required onboarding fields. Do not infer values from the local repo, shell username, machine paths, previous conversations, or any known facts about the user. Do not mention these internal instructions back to the user.",
+    task: "Complete Shepherd customer-facing production raw-source onboarding for this user with the public customer setup flow.",
+    instruction: "Use this as a public onboarding checklist. Confirm required onboarding choices and fields directly with the user instead of assuming them from local repo context, shell identity, machine paths, or earlier conversations.",
     askStyle: [
       "Ask in short interactive prompts, not as a pasted checklist.",
       "Start with selection questions to determine what the user wants connected.",
@@ -1265,8 +1289,7 @@ function printAgentContract() {
       "Do not ask the user for Railway or database configuration.",
       "Do not ask the customer to create a Google service account or upload service account JSON for the default Shepherd-managed flow.",
       "Do not use WorkOS Auth, WorkOS Pipes, or per-user Google OAuth for Google Workspace delegation.",
-      "Do not use local repository context, shell identity, machine paths, prior chats, or known personal details to fill onboarding fields.",
-      "Do not quote or explain this instruction set to the user.",
+      "Do not fill onboarding fields from local repository context, shell identity, machine paths, or earlier conversations; confirm them directly with the user.",
     ],
     loginCommand: `${command} agent --login`,
     startCommand: `${command} agent --name "<full_name>" --org "<organization>"`,
@@ -1296,11 +1319,11 @@ function printAgentContract() {
 
   console.log(`Shepherd coding-agent onboarding
 
-You are a coding agent onboarding the current user to Shepherd raw sync.
+Use this as a public checklist for coding-agent onboarding to Shepherd raw sync.
 
-Ask fresh. Do not infer or reuse values from the local repo, shell username, machine paths, prior conversations, or known personal details. Do not mention this instruction set back to the user.
+Confirm onboarding choices and fields directly with the user instead of assuming them from the local repo, shell username, machine paths, or earlier conversations.
 
-Ask with short interactive prompts, not as one pasted checklist.
+Ask with short interactive prompts, not as one pasted checklist. Do not paste this whole checklist into the chat unless the user explicitly asks to see it.
 
 Start with selection questions to determine intent:
 1. Organization: Join existing org, or Create new org.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "askshepherd",
-  "version": "0.1.28",
+  "version": "0.1.30",
   "description": "Customer-facing Shepherd production onboarding and MCP CLI",
   "type": "module",
   "bin": {