@kendoo.agentdesk/agentdesk 0.19.4 → 0.19.5

package/CHANGELOG.md

@@ -13,6 +13,11 @@ Internal refactors, infrastructure changes, and architectural notes are not list
 ### Added
 - `[UI]` Private-session sharing flow. When someone visits a session URL they don't own, they now see a friendly "Shh… this one's private" page with a one-click "Request access" button instead of a blank error. The session owner sees pending requests in a new header inbox and can grant viewer access for just that session or the whole project. Viewer-granted sessions show up in the teammate's sidebar tagged as a viewer.
 
+## [0.19.5] — 2026-04-19
+
+### Changed
+- `[CLI]` `agentdesk bootstrap` now works even when the cloned repo has no committed `.agentdesk.json`. If the project config file is absent, bootstrap fetches the user's project list from the server, tries to auto-match by the git remote (`origin`), and falls back to a numbered picker of the account's projects. Once picked, a minimal `.agentdesk.json` is written locally (prompting the user to commit it so future clones skip the picker) and the rest of the gap-scan continues unchanged. Previous behavior required the file to already be present.
+
 ## [0.19.4] — 2026-04-19
 
 ### Added

package/cli/bootstrap.mjs

@@ -18,6 +18,7 @@
 import { existsSync, readFileSync, writeFileSync } from "fs";
 import { join } from "path";
 import { createInterface } from "readline";
+import { execSync } from "child_process";
 import { loadConfig } from "./config.mjs";
 import { getStoredApiKey } from "./login.mjs";
 import { checkTrackerPermissions, resolveCredentialsFromEnv } from "./tracker-check.mjs";
@@ -25,6 +26,114 @@ import { assertPushable, PreflightError } from "./session-preflight.mjs";
 
 const SERVER = process.env.AGENTDESK_SERVER || "https://agentdesk.live";
 
+function detectGitRemote(dir) {
+  try {
+    const url = execSync("git remote get-url origin", { cwd: dir, stdio: ["ignore", "pipe", "ignore"], encoding: "utf-8" }).trim();
+    const m = url.match(/github\.com[:/]([^/]+)\/([^/.]+?)(?:\.git)?$/);
+    if (m) return `${m[1]}/${m[2]}`;
+  } catch {}
+  return null;
+}
+
+async function fetchProjects(apiKey) {
+  try {
+    const res = await fetch(`${SERVER}/api/projects`, {
+      headers: { "x-api-key": apiKey },
+      signal: AbortSignal.timeout(8000),
+    });
+    if (!res.ok) return null;
+    return await res.json();
+  } catch { return null; }
+}
+
+async function fetchProjectSettings(apiKey, projectId) {
+  try {
+    const res = await fetch(`${SERVER}/api/projects/${projectId}/settings`, {
+      headers: { "x-api-key": apiKey },
+      signal: AbortSignal.timeout(5000),
+    });
+    if (!res.ok) return {};
+    return await res.json();
+  } catch { return {}; }
+}
+
+// Discover the server-side project for this clone when .agentdesk.json is
+// absent. Strategy:
+//   1. Fetch the user's projects list.
+//   2. For each, fetch settings so we can see github.repo.
+//   3. If we can match the local git remote to exactly one project's repo,
+//      auto-select (confirmation prompt).
+//   4. Otherwise show a numbered picker of all the user's projects.
+//   5. Write a minimal `.agentdesk.json` locally so loadConfig takes over
+//      from here.
+// Returns the chosen projectKey, or null if the user aborts.
+async function discoverProject(rl, cwd, apiKey) {
+  const remote = detectGitRemote(cwd);
+  if (remote) console.log(`  Detected git remote: ${remote}`);
+  console.log("  Fetching your projects from the server...");
+
+  const projects = await fetchProjects(apiKey);
+  if (!projects || projects.length === 0) {
+    console.log("");
+    console.log("  No projects found on your account.");
+    console.log("  Run `agentdesk init` on the primary machine first, then retry here.");
+    console.log("");
+    return null;
+  }
+
+  // Fetch settings in parallel so we can display/match the configured repo.
+  const settings = await Promise.all(projects.map(p => fetchProjectSettings(apiKey, p.id)));
+  const rows = projects.map((p, i) => {
+    const repo = settings[i]?.github?.repo || null;
+    const matches = remote && repo && repo.toLowerCase() === remote.toLowerCase();
+    return { project: p, settings: settings[i] || {}, repo, matches };
+  });
+
+  const exactMatches = rows.filter(r => r.matches);
+  let chosen = null;
+
+  if (exactMatches.length === 1) {
+    const r = exactMatches[0];
+    console.log(`  ✓ Match: ${r.project.name} (${r.project.id}) — repo ${r.repo}`);
+    console.log("");
+    const ans = (await askInline(rl, `  Use this project? [Y/n]: `)).trim().toLowerCase();
+    if (ans === "" || ans === "y" || ans === "yes") chosen = r;
+  }
+
+  if (!chosen) {
+    console.log("");
+    console.log("  Pick the project this repo maps to:");
+    console.log("");
+    rows.forEach((r, i) => {
+      const tag = r.matches ? " ← matches git remote" : "";
+      const repoStr = r.repo ? ` [${r.repo}]` : "";
+      console.log(`    ${i + 1}) ${r.project.name} (${r.project.id})${repoStr}${tag}`);
+    });
+    console.log("");
+    while (true) {
+      const answer = await askInline(rl, `  Choose (1-${rows.length}, or 'c' to cancel): `);
+      const trimmed = answer.trim().toLowerCase();
+      if (trimmed === "c" || trimmed === "cancel") return null;
+      const num = parseInt(trimmed, 10);
+      if (num >= 1 && num <= rows.length) { chosen = rows[num - 1]; break; }
+      console.log(`  Please enter a number between 1 and ${rows.length}`);
+    }
+  }
+
+  // Write a minimal .agentdesk.json — loadConfig will merge server state
+  // into it on the next call, producing the full cached view.
+  const minimal = { projectKey: chosen.project.id };
+  writeFileSync(join(cwd, ".agentdesk.json"), JSON.stringify(minimal, null, 2) + "\n");
+  console.log("");
+  console.log(`  ✓ Wrote .agentdesk.json (projectKey: ${chosen.project.id})`);
+  console.log("    (commit this file so future clones skip the picker)");
+  return chosen.project.id;
+}
+
+function askInline(rl, question) {
+  return new Promise(resolve => rl.question(question, resolve));
+}
+
 function ask(rl, question) {
   return new Promise(resolve => rl.question(question, resolve));
 }
