@powerhousedao/shared 6.0.2-staging.5 → 6.0.2-staging.7

package/dist/clis/services/telemetry.d.mts

@@ -0,0 +1,57 @@
+//#region clis/services/telemetry.d.ts
+type CliInvocationInfo = {
+  command?: string;
+  subcommand?: string;
+  pm?: string;
+  argv: string[];
+  cwd?: string;
+};
+type TelemetryClient = {
+  /**
+   * Attaches per-invocation context (command, sanitized argv, package
+   * manager) as Sentry tags + a `invocation` context block, plus a single
+   * "cli invoked" breadcrumb. Safe to call once per process.
+   */
+  attachInvocationContext: (info: CliInvocationInfo) => void;
+  /**
+   * Captures an error (if telemetry is initialized) and flushes before the
+   * caller calls process.exit(). Safe no-op when telemetry is disabled.
+   */
+  captureCliError: (err: unknown, opts?: {
+    kind?: "crash" | "user";
+  }) => Promise<void>;
+};
+/**
+ * Prompts the user once, caches the answer. Must be called before init.
+ * Returns `true` if telemetry should be enabled, `false` otherwise.
+ */
+declare function resolveTelemetryConsent(): Promise<boolean>;
+/**
+ * Initializes Sentry for CLI error reporting if telemetry is enabled.
+ * Safe to call multiple times; only the first call takes effect.
+ */
+declare function initCliTelemetry(opts: {
+  cliName: "ph-cli" | "ph-cmd";
+  release?: string;
+}): Promise<TelemetryClient | undefined>;
+/**
+ * Explicitly set telemetry consent (used by `ph telemetry on|off`).
+ */
+declare function setTelemetryConsent(enabled: boolean): void;
+/**
+ * Returns the current telemetry state — useful for `ph telemetry status`.
+ */
+declare function getTelemetryStatus(): {
+  source: "env";
+  enabled: boolean;
+} | {
+  source: "config";
+  enabled: boolean;
+  askedAt: string;
+} | {
+  source: "default";
+  enabled: false;
+};
+//#endregion
+export { CliInvocationInfo, TelemetryClient, getTelemetryStatus, initCliTelemetry, resolveTelemetryConsent, setTelemetryConsent };
+//# sourceMappingURL=telemetry.d.mts.map

package/dist/clis/services/telemetry.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.mts","names":[],"sources":["../../../clis/services/telemetry.ts"],"mappings":";KAmCY,iBAAA;EACV,OAAA;EACA,UAAA;EACA,EAAA;EACA,IAAA;EACA,GAAA;AAAA;AAAA,KAGU,eAAA;EAJV;;;;AAIF;EAME,uBAAA,GAA0B,IAAA,EAAM,iBAAA;;;;;EAKhC,eAAA,GACE,GAAA,WACA,IAAA;IAAS,IAAA;EAAA,MACN,OAAA;AAAA;;;;;iBA8Ce,uBAAA,CAAA,GAA2B,OAAA;;;;;iBAgH3B,gBAAA,CAAiB,IAAA;EACrC,OAAA;EACA,OAAA;AAAA,IACE,OAAA,CAAQ,eAAA;;;;iBAgGI,mBAAA,CAAoB,OAAA;;;;iBAOpB,kBAAA,CAAA;EACV,MAAA;EAAe,OAAA;AAAA;EACf,MAAA;EAAkB,OAAA;EAAkB,OAAA;AAAA;EACpC,MAAA;EAAmB,OAAA;AAAA"}

package/dist/clis/services/telemetry.mjs

