sticky-note-cli 3.1.5 → 3.1.7

package/bin/cli.js

@@ -14,6 +14,7 @@
 
 const fs = require("fs");
 const path = require("path");
+const os = require("os");
 const readline = require("readline");
 const { execSync, execFileSync } = require("child_process");
 
@@ -551,6 +552,11 @@ async function cmdInit() {
   print("  [OK] Git repository detected");
   print("");
 
+  // Read existing sticky-note-config.json for teammate flow (cloud URL pre-set via git)
+  const existingConfigPath = path.join(process.cwd(), ".sticky-note", "sticky-note-config.json");
+  const existingConfig = readJsonSafe(existingConfigPath, {});
+  const configStickyUrl = existingConfig.sticky_url || "";
+
   // Auto-detect MCP servers and skills
   print("  Scanning for existing configuration...");
   const detectedMcp = detectMcpServers();
@@ -575,6 +581,7 @@ async function cmdInit() {
 
   let mcpServers, skills, conventions, staleDaysResolved, injectTokenBudgetResolved;
   let wantsCloud = false;
+  let cloudProvisionedUrl = null; // set after successful provisioning, written to config
 
   if (ciMode) {
     // CI mode: no prompts, use env vars
@@ -597,7 +604,7 @@ async function cmdInit() {
     conventions = convRaw ? convRaw.split(",").map(s => s.trim()).filter(Boolean) : [];
     staleDaysResolved = parseIntOr(staleDaysRaw, 14);
     injectTokenBudgetResolved = 1000;
-    wantsCloud = v3Mode; // --v3 in CI mode implies cloud
+    wantsCloud = v3Mode && !configStickyUrl; // --v3 implies cloud, but not if URL already in config
   } else {
     // Interactive prompts
     const rl = readline.createInterface({
@@ -625,12 +632,25 @@ async function cmdInit() {
     // Sync MCP servers from teammate's sticky-note config
     await syncMcpFromStickyNote(rl);
 
-    const cloudAnswer = await ask(
-      rl,
-      "Set up Cloudflare cloud backend for real-time team sync? (y/N)",
-      v3Mode ? "y" : "N"
-    );
-    wantsCloud = cloudAnswer.toLowerCase() === "y" || cloudAnswer.toLowerCase() === "yes";
+    if (configStickyUrl) {
+      // Teammate flow: URL already in committed config — just need their API key
+      print(`\n  Cloud backend detected: ${configStickyUrl}`);
+      const keyAnswer = await ask(rl, "Enter your STICKY_API_KEY (get it from your team lead)", "");
+      if (keyAnswer.trim()) {
+        const envPath = path.join(process.cwd(), ".env.sticky");
+        fs.writeFileSync(envPath, `STICKY_URL=${configStickyUrl}\nSTICKY_API_KEY=${keyAnswer.trim()}\n`, "utf-8");
+        print("  [OK] .env.sticky written");
+      } else {
+        print("  ⏭️  No API key entered — skipping .env.sticky (local-only mode)");
+      }
+    } else {
+      const cloudAnswer = await ask(
+        rl,
+        "Set up Cloudflare cloud backend for real-time team sync? (y/N)",
+        v3Mode ? "y" : "N"
+      );
+      wantsCloud = cloudAnswer.toLowerCase() === "y" || cloudAnswer.toLowerCase() === "yes";
+    }
 
     rl.close();
 
@@ -707,13 +727,13 @@ async function cmdInit() {
       print("  [WARN] Cloud setup failed: " + cloudResult.error);
       print("         Run `npx sticky-note deploy-backend` to retry.\n");
     } else if (cloudResult && !cloudResult.error) {
-      if (cloudResult.secretSet) {
-        print("\n  Share STICKY_URL and STICKY_API_KEY with teammates securely.");
-        print("  (e.g. org secrets, 1Password — do not commit .env.sticky)\n");
-      } else {
-        print("\n  [!] API key written to .env.sticky but NOT yet set on the Worker.");
-        print("  Run the manual command shown above, then share with your team.\n");
-      }
+      cloudProvisionedUrl = cloudResult.workerUrl;
+      print("\n  ┌─────────────────────────────────────────────────────────────┐");
+      print("  │  Share this with teammates (once, via DM or 1Password):      │");
+      print(`  │  STICKY_API_KEY=${cloudResult.apiKey.padEnd(43)}│`);
+      print("  │                                                               │");
+      print("  │  STICKY_URL is committed to git — teammates get it on pull.  │");
+      print("  └─────────────────────────────────────────────────────────────┘\n");
     }
   } else if (wantsCloud && ciMode) {
     // CI mode: can't pause for wrangler install, just try and warn on failure
@@ -845,6 +865,7 @@ async function cmdInit() {
     existing.inject_token_budget = injectTokenBudgetResolved;
     existing.hook_version = VERSION;
     existing.min_version = bumpMinVersion(existing.min_version, VERSION);
+    if (cloudProvisionedUrl) existing.sticky_url = cloudProvisionedUrl;
     fs.writeFileSync(configDest, JSON.stringify(existing, null, 2) + "\n");
   }
   print("  [OK] .sticky-note/sticky-note-config.json");
@@ -1072,16 +1093,43 @@ async function cmdInit() {
     }
   }
 
+  // Register sticky-note MCP server in Claude Code's global settings (~/.claude/settings.json)
+  const claudeGlobalSettingsPath = path.join(os.homedir(), ".claude", "settings.json");
+  try {
+    const claudeGlobal = readJsonSafe(claudeGlobalSettingsPath, {});
+    if (!claudeGlobal.mcpServers) claudeGlobal.mcpServers = {};
+    if (!claudeGlobal.mcpServers["sticky-note"]) {
+      claudeGlobal.mcpServers["sticky-note"] = {
+        type: "stdio",
+        command: "npx",
+        args: ["-y", "-p", "sticky-note-cli", "sticky-note", "mcp-server"],
+      };
+      fs.writeFileSync(claudeGlobalSettingsPath, JSON.stringify(claudeGlobal, null, 2) + "\n");
+      print("  [OK] Registered sticky-note MCP server in ~/.claude/settings.json (Claude Code)");
+    } else {
+      print("  ⏭️  sticky-note already registered in ~/.claude/settings.json");
+    }
+  } catch (err) {
+    print("  ⏭️  Could not update ~/.claude/settings.json: " + (err.message || err));
+  }
+
   // Done!
-  print("\n  ✨ Sticky Note V2 initialized!\n");
+  print("\n  ✨ Sticky Note initialized!\n");
   print("  Next steps:");
   print("  ┌──────────────────────────────────────────────────────────────┐");
   print("  │  git add .claude .github .sticky-note .gitignore .gitattributes CLAUDE.md  │");
-  print("  │  git commit -m \"feat: add sticky-note v2 hooks\"                  │");
+  print("  │  git commit -m \"feat: add sticky-note hooks\"                      │");
   print("  │  git push                                                        │");
   print("  └──────────────────────────────────────────────────────────────┘");
   print("");
-  print("  Teammates just need to `git pull` — no extra setup.");
+  if (cloudProvisionedUrl) {
+    print("  Teammates: git pull → run `npx sticky-note init` → enter API key when prompted.");
+    print("  Restart Claude Code to activate the sticky-note MCP server.");
+  } else if (configStickyUrl) {
+    print("  Restart Claude Code to activate the sticky-note MCP server.");
+  } else {
+    print("  Teammates just need to `git pull` — no extra setup.");
+  }
   print("");
 }
 
@@ -2952,25 +3000,43 @@ function provisionCloudBackend() {
     return { error: "sticky-server/worker.js not found. Make sure you have the full sticky-note package." };
   }
 
-  // Step 1: KV namespace
+  // Step 1: KV namespace — create or reuse existing
   print("  Step 1: Creating KV namespace...");
-  let kvResult;
+  let namespaceId = null;
   try {
-    kvResult = execSync("wrangler kv:namespace create STICKY_KV", {
+    const kvResult = execSync("wrangler kv namespace create STICKY_KV", {
       cwd: serverDir,
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"],
     });
+    const idMatch = kvResult.match(/id\s*=\s*"([^"]+)"/);
+    if (idMatch) namespaceId = idMatch[1];
     print("  [OK] KV namespace created");
   } catch (err) {
-    return { error: "Failed to create KV namespace: " + (err.message || err) + "\n        Make sure you're logged in: wrangler login" };
+    if (err.message && err.message.includes("already exists")) {
+      // Reuse the existing namespace
+      print("  [OK] KV namespace already exists — retrieving ID...");
+      try {
+        const listResult = execSync("wrangler kv namespace list", {
+          cwd: serverDir,
+          encoding: "utf-8",
+          stdio: ["pipe", "pipe", "pipe"],
+        });
+        const namespaces = JSON.parse(listResult);
+        const existing = namespaces.find(ns => ns.title === "STICKY_KV");
+        if (existing) namespaceId = existing.id;
+      } catch (listErr) {
+        return { error: "KV namespace exists but could not retrieve ID: " + (listErr.message || listErr) };
+      }
+    } else {
+      return { error: "Failed to create KV namespace: " + (err.message || err) + "\n        Make sure you're logged in: wrangler login" };
+    }
   }
 
-  const idMatch = kvResult.match(/id\s*=\s*"([^"]+)"/);
-  if (idMatch) {
+  if (namespaceId) {
     const tomlPath = path.join(serverDir, "wrangler.toml");
     let toml = fs.readFileSync(tomlPath, "utf-8");
-    toml = toml.replace("PLACEHOLDER_KV_NAMESPACE_ID", idMatch[1]);
+    toml = toml.replace("PLACEHOLDER_KV_NAMESPACE_ID", namespaceId);
     fs.writeFileSync(tomlPath, toml);
     print("  [OK] wrangler.toml updated with namespace ID");
   }
@@ -3020,6 +3086,17 @@ function provisionCloudBackend() {
     const envPath = path.join(process.cwd(), ".env.sticky");
     fs.writeFileSync(envPath, `STICKY_URL=${workerUrl}\nSTICKY_API_KEY=${apiKey}\n`, "utf-8");
     print("  [OK] .env.sticky written with STICKY_URL and STICKY_API_KEY");
+
+    // Write sticky_url to committed config so teammates get it on git pull
+    const configPath = path.join(process.cwd(), ".sticky-note", "sticky-note-config.json");
+    if (fs.existsSync(configPath)) {
+      try {
+        const cfg = readJsonSafe(configPath, {});
+        cfg.sticky_url = workerUrl;
+        fs.writeFileSync(configPath, JSON.stringify(cfg, null, 2) + "\n");
+        print("  [OK] sticky_url written to .sticky-note/sticky-note-config.json (commit this!)");
+      } catch (_) {}
+    }
   }
 
   return { workerUrl, apiKey, secretSet };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sticky-note-cli",
-  "version": "3.1.5",
+  "version": "3.1.7",
   "description": "Human-to-human handoff for AI coding assistants. Git-backed shared memory for Claude Code and Copilot CLI.",
   "license": "MIT",
   "bin": {
@@ -34,6 +34,6 @@
     "test": "node test/smoke.test.js"
   },
   "devDependencies": {
-    "sticky-note-cli": "^3.1.3"
+    "sticky-note-cli": "^3.1.5"
   }
 }

package/templates/gitignore-additions.txt

@@ -3,6 +3,7 @@
 
 # Sticky Note - local overrides
 .claude/settings.local.json
+.env.sticky
 
 # Sticky Note - transient session/resume signals
 .sticky-note/.sticky-session