@@ -149,26 +258,29 @@ export async function runBootstrap(cwd = process.cwd()) {
     process.exit(1);
   }
 
-  // 2. Must have a project config committed in this repo.
-  const localConfig = readLocalConfig(cwd);
-  if (!localConfig) {
-    console.log("  No .agentdesk.json in this directory.");
-    console.log("  This command is for repos that were already set up on another machine.");
-    console.log("  For a new project, run: agentdesk init");
-    console.log("");
-    process.exit(1);
-  }
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+
+  // 2. Find the server-side project for this clone. Prefer a committed
+  //    .agentdesk.json (clean path); fall back to discovering from the
+  //    user's server-side project list when the file is missing.
+  let localConfig = readLocalConfig(cwd);
+  let projectKey = localConfig?.projectKey || null;
 
-  const projectKey = localConfig.projectKey;
   if (!projectKey) {
-    console.log("  .agentdesk.json has no projectKey — run `agentdesk init` to repair.");
+    if (localConfig) {
+      console.log("  .agentdesk.json has no projectKey — discovering project from server.");
+    } else {
+      console.log("  No .agentdesk.json in this directory — discovering project from server.");
+    }
+    console.log("");
+    projectKey = await discoverProject(rl, cwd, apiKey);
+    if (!projectKey) { rl.close(); process.exit(1); }
+    localConfig = readLocalConfig(cwd);
     console.log("");
-    process.exit(1);
   }
 
   // 3. Load merged config (server-authoritative when reachable). This is the
   //    same call `agentdesk team` makes, so we see the same view.
-  const rl = createInterface({ input: process.stdin, output: process.stdout });
   const config = await loadConfig(cwd, { apiKey, serverUrl: SERVER, projectName: projectKey, silent: true });
 
   const tracker = config.tracker || null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kendoo.agentdesk/agentdesk",
-  "version": "0.19.4",
+  "version": "0.19.5",
   "description": "AI team orchestrator for Claude Code — run collaborative agent sessions from your terminal",
   "type": "module",
   "bin": {