@@ -0,0 +1,221 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+//#region clis/services/telemetry.ts
+/**
+* CLI telemetry (error reporting via Sentry).
+*
+* Design:
+* - Opt-out by default, asked once on first interactive run.
+* - Stores consent in ~/.ph/telemetry.json so we never ask twice.
+* - Respects PH_NO_TELEMETRY=1 and DO_NOT_TRACK=1 as immediate kill switches.
+* - Non-interactive (TTY missing, CI, piped) defaults to DISABLED — we don't
+*   want to hang a CI pipeline on an unanswered prompt, and we don't want to
+*   capture errors without informed consent.
+* - DSN is published in the CLI binary; Sentry DSNs accept events but grant
+*   no read access, so this is safe. Hardcoded so users can't accidentally
+*   misroute events.
+*
+* PII scrubbing in beforeSend hook:
+* - Home-directory paths collapsed to ~
+* - Flag/arg values that look like secrets (tokens, keys) stripped
+* - No source-context from user files
+*/
+const SENTRY_DSN = "https://0e7793802288589b4923896118374462@sentry.monitoring.vetra.io/3";
+const TELEMETRY_FILE = join(homedir(), ".ph", "telemetry.json");
+function isExplicitlyDisabled() {
+	return process.env.PH_NO_TELEMETRY === "1" || process.env.PH_NO_TELEMETRY === "true" || process.env.DO_NOT_TRACK === "1" || process.env.DO_NOT_TRACK === "true";
+}
+function isExplicitlyEnabled() {
+	return process.env.PH_TELEMETRY === "1" || process.env.PH_TELEMETRY === "true";
+}
+function isInteractive() {
+	return Boolean(process.stdin.isTTY) && !process.env.CI;
+}
+function readConfig() {
+	try {
+		if (!existsSync(TELEMETRY_FILE)) return null;
+		return JSON.parse(readFileSync(TELEMETRY_FILE, "utf8"));
+	} catch {
+		return null;
+	}
+}
+function writeConfig(cfg) {
+	try {
+		mkdirSync(join(homedir(), ".ph"), { recursive: true });
+		writeFileSync(TELEMETRY_FILE, JSON.stringify(cfg, null, 2));
+	} catch {}
+}
+/**
+* Prompts the user once, caches the answer. Must be called before init.
+* Returns `true` if telemetry should be enabled, `false` otherwise.
+*/
+async function resolveTelemetryConsent() {
+	if (isExplicitlyDisabled()) return false;
+	if (isExplicitlyEnabled()) return true;
+	const cached = readConfig();
+	if (cached) return cached.enabled;
+	if (!isInteractive()) return false;
+	const enquirer = await import("enquirer");
+	try {
+		const { enabled } = await enquirer.default.prompt({
+			type: "confirm",
+			name: "enabled",
+			message: "Help improve Powerhouse by sending anonymous error reports? (stack traces only, paths and secrets are scrubbed)",
+			initial: true
+		});
+		writeConfig({
+			enabled,
+			askedAt: (/* @__PURE__ */ new Date()).toISOString()
+		});
+		return enabled;
+	} catch {
+		return false;
+	}
+}
+function scrubString(input) {
+	if (!input) return input;
+	const home = homedir();
+	let out = input;
+	if (home && out.includes(home)) out = out.split(home).join("~");
+	out = out.replace(/(--?(?:token|api[-_]?key|password|secret|auth)[=\s])([^\s]+)/gi, "$1<redacted>");
+	return out;
+}
+function scrubEvent(event) {
+	const e = event;
+	try {
+		if (e.message) e.message = scrubString(e.message);
+		if (e.logentry?.message) e.logentry.message = scrubString(e.logentry.message);
+		const values = e.exception?.values;
+		if (Array.isArray(values)) for (const ex of values) {
+			if (ex.value) ex.value = scrubString(ex.value);
+			const frames = ex.stacktrace?.frames;
+			if (Array.isArray(frames)) for (const f of frames) {
+				if (f.filename) f.filename = scrubString(f.filename);
+				if (f.abs_path) f.abs_path = scrubString(f.abs_path);
+				delete f.pre_context;
+				delete f.context_line;
+				delete f.post_context;
+				delete f.vars;
+			}
+		}
+		delete e.server_name;
+		if (e.extra) {
+			delete e.extra.argv;
+			delete e.extra.env;
+		}
+	} catch {}
+	return event;
+}
+/**
+* Initializes Sentry for CLI error reporting if telemetry is enabled.
+* Safe to call multiple times; only the first call takes effect.
+*/
+async function initCliTelemetry(opts) {
+	if (!await resolveTelemetryConsent()) return;
+	const Sentry = await import("@sentry/node-core/light");
+	const os = await import("node:os");
+	const sentryClient = Sentry.init({
+		dsn: SENTRY_DSN,
+		release: opts.release,
+		environment: process.env.NODE_ENV || "production",
+		sendDefaultPii: false,
+		defaultIntegrations: false,
+		integrations: [],
+		beforeSend(event) {
+			return scrubEvent(event);
+		},
+		beforeBreadcrumb(breadcrumb) {
+			if (breadcrumb.message) breadcrumb.message = scrubString(breadcrumb.message);
+			return breadcrumb;
+		}
+	});
+	Sentry.setTag("cli_name", opts.cliName);
+	if (opts.release) Sentry.setTag("cli_version", opts.release);
+	Sentry.setTag("os", process.platform);
+	Sentry.setTag("arch", process.arch);
+	Sentry.setTag("node_version", process.version);
+	Sentry.setTag("ci", String(Boolean(process.env.CI)));
+	Sentry.setTag("tty", String(Boolean(process.stdin.isTTY)));
+	Sentry.setContext("runtime", {
+		name: "node",
+		version: process.version
+	});
+	Sentry.setContext("os", {
+		name: process.platform,
+		version: os.release()
+	});
+	Sentry.setContext("device", { arch: process.arch });
+	if (!sentryClient) return;
+	return {
+		attachInvocationContext(info) {
+			const argv = info.argv.map(scrubString);
+			const flagNames = info.argv.filter((a) => a.startsWith("-")).map((a) => a.split("=")[0]);
+			if (info.command) Sentry.setTag("command", info.command);
+			if (info.subcommand) Sentry.setTag("subcommand", info.subcommand);
+			if (info.pm) Sentry.setTag("pm", info.pm);
+			Sentry.setContext("invocation", {
+				command: info.command,
+				subcommand: info.subcommand,
+				argv,
+				flag_names: flagNames,
+				argv_count: argv.length,
+				cwd: info.cwd ? scrubString(info.cwd) : void 0
+			});
+			Sentry.addBreadcrumb({
+				category: "cli",
+				level: "info",
+				message: "cli invoked",
+				data: {
+					command: info.command,
+					pm: info.pm,
+					tty: Boolean(process.stdin.isTTY),
+					ci: Boolean(process.env.CI)
+				}
+			});
+		},
+		captureCliError: async (err, captureOpts) => {
+			try {
+				Sentry.setTag("error_kind", captureOpts?.kind ?? "crash");
+				sentryClient.captureException(err);
+				await sentryClient.flush(2e3);
+			} catch {}
+		}
+	};
+}
+/**
+* Explicitly set telemetry consent (used by `ph telemetry on|off`).
+*/
+function setTelemetryConsent(enabled) {
+	writeConfig({
+		enabled,
+		askedAt: (/* @__PURE__ */ new Date()).toISOString()
+	});
+}
+/**
+* Returns the current telemetry state — useful for `ph telemetry status`.
+*/
+function getTelemetryStatus() {
+	if (isExplicitlyDisabled()) return {
+		source: "env",
+		enabled: false
+	};
+	if (isExplicitlyEnabled()) return {
+		source: "env",
+		enabled: true
+	};
+	const cached = readConfig();
+	if (cached) return {
+		source: "config",
+		enabled: cached.enabled,
+		askedAt: cached.askedAt
+	};
+	return {
+		source: "default",
+		enabled: false
+	};
+}
+//#endregion
+export { getTelemetryStatus, initCliTelemetry, resolveTelemetryConsent, setTelemetryConsent };
+
+//# sourceMappingURL=telemetry.mjs.map

