@groundtrack/hooks 0.1.20 → 0.1.22

package/dist/setup/cli.js

@@ -1,4 +1,4 @@
-import { connectAgents, connectionPrompt, formatNextSteps, prepareConnections, } from "./connections.js";
+import { connectAgents, connectionPrompt, formatNextSteps, prepareConnections, sessionImportPrompt, } from "./connections.js";
 import { AGENT_IDS, requiresHookRuntime } from "../agents.js";
 import { spawn, spawnSync } from "node:child_process";
 import { basename, join } from "node:path";
@@ -397,6 +397,7 @@ export async function runCli(argv) {
             connections = connections.map((connection) => results.find((result) => result.agent === connection.agent) ?? connection);
         }
         process.stdout.write(formatNextSteps(ready, context, connections));
+        process.stdout.write(sessionImportPrompt(ready, context, args.url));
     }
     process.exitCode = localReady && !signInFailed ? 0 : 1;
 }

package/dist/setup/connections.d.ts

@@ -25,5 +25,6 @@ export type Connection = {
 export declare const runClient: ClientRunner;
 export declare function prepareConnections(agents: AgentPlan[], context: SetupEnvironment, url: string, runner?: ClientRunner): Promise<Connection[]>;
 export declare function connectionPrompt(agents: AgentPlan[]): string;
+export declare function sessionImportPrompt(agents: AgentPlan[], context: SetupEnvironment, url: string): string;
 export declare function connectAgents(connections: Connection[], context: SetupEnvironment, runner?: ClientRunner, onStart?: (agent: Agent) => void): Promise<Connection[]>;
 export declare function formatNextSteps(agents: AgentPlan[], context: SetupEnvironment, connections?: Connection[]): string;

package/dist/setup/connections.js

@@ -171,6 +171,18 @@ export function connectionPrompt(agents) {
     const names = new Intl.ListFormat("en", { style: "long", type: "conjunction" }).format(agents.map((agent) => agent.name));
     return `Connect Groundtrack to ${names} now?`;
 }
+export function sessionImportPrompt(agents, context, url) {
+    return [
+        "",
+        "Optional session import — paste this into a configured agent:",
+        "For each selected agent still needing sign-in, follow its step above and start that client's documented login flow in an interactive terminal; do not just list the command. Let me complete OAuth, and ask for project or hook approval separately when needed. Never bypass those prompts. If interactive login cannot be started, tell me what is blocking it.",
+        `Verify Groundtrack's connection and hook context with search_experiences when available. Then preview sessions for these already-selected agents from ${context.repoDir}. Run the local previews even if sign-in or hook approval is still pending; the dry run needs neither.`,
+        ...agents.map((agent) => `  npx --yes --package @groundtrack/hooks@latest groundtrack import --agent ${agent.agent} --dry-run --url ${url}`),
+        "Use only the previews' reported session counts, repository/date scope, locally sanitized upload size, and skipped or unreadable counts. Explain that Groundtrack may analyze imported sessions for past discoveries, corrections, repository constraints, recurring friction, and possible follow-up initiatives; do not claim lessons exist before analysis.",
+        "Transcripts are private by default; high-confidence derived lessons may enter shared organizational knowledge. Ask whether I want to import and wait for yes; setup's --yes is not import approval. Once I say yes in chat, include --yes on each approved upload command to skip the CLI's duplicate confirmation; it is not a substitute for approval. Use an OAuth-minted temporary import key via the process environment only; never expose it in chat, arguments, files, or logs. After upload, share its sessions/results link and note that analysis for experiences and draft initiatives happens asynchronously.",
+        "",
+    ].join("\n");
+}
 export async function connectAgents(connections, context, runner = runClient, onStart = () => { }) {
     const results = [];
     for (const connection of connections) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@groundtrack/hooks",
-  "version": "0.1.20",
+  "version": "0.1.22",
   "description": "Lifecycle hook utilities for Groundtrack MCP clients.",
   "keywords": [
     "claude-code",