qatools-cli 1.1.7 → 1.1.9

package/package.json

@@ -1,9 +1,13 @@
 {
   "name": "qatools-cli",
-  "version": "1.1.7",
+  "version": "1.1.9",
   "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",
+    "release:minor": "npm version minor --no-git-tag-version && npm publish"
+  },
   "bin": {
-    "qatools": "./qatools.js"
+    "qatools": "qatools.js"
   },
   "files": [
     "qatools.js"

package/qatools.js

@@ -465,6 +465,7 @@ program
   .option("--parent <label>", "Parent item label (e.g. BUG-5)")
   .option("--requirement-key <key>", "Requirement key (e.g. auth.login)")
   .option("--tags <tags>", "Tags (comma-separated)")
+  .option("--notify", "Enable email notifications on this item (default off)")
   .option("-e, --email <email>", "Login email")
   .option("-p, --password <password>", "Login password")
   .action(async (options) => {
@@ -486,6 +487,7 @@ program
         parentId: options.parent || "",
         requirementKey: options.requirementKey || "",
         tags: options.tags ? options.tags.split(",").map(t => t.trim().toLowerCase()) : [],
+        mailNotify: !!options.notify,
       });
       console.log(`Created: ${result.data.type.toUpperCase()}-${result.data.bugNumber} (${result.data.id})`);
       if (options.tags) console.log(`  Tags: ${options.tags}`);
@@ -496,6 +498,33 @@ program
     process.exit(0);
   });
 
+program
+  .command("notify")
+  .description("Send a deliberate notification email to a project member (respects their opt-out)")
+  .requiredOption("--to <email>", "Recipient (must be a member of the project)")
+  .requiredOption("--subject <text>", "Email subject")
+  .requiredOption("--message <text>", "Email body (plain text)")
+  .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 notify = httpsCallable(functions, "notifyUser");
+    try {
+      const result = await notify({ projectId, to: options.to, subject: options.subject, message: options.message });
+      if (result.data.skipped) console.log(`Skipped ${options.to}: ${result.data.reason}`);
+      else console.log(`Sent to ${result.data.to}`);
+    } catch (e) {
+      console.error("Failed:", e.message);
+      process.exit(1);
+    }
+    process.exit(0);
+  });
+
 program
   .command("templates")
   .description("List templates and their review status")
@@ -1290,6 +1319,7 @@ program
   .option("--requirement-key <key>", "Set requirement key")
   .option("--tags <tags>", "Set tags (comma-separated, replaces existing)")
   .option("--description <text>", "Update description")
+  .option("--notify <on|off>", "Turn item email notifications on/off")
   .option("--author <name>", "Author name for comments (default: your email)", "Claude")
   .option("--skip-test-verification", "Allow setting status=resolved without going through ready_for_test (use only when no test applies). Evidence is still required.")
   .option("--project <id>", "Target project ID (overrides default; needed for status pre-check)")
@@ -1317,6 +1347,7 @@ program
       if (options.requirementKey) u.requirementKey = options.requirementKey;
       if (options.tags) u.tags = options.tags.split(",").map(t => t.trim().toLowerCase());
       if (options.description) u.description = options.description;
+      if (options.notify) u.mailNotify = options.notify === 'on';
       updates[options.id] = u;
     } else {
       console.error("Provide --file or --id");
@@ -2028,6 +2059,7 @@ qatools backlog
 qatools backlog-tags                 # List existing tags (MUST check before tagging)
 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 backlog-duplicates --local   # Output for local AI analysis (no API key needed)
 qatools backlog-duplicates           # AI-powered duplicate detection (requires API key)
 
@@ -2523,6 +2555,7 @@ export QATOOLS_API_KEY=${apiKey || "<din-nyckel>"}
 - \`qatools template-upload -f file.json\` — upload test template
 - \`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 access show\` — view access model
 
 ### Skills