package/dist/clis/services/telemetry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.mjs","names":[],"sources":["../../../clis/services/telemetry.ts"],"sourcesContent":["/**\n * CLI telemetry (error reporting via Sentry).\n *\n * Design:\n * - Opt-out by default, asked once on first interactive run.\n * - Stores consent in ~/.ph/telemetry.json so we never ask twice.\n * - Respects PH_NO_TELEMETRY=1 and DO_NOT_TRACK=1 as immediate kill switches.\n * - Non-interactive (TTY missing, CI, piped) defaults to DISABLED — we don't\n *   want to hang a CI pipeline on an unanswered prompt, and we don't want to\n *   capture errors without informed consent.\n * - DSN is published in the CLI binary; Sentry DSNs accept events but grant\n *   no read access, so this is safe. Hardcoded so users can't accidentally\n *   misroute events.\n *\n * PII scrubbing in beforeSend hook:\n * - Home-directory paths collapsed to ~\n * - Flag/arg values that look like secrets (tokens, keys) stripped\n * - No source-context from user files\n */\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\n\n// Sentry project \"ph-cli\" on the powerhouse-hosted Sentry instance.\n// Public DSNs are safe to ship — they grant write-only ingest access.\nconst SENTRY_DSN =\n  \"https://0e7793802288589b4923896118374462@sentry.monitoring.vetra.io/3\";\n\nconst TELEMETRY_FILE = join(homedir(), \".ph\", \"telemetry.json\");\n\ntype TelemetryConfig = {\n  enabled: boolean;\n  askedAt: string;\n};\n\nexport type CliInvocationInfo = {\n  command?: string;\n  subcommand?: string;\n  pm?: string;\n  argv: string[];\n  cwd?: string;\n};\n\nexport type TelemetryClient = {\n  /**\n   * Attaches per-invocation context (command, sanitized argv, package\n   * manager) as Sentry tags + a `invocation` context block, plus a single\n   * \"cli invoked\" breadcrumb. Safe to call once per process.\n   */\n  attachInvocationContext: (info: CliInvocationInfo) => void;\n  /**\n   * Captures an error (if telemetry is initialized) and flushes before the\n   * caller calls process.exit(). Safe no-op when telemetry is disabled.\n   */\n  captureCliError: (\n    err: unknown,\n    opts?: { kind?: \"crash\" | \"user\" },\n  ) => Promise<void>;\n};\n\nfunction isExplicitlyDisabled(): boolean {\n  // Standard opt-out signals respected by most OSS CLIs.\n  return (\n    process.env.PH_NO_TELEMETRY === \"1\" ||\n    process.env.PH_NO_TELEMETRY === \"true\" ||\n    process.env.DO_NOT_TRACK === \"1\" ||\n    process.env.DO_NOT_TRACK === \"true\"\n  );\n}\n\nfunction isExplicitlyEnabled(): boolean {\n  return (\n    process.env.PH_TELEMETRY === \"1\" || process.env.PH_TELEMETRY === \"true\"\n  );\n}\n\nfunction isInteractive(): boolean {\n  // Only ask if stdin is a TTY and CI env isn't set.\n  return Boolean(process.stdin.isTTY) && !process.env.CI;\n}\n\nfunction readConfig(): TelemetryConfig | null {\n  try {\n    if (!existsSync(TELEMETRY_FILE)) return null;\n    return JSON.parse(readFileSync(TELEMETRY_FILE, \"utf8\")) as TelemetryConfig;\n  } catch {\n    return null;\n  }\n}\n\nfunction writeConfig(cfg: TelemetryConfig): void {\n  try {\n    mkdirSync(join(homedir(), \".ph\"), { recursive: true });\n    writeFileSync(TELEMETRY_FILE, JSON.stringify(cfg, null, 2));\n  } catch {\n    // non-fatal; we'll just ask again next time\n  }\n}\n\n/**\n * Prompts the user once, caches the answer. Must be called before init.\n * Returns `true` if telemetry should be enabled, `false` otherwise.\n */\nexport async function resolveTelemetryConsent(): Promise<boolean> {\n  if (isExplicitlyDisabled()) return false;\n  if (isExplicitlyEnabled()) return true;\n\n  const cached = readConfig();\n  if (cached) return cached.enabled;\n\n  if (!isInteractive()) {\n    // Non-interactive first run: stay silent, don't ask, don't send. User can\n    // opt in later with `ph telemetry on` or PH_TELEMETRY=1.\n    return false;\n  }\n\n  const enquirer = await import(\"enquirer\");\n  try {\n    const { enabled } = await enquirer.default.prompt<{ enabled: boolean }>({\n      type: \"confirm\",\n      name: \"enabled\",\n      message:\n        \"Help improve Powerhouse by sending anonymous error reports? \" +\n        \"(stack traces only, paths and secrets are scrubbed)\",\n      initial: true,\n    });\n    writeConfig({ enabled, askedAt: new Date().toISOString() });\n    return enabled;\n  } catch {\n    // user hit Ctrl-C during prompt — treat as no, but don't persist so we\n    // ask again next time\n    return false;\n  }\n}\n\nfunction scrubString(input: string): string {\n  if (!input) return input;\n  const home = homedir();\n  let out = input;\n  // Collapse home dir to ~\n  if (home && out.includes(home)) {\n    out = out.split(home).join(\"~\");\n  }\n  // Strip common secret-shaped flag values: --token=XYZ, --api-key XYZ, etc.\n  out = out.replace(\n    /(--?(?:token|api[-_]?key|password|secret|auth)[=\\s])([^\\s]+)/gi,\n    \"$1<redacted>\",\n  );\n  return out;\n}\n\ntype ScrubbableFrame = {\n  filename?: string;\n  abs_path?: string;\n  pre_context?: unknown;\n  context_line?: unknown;\n  post_context?: unknown;\n  vars?: unknown;\n};\n\ntype ScrubbableException = {\n  value?: string;\n  stacktrace?: { frames?: ScrubbableFrame[] };\n};\n\ntype ScrubbableEvent = {\n  message?: string;\n  logentry?: { message?: string };\n  exception?: { values?: ScrubbableException[] };\n  server_name?: string;\n  extra?: Record<string, unknown>;\n};\n\nfunction scrubEvent<T>(event: T): T {\n  const e = event as ScrubbableEvent;\n  try {\n    if (e.message) e.message = scrubString(e.message);\n    if (e.logentry?.message) {\n      e.logentry.message = scrubString(e.logentry.message);\n    }\n    const values = e.exception?.values;\n    if (Array.isArray(values)) {\n      for (const ex of values) {\n        if (ex.value) ex.value = scrubString(ex.value);\n        const frames = ex.stacktrace?.frames;\n        if (Array.isArray(frames)) {\n          for (const f of frames) {\n            if (f.filename) f.filename = scrubString(f.filename);\n            if (f.abs_path) f.abs_path = scrubString(f.abs_path);\n            // Drop captured source context from user machines — privacy.\n            delete f.pre_context;\n            delete f.context_line;\n            delete f.post_context;\n            delete f.vars;\n          }\n        }\n      }\n    }\n    // Server name can leak the user's machine hostname; drop it.\n    delete e.server_name;\n    // Strip raw argv from extra context.\n    if (e.extra) {\n      delete e.extra.argv;\n      delete e.extra.env;\n    }\n  } catch {\n    // Never let scrubbing throw — worst case we drop the event below.\n  }\n  return event;\n}\n\n/**\n * Initializes Sentry for CLI error reporting if telemetry is enabled.\n * Safe to call multiple times; only the first call takes effect.\n */\nexport async function initCliTelemetry(opts: {\n  cliName: \"ph-cli\" | \"ph-cmd\";\n  release?: string;\n}): Promise<TelemetryClient | undefined> {\n  const enabled = await resolveTelemetryConsent();\n  if (!enabled) return;\n\n  const Sentry = await import(\"@sentry/node-core/light\");\n  const os = await import(\"node:os\");\n  const sentryClient = Sentry.init({\n    dsn: SENTRY_DSN,\n    release: opts.release,\n    environment: process.env.NODE_ENV || \"production\",\n    sendDefaultPii: false,\n    defaultIntegrations: false,\n    integrations: [\n      // Only the bare minimum — no automatic HTTP/FS instrumentation.\n    ],\n    beforeSend(event) {\n      return scrubEvent(event);\n    },\n    beforeBreadcrumb(breadcrumb) {\n      if (breadcrumb.message) {\n        breadcrumb.message = scrubString(breadcrumb.message);\n      }\n      return breadcrumb;\n    },\n  });\n  Sentry.setTag(\"cli_name\", opts.cliName);\n  if (opts.release) Sentry.setTag(\"cli_version\", opts.release);\n  // Environment tags — `defaultIntegrations: false` strips Sentry's auto\n  // node-context, so attach the bits we care about manually (and keep\n  // hostname out of it).\n  Sentry.setTag(\"os\", process.platform);\n  Sentry.setTag(\"arch\", process.arch);\n  Sentry.setTag(\"node_version\", process.version);\n  Sentry.setTag(\"ci\", String(Boolean(process.env.CI)));\n  Sentry.setTag(\"tty\", String(Boolean(process.stdin.isTTY)));\n  Sentry.setContext(\"runtime\", {\n    name: \"node\",\n    version: process.version,\n  });\n  Sentry.setContext(\"os\", {\n    name: process.platform,\n    version: os.release(),\n  });\n  Sentry.setContext(\"device\", {\n    arch: process.arch,\n  });\n  if (!sentryClient) {\n    return;\n  }\n  return {\n    attachInvocationContext(info: CliInvocationInfo) {\n      const argv = info.argv.map(scrubString);\n      const flagNames = info.argv\n        .filter((a) => a.startsWith(\"-\"))\n        .map((a) => a.split(\"=\")[0]);\n      if (info.command) Sentry.setTag(\"command\", info.command);\n      if (info.subcommand) Sentry.setTag(\"subcommand\", info.subcommand);\n      if (info.pm) Sentry.setTag(\"pm\", info.pm);\n      Sentry.setContext(\"invocation\", {\n        command: info.command,\n        subcommand: info.subcommand,\n        argv,\n        flag_names: flagNames,\n        argv_count: argv.length,\n        cwd: info.cwd ? scrubString(info.cwd) : undefined,\n      });\n      Sentry.addBreadcrumb({\n        category: \"cli\",\n        level: \"info\",\n        message: \"cli invoked\",\n        data: {\n          command: info.command,\n          pm: info.pm,\n          tty: Boolean(process.stdin.isTTY),\n          ci: Boolean(process.env.CI),\n        },\n      });\n    },\n    captureCliError: async (\n      err: unknown,\n      captureOpts?: { kind?: \"crash\" | \"user\" },\n    ) => {\n      try {\n        Sentry.setTag(\"error_kind\", captureOpts?.kind ?? \"crash\");\n        sentryClient.captureException(err);\n        await sentryClient.flush(2000);\n      } catch {\n        // Reporting must never mask the real error.\n      }\n    },\n  };\n}\n\n/**\n * Explicitly set telemetry consent (used by `ph telemetry on|off`).\n */\nexport function setTelemetryConsent(enabled: boolean): void {\n  writeConfig({ enabled, askedAt: new Date().toISOString() });\n}\n\n/**\n * Returns the current telemetry state — useful for `ph telemetry status`.\n */\nexport function getTelemetryStatus():\n  | { source: \"env\"; enabled: boolean }\n  | { source: \"config\"; enabled: boolean; askedAt: string }\n  | { source: \"default\"; enabled: false } {\n  if (isExplicitlyDisabled()) return { source: \"env\", enabled: false };\n  if (isExplicitlyEnabled()) return { source: \"env\", enabled: true };\n  const cached = readConfig();\n  if (cached)\n    return {\n      source: \"config\",\n      enabled: cached.enabled,\n      askedAt: cached.askedAt,\n    };\n  return { source: \"default\", enabled: false };\n}\n"],"mappings":"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"}

package/dist/clis/utils.d.mts

@@ -0,0 +1,9 @@
+//#region clis/utils.d.ts
+declare class NodeVersionError extends Error {
+  constructor(currentVersion: string, minimumVersion: string);
+  static isError(error: unknown): error is NodeVersionError;
+}
+declare function assertNodeVersion(nodeVersion?: string): void;
+//#endregion
+export { NodeVersionError, assertNodeVersion };
+//# sourceMappingURL=utils.d.mts.map

package/dist/clis/utils.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.mts","names":[],"sources":["../../clis/utils.ts"],"mappings":";cAIa,gBAAA,SAAyB,KAAA;cACxB,cAAA,UAAwB,cAAA;EAAA,OAO7B,OAAA,CAAQ,KAAA,YAAiB,KAAA,IAAS,gBAAA;AAAA;AAAA,iBAK3B,iBAAA,CAAkB,WAAA"}