qatools-cli 1.1.10 → 1.1.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qatools-cli",
-  "version": "1.1.10",
+  "version": "1.1.12",
   "description": "CLI for QA Tools — requirements, epics, sprints, sessions, App Context sync, project agenda. The companion to qa-tools.com.",
   "scripts": {
     "release": "npm version patch --no-git-tag-version && npm publish",

package/qatools.js

@@ -129,6 +129,50 @@ program
   .description("CLI for QA Tools")
   .version(require("./package.json").version);
 
+// Update nudge: before every command, print (from cache) if the installed CLI is behind npm,
+// and refresh the cache in the background (throttled to once/day). sync can't upgrade the tool itself.
+// Kept fully non-blocking and fail-open so it never slows or breaks a command (parse() is sync).
+const VERSION_CACHE_FILE = path.join(process.env.HOME || process.env.USERPROFILE || ".", ".qatools-version");
+function cmpVersion(a, b) {
+  const pa = String(a).split(".").map(Number), pb = String(b).split(".").map(Number);
+  for (let i = 0; i < 3; i++) { const d = (pa[i] || 0) - (pb[i] || 0); if (d) return d < 0 ? -1 : 1; }
+  return 0;
+}
+function printUpdateNoticeFromCache() {
+  try {
+    const current = require("./package.json").version;
+    const cache = JSON.parse(fs.readFileSync(VERSION_CACHE_FILE, "utf8"));
+    if (cache.latest && cmpVersion(current, cache.latest) < 0) {
+      // stderr so it never corrupts parseable stdout (e.g. -o json output)
+      console.error(`\n⚠ qatools-cli ${current} → ${cache.latest} available. Upgrade: npm i -g qatools-cli@latest\n`);
+    }
+  } catch { /* no cache yet or unreadable — skip */ }
+}
+function refreshVersionCacheInBackground() {
+  try {
+    let cache = {};
+    try { cache = JSON.parse(fs.readFileSync(VERSION_CACHE_FILE, "utf8")); } catch { /* none */ }
+    if (cache.checkedAt && Date.now() - cache.checkedAt < 24 * 3600 * 1000) return; // throttled: at most once/day
+    const req = require("https").get("https://registry.npmjs.org/qatools-cli/latest", { timeout: 3000 }, (res) => {
+      let body = "";
+      res.on("data", (c) => (body += c));
+      res.on("end", () => {
+        try {
+          const latest = JSON.parse(body).version;
+          if (latest) fs.writeFileSync(VERSION_CACHE_FILE, JSON.stringify({ latest, checkedAt: Date.now() }));
+        } catch { /* malformed — skip */ }
+      });
+    });
+    req.on("error", () => {});
+    req.on("timeout", () => req.destroy());
+    if (req.unref) req.unref(); // don't keep the process alive for this
+  } catch { /* never block the command */ }
+}
+program.hook("preAction", () => {
+  printUpdateNoticeFromCache();
+  refreshVersionCacheInBackground();
+});
+
 program
   .command("upload-analysis")
   .description("Upload a Claude analysis JSON to a test session")
@@ -290,6 +334,31 @@ program
     process.exit(0);
   });
 
+program
+  .command("member-add")
+  .description("Add a member to the project by email — sends them an invite email automatically")
+  .requiredOption("--member <email>", "Email of the person to add as a member")
+  .option("--project <id>", "Target project ID (overrides default)")
+  .option("-e, --email <email>", "Login email")
+  .option("-p, --password <password>", "Login password")
+  .action(async (options) => {
+    await authenticate(options);
+    const creds = getCredentials();
+    const projectId = options.project || creds?.projectId;
+    if (!projectId) { console.error("No project configured. Run: qatools setup, or pass --project <id>"); process.exit(1); }
+
+    const addMember = httpsCallable(functions, "addProjectMember");
+    try {
+      const result = await addMember({ projectId, email: options.member });
+      if (result.data.alreadyMember) console.log(`${result.data.email} is already a member.`);
+      else console.log(`Added ${result.data.email} — an invite email has been sent.`);
+    } catch (e) {
+      console.error("Failed:", e.message);
+      process.exit(1);
+    }
+    process.exit(0);
+  });
+
 program
   .command("pending")
   .description("List test sessions awaiting Claude analysis")
@@ -740,36 +809,6 @@ program
     process.exit(0);
   });
 
-// Non-blocking: warn if a newer qatools-cli is published on npm (sync can't upgrade the tool itself)
-function cmpVersion(a, b) {
-  const pa = String(a).split(".").map(Number), pb = String(b).split(".").map(Number);
-  for (let i = 0; i < 3; i++) { const d = (pa[i] || 0) - (pb[i] || 0); if (d) return d < 0 ? -1 : 1; }
-  return 0;
-}
-function checkCliVersion() {
-  return new Promise((resolve) => {
-    try {
-      const current = require("./package.json").version;
-      const req = require("https").get("https://registry.npmjs.org/qatools-cli/latest", { timeout: 3000 }, (res) => {
-        let body = "";
-        res.on("data", (c) => (body += c));
-        res.on("end", () => {
-          try {
-            const latest = JSON.parse(body).version;
-            if (latest && cmpVersion(current, latest) < 0) {
-              console.log(`\n⚠ A newer qatools-cli is available: ${current} → ${latest}`);
-              console.log(`  Upgrade so commands, skills and rules are current: npm i -g qatools-cli@latest\n`);
-            }
-          } catch { /* malformed response — skip */ }
-          resolve();
-        });
-      });
-      req.on("error", () => resolve());
-      req.on("timeout", () => { req.destroy(); resolve(); });
-    } catch { resolve(); }
-  });
-}
-
 program
   .command("sync")
   .description("Sync App Context from qa-tools into a CLAUDE.md block")
@@ -780,7 +819,6 @@ program
   .option("-e, --email <email>", "Login email")
   .option("-p, --password <password>", "Login password")
   .action(async (options) => {
-    await checkCliVersion();
     await authenticate(options);
     const creds = getCredentials();
     const projectId = options.project || creds?.projectId;
@@ -2091,6 +2129,7 @@ qatools backlog-tags                 # List existing tags (MUST check before tag
 qatools backlog-create -d "..." -t bug --requirement-key <key> --assigned <email> --developer <email> --sprint <id> --tags tag1,tag2
 qatools backlog-update -i <id> --status resolved --sprint <id> --priority 1 --requirement-key <key> --developer <email> --tags tag1,tag2
 qatools notify --to <email> --subject "..." --message "..."   # email a project member directly (e.g. "ready to test"); respects their opt-out
+qatools member-add --member <email>   # add a member to the project (sends them an invite email)
 qatools backlog-duplicates --local   # Output for local AI analysis (no API key needed)
 qatools backlog-duplicates           # AI-powered duplicate detection (requires API key)
 
@@ -2587,6 +2626,7 @@ export QATOOLS_API_KEY=${apiKey || "<din-nyckel>"}
 - \`qatools backlog-create -d "..." -t bug\` — create backlog item
 - \`qatools backlog-update -i <id> --status resolved --evidence "..."\` — mark resolved (evidence required)
 - \`qatools notify --to <email> --subject "..." --message "..."\` — email a project member directly (respects opt-out)
+- \`qatools member-add --member <email>\` — add a member to the project (sends an invite email)
 - \`qatools access show\` — view access model
 
 ### Skills