@pbhamri/quartermaster-mcp 0.6.0 → 0.7.0

package/bin/server.js

@@ -764,6 +764,134 @@ function qmAutoreplyDrafts({ limit = 10 } = {}) {
 }
 
 
+// ---------------- v0.6.1 adoption tracking ----------------
+// Opt-in: peers call qm_report_adoption to send anonymous usage summary
+// to the Quartermaster repo as a GitHub issue. No PII — only machine hash,
+// event counts, and version. Requires `gh` CLI on PATH.
+
+const ADOPTION_PING_FILE = path.join(os.homedir(), ".quartermaster", ".adoption-ping");
+
+function hasReportedThisVersion() {
+  try {
+    if (!exists(ADOPTION_PING_FILE)) return false;
+    const data = readJson(ADOPTION_PING_FILE);
+    return data.version === PKG.version;
+  } catch { return false; }
+}
+
+function markReported() {
+  writeText(ADOPTION_PING_FILE, JSON.stringify({
+    version: PKG.version, machine: machineId(), ts: new Date().toISOString(),
+  }));
+}
+
+function qmReportAdoption({ dryRun = false } = {}) {
+  // Collect anonymous local stats
+  const machine = machineId();
+  const stats = { machine, version: PKG.version, os: os.platform(), arch: os.arch() };
+
+  // Read local telemetry
+  if (exists(METRICS_FILE)) {
+    const lines = fs.readFileSync(METRICS_FILE, "utf8").split("\n").filter(Boolean);
+    const mcpEvents = [];
+    for (const l of lines) { try { const e = JSON.parse(l); if (e.source === "quartermaster-mcp") mcpEvents.push(e); } catch {} }
+    const typeCounts = {};
+    for (const e of mcpEvents) typeCounts[e.type] = (typeCounts[e.type] || 0) + 1;
+    stats.total_events = mcpEvents.length;
+    stats.event_types = typeCounts;
+    stats.first_event = mcpEvents[0]?.ts || null;
+    stats.last_event = mcpEvents[mcpEvents.length - 1]?.ts || null;
+  } else {
+    stats.total_events = 0;
+    stats.event_types = {};
+  }
+
+  // Check what profile is active
+  const profilePath = path.join(os.homedir(), ".copilot", "paved-path", "profile.json");
+  if (exists(profilePath)) {
+    try {
+      const p = readJson(profilePath);
+      stats.active_profile = p.profile?.id || "unknown";
+    } catch { stats.active_profile = "unreadable"; }
+  } else {
+    stats.active_profile = "none";
+  }
+
+  // Check connect-db exists
+  stats.has_connect_db = exists(QM_CONNECT_DB);
+
+  // Already reported this version?
+  stats.already_reported = hasReportedThisVersion();
+
+  if (dryRun) {
+    return { mode: "dry-run", stats, note: "Call with dryRun=false to submit." };
+  }
+
+  // Submit as a GitHub issue (anonymous — titled by machine hash only)
+  let ghAvailable = false;
+  try { execFileSync("gh", ["--version"], { stdio: "pipe" }); ghAvailable = true; } catch {}
+
+  if (!ghAvailable) {
+    return {
+      mode: "manual",
+      stats,
+      note: "gh CLI not found. Share this JSON with the Quartermaster maintainer manually or install gh CLI.",
+    };
+  }
+
+  const title = `[adoption] ${machine} v${PKG.version}`;
+  const body = [
+    "## Anonymous adoption ping",
+    "",
+    "| Field | Value |",
+    "|---|---|",
+    `| Machine hash | \`${machine}\` |`,
+    `| Version | ${PKG.version} |`,
+    `| OS | ${stats.os}/${stats.arch} |`,
+    `| Active profile | ${stats.active_profile} |`,
+    `| Has connect-db | ${stats.has_connect_db} |`,
+    `| Total MCP events | ${stats.total_events} |`,
+    `| First event | ${stats.first_event || "n/a"} |`,
+    `| Last event | ${stats.last_event || "n/a"} |`,
+    "",
+    "### Event breakdown",
+    "",
+    "| Type | Count |",
+    "|---|---|",
+    ...Object.entries(stats.event_types).sort((a,b) => b[1] - a[1]).map(([t,c]) => `| ${t} | ${c} |`),
+    "",
+    "> Auto-generated by `qm_report_adoption`. No PII — machine hash is SHA-256 of platform:arch:cpus:ram.",
+  ].join("\n");
+
+  try {
+    const issueUrl = execFileSync("gh", [
+      "issue", "create",
+      "--repo", "pbhamri_microsoft/Quartermaster",
+      "--title", title,
+      "--body", body,
+      "--label", "adoption-ping",
+    ], { stdio: "pipe" }).toString().trim();
+
+    markReported();
+    emit("qm.report_adoption", { machine });
+
+    return {
+      mode: "submitted",
+      issue_url: issueUrl,
+      stats,
+      note: "Adoption ping submitted as a GitHub issue. Thank you!",
+    };
+  } catch (e) {
+    return {
+      mode: "error",
+      error: e.message,
+      stats,
+      note: "Could not create issue. You may not have access to the repo. Share the stats JSON manually.",
+    };
+  }
+}
+
+
 // ---------------- MCP wiring ----------------
 const server = new Server(
   { name: "quartermaster-mcp", version: PKG.version },
@@ -833,6 +961,8 @@ const TOOLS = [
     inputSchema: { type: "object", properties: {} } },
   { name: "qm_autoreply_drafts", description: "List the most recent auto-reply drafts written under ~/.copilot/autoreply/drafts (with tier, violations, inbound text).",
     inputSchema: { type: "object", properties: { limit: { type: "integer", default: 10 } } } },
+  { name: "qm_report_adoption", description: "Opt-in: send an anonymous adoption ping (machine hash + event counts + version) to the Quartermaster repo as a GitHub issue. No PII. Supports dryRun=true to preview before submitting.",
+    inputSchema: { type: "object", properties: { dryRun: { type: "boolean", default: false, description: "Preview stats without submitting" } } } },
 ];
 
 server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
@@ -862,6 +992,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
       case "qm_autoreply_set_presence":  result = await timed("qm.autoreply_set_presence",  { state: args.state }, async () => qmAutoreplySetPresence(args)); break;
       case "qm_autoreply_failure_modes": result = qmAutoreplyFailureModes(); break;
       case "qm_autoreply_drafts":        result = qmAutoreplyDrafts(args); break;
+      case "qm_report_adoption":        result = qmReportAdoption(args); break;
       default: throw new Error(`unknown tool: ${name}`);
     }
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pbhamri/quartermaster-mcp",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "MCP server that seeds any repo with a customizable PM kit. Any PM, any product — connect YOUR GitHub, ADO, Kusto, IcM. 19 tools: scaffolding, repo-read, onboarding, custom profile creation, self-agent auto-reply. Never ships personal data — profiles are templates you fill in.",
   "type": "module",
   "bin": {
@@ -26,7 +26,13 @@
   "engines": {
     "node": ">=18"
   },
-  "keywords": ["mcp", "pm", "purview", "quartermaster", "copilot"],
+  "keywords": [
+    "mcp",
+    "pm",
+    "purview",
+    "quartermaster",
+    "copilot"
+  ],
   "author": "pbhamri",
   "license": "MIT"
 }