@dosu/cli 0.53.1 → 0.54.0

package/bin/dosu.js

@@ -5018,7 +5018,7 @@ function isNpxInvocation(channel = INSTALL_CHANNEL, env = process.env) {
 function getVersionString() {
   return `v${VERSION}`;
 }
-var VERSION = "0.53.1", INSTALL_CHANNEL = "npm";
+var VERSION = "0.54.0", INSTALL_CHANNEL = "npm";
 
 // src/debug/logger.ts
 import {
@@ -10727,6 +10727,854 @@ var init_sync = __esm(() => {
   init_watermark();
 });
 
+// src/telemetry/debug-id.ts
+var BUNDLE_DEBUG_ID_PLACEHOLDER = "d4304c43-c40e-f448-6475-6e2164756e21";
+
+// src/telemetry/telemetry.ts
+import { randomUUID as randomUUID2 } from "node:crypto";
+import { existsSync as existsSync13 } from "node:fs";
+import { request as httpRequest2 } from "node:http";
+import { request as httpsRequest } from "node:https";
+import { isAbsolute, relative, resolve as resolve2, sep } from "node:path";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
+function safeString(value, pattern, fallback) {
+  if (typeof value !== "string" || !pattern.test(value))
+    return fallback;
+  return value;
+}
+function canonicalCommand(value) {
+  if (typeof value !== "string")
+    return UNKNOWN_COMMAND;
+  const command = value.trim();
+  if (command.length > 80)
+    return UNKNOWN_COMMAND;
+  if (!/^[a-z][a-z0-9-]*(?: [a-z][a-z0-9-]*){0,3}$/.test(command)) {
+    return UNKNOWN_COMMAND;
+  }
+  return command;
+}
+function normalizeContext(context) {
+  const isAuthenticated2 = context?.isAuthenticated === true;
+  const id = safeRead(context?.user, "id");
+  const email = safeRead(context?.user, "email");
+  const orgId = safeRead(context, "orgId");
+  const user = isAuthenticated2 && isUUID(id) ? { id, ...validEmail(email) ? { email } : {} } : undefined;
+  return {
+    mode: context?.mode === "oss" ? "oss" : "cloud",
+    isAuthenticated: isAuthenticated2,
+    ...user ? { user } : {},
+    ...user && isUUID(orgId) ? { orgId } : {}
+  };
+}
+function normalizeExitCode(value, fallback = 1) {
+  if (typeof value !== "number" || !Number.isFinite(value))
+    return fallback;
+  return Math.min(255, Math.max(0, Math.trunc(value)));
+}
+function normalizeRuntime(runtime) {
+  return {
+    version: safeString(runtime.version, /^[A-Za-z0-9.+_-]{1,32}$/, "unknown"),
+    installChannel: safeString(runtime.installChannel, /^[A-Za-z][A-Za-z0-9_-]{0,31}$/, "unknown"),
+    platform: safeString(runtime.platform, /^[A-Za-z0-9_-]{1,24}$/, "unknown"),
+    arch: safeString(runtime.arch, /^[A-Za-z0-9_-]{1,24}$/, "unknown"),
+    runtime: safeString(runtime.runtime, /^[A-Za-z][A-Za-z0-9_-]{0,23}$/, "unknown"),
+    runtimeMajor: Math.min(9999, Math.max(0, Math.trunc(runtime.runtimeMajor) || 0)),
+    isCi: runtime.isCi === true,
+    isTty: runtime.isTty === true
+  };
+}
+function isUUID(value) {
+  return typeof value === "string" && /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value);
+}
+function validEmail(value) {
+  return typeof value === "string" && value.length <= 254 && /^[A-Za-z0-9.!#$%&'*+/=?^_`{|}~-]+@[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?(?:\.[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?)+$/.test(value);
+}
+function validEventId(value) {
+  return typeof value === "string" && /^[0-9a-f]{32}$/i.test(value);
+}
+function validDebugId(value) {
+  return typeof value === "string" && /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(value);
+}
+function validErrorType(value) {
+  return typeof value === "string" && SAFE_ERROR_TYPES.has(value);
+}
+function validErrorCode(value) {
+  return typeof value === "string" && SAFE_ERROR_CODES.has(value);
+}
+function validStatus(value) {
+  return typeof value === "number" && Number.isInteger(value) && value >= 100 && value <= 599;
+}
+function objectLike(value) {
+  return typeof value === "object" && value !== null || typeof value === "function";
+}
+function safeRead(value, key) {
+  if (!objectLike(value))
+    return;
+  try {
+    return Reflect.get(value, key);
+  } catch {
+    return;
+  }
+}
+function parseStack(stack) {
+  if (typeof stack !== "string" || !CLI_PACKAGE_ROOT)
+    return [];
+  const frames = [];
+  const lines = stack.slice(0, 1e5).split(`
+`, 200);
+  for (const originalLine of lines) {
+    if (frames.length >= MAX_STACK_FRAMES)
+      break;
+    const parsed = parseOwnedStackLine(originalLine, CLI_PACKAGE_ROOT);
+    if (!parsed)
+      continue;
+    const { filename, lineno, colno } = parsed;
+    if (!Number.isSafeInteger(lineno) || !Number.isSafeInteger(colno) || lineno < 1 || colno < 1 || lineno > 1e7 || colno > 1e7) {
+      continue;
+    }
+    frames.push({ filename, lineno, colno, in_app: true });
+  }
+  return frames;
+}
+function detectCliPackageRoot() {
+  try {
+    const modulePath = fileURLToPath2(import.meta.url).replaceAll("\\", "/");
+    for (const suffix of ["/src/telemetry/telemetry.ts", "/bin/dosu.js"]) {
+      if (modulePath.endsWith(suffix))
+        return modulePath.slice(0, -suffix.length);
+    }
+  } catch {}
+  return;
+}
+function parseOwnedStackLine(originalLine, packageRoot) {
+  const line = originalLine.replaceAll("\\", "/");
+  const match = line.match(/^\s*at\s+.*\s+\((.+):(\d+):(\d+)\)\s*$/) ?? line.match(/^\s*at\s+(.+):(\d+):(\d+)\s*$/);
+  if (!match?.[1] || !match[2] || !match[3])
+    return;
+  let absolutePath = match[1];
+  try {
+    if (absolutePath.startsWith("file://"))
+      absolutePath = fileURLToPath2(absolutePath);
+  } catch {
+    return;
+  }
+  if (!isAbsolute(absolutePath))
+    return;
+  const resolvedPath = resolve2(absolutePath);
+  const relativePath = relative(packageRoot, resolvedPath);
+  if (relativePath === "" || relativePath === ".." || relativePath.startsWith(`..${sep}`) || isAbsolute(relativePath)) {
+    return;
+  }
+  const filename = relativePath.replaceAll("\\", "/");
+  if (!/^(?:src\/(?:[A-Za-z0-9_.-]+\/)*[A-Za-z0-9_.-]+\.(?:[cm]?[jt]sx?)|bin\/dosu\.js)$/.test(filename)) {
+    return;
+  }
+  try {
+    if (!existsSync13(resolvedPath))
+      return;
+  } catch {
+    return;
+  }
+  return { filename, lineno: Number(match[2]), colno: Number(match[3]) };
+}
+function sanitizeError(error) {
+  const normalizedError = domainErrorFromCauseChain(error) ?? error;
+  const data = safeRead(normalizedError, "data");
+  const typeCandidate = safeRead(normalizedError, "name");
+  const codeCandidates = [safeRead(data, "code"), safeRead(normalizedError, "code")];
+  const statusCandidates = [
+    safeRead(data, "httpStatus"),
+    safeRead(normalizedError, "status"),
+    safeRead(normalizedError, "statusCode")
+  ];
+  const exitCodeCandidate = safeRead(normalizedError, "exitCode");
+  const code = codeCandidates.find(validErrorCode);
+  const status = statusCandidates.find(validStatus);
+  const exitCode = typeof exitCodeCandidate === "number" && Number.isFinite(exitCodeCandidate) ? normalizeExitCode(exitCodeCandidate) : undefined;
+  return {
+    type: validErrorType(typeCandidate) ? typeCandidate : "Error",
+    ...code ? { code } : {},
+    ...status ? { status } : {},
+    frames: parseStack(safeRead(normalizedError, "stack")),
+    ...exitCode === undefined ? {} : { exitCode }
+  };
+}
+function domainErrorFromCauseChain(error) {
+  const seen = new Set;
+  let current = error;
+  for (let depth = 0;depth < 5 && objectLike(current); depth += 1) {
+    if (seen.has(current))
+      return;
+    seen.add(current);
+    const code = safeRead(current, "code");
+    if (code === "SESSION_EXPIRED" || code === "SESSION_PERSISTENCE_ERROR" || code === "SESSION_REFRESH_ERROR") {
+      return current;
+    }
+    current = safeRead(current, "cause");
+  }
+  return;
+}
+function durationBucket(durationMs) {
+  const duration = Number.isFinite(durationMs) ? Math.max(0, durationMs) : 0;
+  if (duration < 100)
+    return "<100ms";
+  if (duration < 500)
+    return "100-499ms";
+  if (duration < 2000)
+    return "500ms-1.9s";
+  if (duration < 1e4)
+    return "2-9.9s";
+  if (duration < 60000)
+    return "10-59s";
+  return "60s+";
+}
+function countBucket(value) {
+  const n2 = typeof value === "number" && Number.isFinite(value) ? Math.max(0, Math.floor(value)) : 0;
+  if (n2 === 0)
+    return "0";
+  if (n2 < 5)
+    return "1-4";
+  if (n2 < 10)
+    return "5-9";
+  if (n2 < 20)
+    return "10-19";
+  if (n2 < 50)
+    return "20-49";
+  return "50+";
+}
+function recordCommandFacets(facets) {
+  pendingFacets = { ...pendingFacets, ...facets };
+}
+function consumeCommandFacets() {
+  const facets = pendingFacets;
+  pendingFacets = undefined;
+  return facets;
+}
+function allowlisted(value, allowed) {
+  return typeof value === "string" && allowed.has(value) ? value : undefined;
+}
+function sanitizeFacets(facets) {
+  if (!facets || typeof facets !== "object")
+    return {};
+  const trigger = allowlisted(facets.sync_trigger, SYNC_TRIGGERS);
+  const status = allowlisted(facets.sync_status, SYNC_STATUSES);
+  const learner = allowlisted(facets.learner_outcome, LEARNER_OUTCOMES);
+  const backfill = allowlisted(facets.backfill_offer, BACKFILL_OFFERS);
+  return {
+    ...trigger ? { sync_trigger: trigger } : {},
+    ...status ? { sync_status: status } : {},
+    ...facets.sessions_studied !== undefined ? { sessions_studied: countBucket(facets.sessions_studied) } : {},
+    ...facets.notes_written !== undefined ? { notes_written: countBucket(facets.notes_written) } : {},
+    ...learner ? { learner_outcome: learner } : {},
+    ...backfill ? { backfill_offer: backfill } : {}
+  };
+}
+function buildPostHogPayload(input) {
+  const context = normalizeContext(input.context);
+  const runtime = normalizeRuntime(input.runtime);
+  const errorCode = validErrorCode(input.errorCode) ? input.errorCode : undefined;
+  const facets = sanitizeFacets(input.facets);
+  const result = input.result === "success" || input.result === "validation_error" ? input.result : "failure";
+  return {
+    api_key: input.apiKey,
+    distinct_id: context.user?.id ?? (isUUID(input.installId) ? input.installId : FALLBACK_INSTALL_ID),
+    event: "cli_command_completed",
+    properties: {
+      $geoip_disable: true,
+      ...context.user ? {} : { $process_person_profile: false },
+      schema_version: 1,
+      command: canonicalCommand(input.command),
+      result,
+      duration_bucket: durationBucket(input.durationMs),
+      cli_version: runtime.version,
+      install_channel: runtime.installChannel,
+      platform: runtime.platform,
+      arch: runtime.arch,
+      runtime: runtime.runtime,
+      runtime_major: runtime.runtimeMajor,
+      is_ci: runtime.isCi,
+      is_tty: runtime.isTty,
+      mode: context.mode,
+      ...context.orgId ? {
+        org_id: context.orgId,
+        $groups: { organization: context.orgId }
+      } : {},
+      is_authenticated: context.isAuthenticated,
+      exit_code: normalizeExitCode(input.exitCode),
+      ...errorCode ? { error_code: errorCode } : {},
+      ...facets
+    }
+  };
+}
+function parsePostHogProjectToken(value) {
+  if (typeof value !== "string")
+    return null;
+  const token = value.trim();
+  return /^phc_[A-Za-z0-9_-]{3,252}$/.test(token) ? token : null;
+}
+function parseTelemetryWebAppURL(value, allowInsecureLoopback = false) {
+  if (typeof value !== "string" || value.length === 0 || value.length > 2048)
+    return null;
+  try {
+    const url = new URL(value.trim());
+    if (!url.hostname || url.username || url.password || url.search || url.hash)
+      return null;
+    const loopbackHosts = new Set(["localhost", "127.0.0.1", "[::1]"]);
+    const secure = url.protocol === "https:";
+    const allowedDevelopmentOrigin = allowInsecureLoopback && url.protocol === "http:" && loopbackHosts.has(url.hostname);
+    if (!secure && !allowedDevelopmentOrigin)
+      return null;
+    return url.toString().replace(/\/$/, "");
+  } catch {
+    return null;
+  }
+}
+function parseSentryDsn(value) {
+  if (typeof value !== "string" || value.length === 0 || value.length > 2048)
+    return null;
+  const dsn = value.trim();
+  try {
+    const url = new URL(dsn);
+    if (url.protocol !== "https:" || !url.hostname || !url.username || url.password || url.search || url.hash || !/^[A-Za-z0-9_.-]{1,128}$/.test(url.username) || url.username.toLowerCase().startsWith("sntry")) {
+      return null;
+    }
+    const segments = url.pathname.split("/").filter(Boolean);
+    const projectId = segments.pop();
+    if (!projectId || !/^[A-Za-z0-9_-]{1,128}$/.test(projectId))
+      return null;
+    if (segments.some((segment) => !/^[A-Za-z0-9._~-]{1,128}$/.test(segment)))
+      return null;
+    const prefix = segments.length > 0 ? `/${segments.join("/")}` : "";
+    return {
+      dsn,
+      endpoint: `${url.protocol}//${url.host}${prefix}/api/${projectId}/envelope/`,
+      projectId,
+      publicKey: url.username
+    };
+  } catch {
+    return null;
+  }
+}
+function sentryTags(command, context, runtime, error) {
+  return {
+    schema_version: "1",
+    command,
+    cli_version: runtime.version,
+    install_channel: runtime.installChannel,
+    os: runtime.platform,
+    arch: runtime.arch,
+    runtime: runtime.runtime,
+    runtime_major: String(runtime.runtimeMajor),
+    is_ci: String(runtime.isCi),
+    is_tty: String(runtime.isTty),
+    mode: context.mode,
+    is_authenticated: String(context.isAuthenticated),
+    ...error.code ? { error_code: error.code } : {},
+    ...error.status ? { http_status: String(error.status) } : {},
+    ...error.exitCode === undefined ? {} : { exit_code: String(error.exitCode) }
+  };
+}
+function buildSentryEnvelope(input) {
+  const parsedDsn = parseSentryDsn(input.dsn);
+  if (!parsedDsn || !validEventId(input.eventId))
+    return null;
+  const context = normalizeContext(input.context);
+  const runtime = normalizeRuntime(input.runtime);
+  const command = canonicalCommand(input.command);
+  const debugId = validDebugId(input.debugId) ? input.debugId.toLowerCase() : undefined;
+  const error = {
+    type: validErrorType(input.error.type) ? input.error.type : "Error",
+    ...validErrorCode(input.error.code) ? { code: input.error.code } : {},
+    ...validStatus(input.error.status) ? { status: input.error.status } : {},
+    ...typeof input.error.exitCode === "number" && Number.isFinite(input.error.exitCode) ? { exitCode: normalizeExitCode(input.error.exitCode) } : {},
+    frames: input.error.frames.slice(0, MAX_STACK_FRAMES).map((frame) => {
+      const filename = /^(?:src\/(?:[A-Za-z0-9_.-]+\/)*[A-Za-z0-9_.-]+\.(?:[cm]?[jt]sx?)|bin\/dosu\.js)$/.test(frame.filename) ? frame.filename : "src/unknown.ts";
+      return {
+        filename,
+        ...debugId && filename === "bin/dosu.js" ? { abs_path: BUNDLE_CODE_FILE } : {},
+        lineno: Math.min(1e7, Math.max(1, Math.trunc(frame.lineno) || 1)),
+        colno: Math.min(1e7, Math.max(1, Math.trunc(frame.colno) || 1)),
+        in_app: true
+      };
+    }).reverse()
+  };
+  const exceptionValue = {
+    type: error.type,
+    value: error.code ?? error.type,
+    ...error.frames.length > 0 ? { stacktrace: { frames: error.frames } } : {}
+  };
+  const newestFrame = error.frames.at(-1);
+  const safeCallsite = newestFrame ? `${newestFrame.filename}:${newestFrame.lineno}` : "unknown";
+  const timestampMs = Number.isFinite(input.timestampMs) ? Math.max(0, input.timestampMs) : 0;
+  const mappedBundle = debugId && error.frames.some((frame) => frame.abs_path === BUNDLE_CODE_FILE);
+  const event = {
+    event_id: input.eventId.toLowerCase(),
+    timestamp: timestampMs / 1000,
+    platform: "node",
+    level: "error",
+    release: `dosu-cli@${runtime.version}`,
+    tags: sentryTags(command, context, runtime, error),
+    ...context.user ? {
+      user: {
+        id: context.user.id,
+        ...context.user.email ? { email: context.user.email } : {}
+      }
+    } : {},
+    ...mappedBundle ? {
+      debug_meta: {
+        images: [{ type: "sourcemap", code_file: BUNDLE_CODE_FILE, debug_id: debugId }]
+      }
+    } : {},
+    fingerprint: ["dosu-cli", command, error.type, error.code ?? "unknown", safeCallsite],
+    exception: { values: [exceptionValue] }
+  };
+  const envelopeHeader = {
+    event_id: input.eventId.toLowerCase(),
+    dsn: parsedDsn.dsn,
+    sent_at: new Date(timestampMs).toISOString()
+  };
+  return {
+    endpoint: parsedDsn.endpoint,
+    body: `${JSON.stringify(envelopeHeader)}
+${JSON.stringify({ type: "event" })}
+${JSON.stringify(event)}`
+  };
+}
+function fetchWithoutRedirect(url, init = {}) {
+  let parsedURL;
+  try {
+    parsedURL = new URL(url);
+    if (parsedURL.protocol !== "http:" && parsedURL.protocol !== "https:") {
+      return Promise.reject(new Error("unsupported telemetry protocol"));
+    }
+  } catch (error) {
+    return Promise.reject(error);
+  }
+  return new Promise((resolve3, reject) => {
+    let request;
+    let response;
+    let settled = false;
+    const signal = init.signal;
+    const cleanup = () => signal?.removeEventListener("abort", onAbort);
+    const fail = (error) => {
+      if (settled)
+        return;
+      settled = true;
+      cleanup();
+      response?.destroy();
+      request?.socket?.destroy();
+      request?.destroy();
+      reject(error);
+    };
+    const succeed = (value) => {
+      if (settled)
+        return;
+      settled = true;
+      cleanup();
+      response?.destroy();
+      request?.socket?.destroy();
+      request?.destroy();
+      resolve3(value);
+    };
+    const onAbort = () => {
+      const error = new Error("telemetry request aborted");
+      error.name = "AbortError";
+      fail(error);
+    };
+    try {
+      if (signal?.aborted) {
+        onAbort();
+        return;
+      }
+      const body = init.body;
+      if (body !== undefined && body !== null && typeof body !== "string") {
+        fail(new Error("unsupported telemetry request body"));
+        return;
+      }
+      const headers = Object.fromEntries(new Headers(init.headers).entries());
+      const transport = parsedURL.protocol === "https:" ? httpsRequest : httpRequest2;
+      request = transport(parsedURL, {
+        method: init.method ?? "GET",
+        headers,
+        agent: false
+      }, (incoming) => {
+        response = incoming;
+        const chunks = [];
+        let totalBytes = 0;
+        incoming.on("data", (chunk) => {
+          const bytes = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+          totalBytes += bytes.byteLength;
+          if (totalBytes > MAX_RESPONSE_BYTES) {
+            fail(new Error("telemetry response too large"));
+            return;
+          }
+          chunks.push(bytes);
+        });
+        incoming.once("error", fail);
+        incoming.once("end", () => {
+          try {
+            const responseHeaders = new Headers;
+            for (let index = 0;index < incoming.rawHeaders.length; index += 2) {
+              const name = incoming.rawHeaders[index];
+              const value = incoming.rawHeaders[index + 1];
+              if (name && value)
+                responseHeaders.append(name, value);
+            }
+            const status = incoming.statusCode;
+            if (!status)
+              throw new Error("telemetry response missing status");
+            succeed(new Response(chunks.length > 0 ? Buffer.concat(chunks) : null, {
+              status,
+              statusText: incoming.statusMessage,
+              headers: responseHeaders
+            }));
+          } catch (error) {
+            fail(error);
+          }
+        });
+      });
+      request.once("error", fail);
+      signal?.addEventListener("abort", onAbort, { once: true });
+      request.end(body);
+    } catch (error) {
+      fail(error);
+    }
+  });
+}
+async function sendHttpsRequest(url, init, fetcher = fetchWithoutRedirect) {
+  try {
+    if (new URL(url).protocol !== "https:")
+      return false;
+  } catch {
+    return false;
+  }
+  const controller = new AbortController;
+  let timer;
+  const timeout = new Promise((_resolve, reject) => {
+    timer = setTimeout(() => {
+      controller.abort();
+      reject(new Error("telemetry request timed out"));
+    }, REQUEST_TIMEOUT_MS);
+  });
+  try {
+    const request = fetcher(url, { ...init, redirect: "error", signal: controller.signal });
+    const result = await Promise.race([request, timeout]);
+    return result.ok;
+  } catch {
+    return false;
+  } finally {
+    controller.abort();
+    if (timer !== undefined)
+      clearTimeout(timer);
+  }
+}
+function environmentFlag(value) {
+  if (value === undefined)
+    return false;
+  const normalized = value.trim().toLowerCase();
+  return normalized !== "" && !["0", "false", "no", "off"].includes(normalized);
+}
+function runtimeNameAndMajor() {
+  const versions = process.versions;
+  const runtime = versions.bun ? "bun" : "node";
+  const version = versions.bun ?? versions.node;
+  return { runtime, runtimeMajor: Number.parseInt(version.split(".")[0] ?? "0", 10) || 0 };
+}
+function resolveRuntime(dependencies, env) {
+  const detected = runtimeNameAndMajor();
+  return normalizeRuntime({
+    version: dependencies.version ?? VERSION,
+    installChannel: dependencies.installChannel ?? INSTALL_CHANNEL,
+    platform: dependencies.platform ?? process.platform,
+    arch: dependencies.arch ?? process.arch,
+    runtime: dependencies.runtime ?? detected.runtime,
+    runtimeMajor: dependencies.runtimeMajor ?? detected.runtimeMajor,
+    isCi: dependencies.isCi ?? environmentFlag(env.CI),
+    isTty: dependencies.isTty ?? process.stdout.isTTY === true
+  });
+}
+function validationFailure(exitCode, error) {
+  if (exitCode === 2)
+    return true;
+  if (error?.type === "CliUsageError")
+    return true;
+  if (!error?.code)
+    return false;
+  return error.code.startsWith("commander.") || ["BAD_REQUEST", "INVALID_ARGUMENT", "UNPROCESSABLE_CONTENT", "VALIDATION_ERROR"].includes(error.code);
+}
+function safeNow(now) {
+  try {
+    const value = now();
+    return Number.isFinite(value) ? Math.max(0, value) : 0;
+  } catch {
+    return 0;
+  }
+}
+function safeUuid(generate) {
+  try {
+    const value = generate();
+    return isUUID(value) ? value : undefined;
+  } catch {
+    return;
+  }
+}
+function eventId(generate) {
+  const uuid2 = safeUuid(generate);
+  return uuid2?.replaceAll("-", "");
+}
+function createCommandTelemetry(settings2, dependencies = {}) {
+  const env = dependencies.env ?? process.env;
+  const fetcher = dependencies.fetch;
+  const now = dependencies.now ?? Date.now;
+  const generateUuid = dependencies.randomUUID ?? randomUUID2;
+  const writeStderr = dependencies.stderr ?? ((payload) => process.stderr.write(`${payload}
+`));
+  const webAppURL = dependencies.webAppURL ?? getWebAppURL;
+  const resolveFacets = dependencies.facets ?? consumeCommandFacets;
+  const runtime = resolveRuntime(dependencies, env);
+  const debug = env.DOSU_TELEMETRY_DEBUG === "1";
+  const disabled = settings2.disabled === true || environmentFlag(env.DO_NOT_TRACK) || environmentFlag(env.DOSU_TELEMETRY_DISABLED);
+  const rawAnalyticsToken = dependencies.env ? env.DOSU_POSTHOG_PROJECT_TOKEN_OVERRIDE ?? env.DOSU_POSTHOG_PROJECT_TOKEN : process.env.DOSU_POSTHOG_PROJECT_TOKEN_OVERRIDE ?? "phc_Uo9RxhN0HRk8gZkPlT18BCr7eqsM0MPWVW88HZB95V5";
+  const rawSentryDsn = dependencies.env ? env.DOSU_CLI_SENTRY_DSN_OVERRIDE ?? env.DOSU_CLI_SENTRY_DSN : process.env.DOSU_CLI_SENTRY_DSN_OVERRIDE ?? "https://f6b3e51dea6f50746316aa1896df76e0@o4505364738670592.ingest.us.sentry.io/4511883653283840";
+  const analyticsToken = parsePostHogProjectToken(rawAnalyticsToken) ?? undefined;
+  const sentryDsn = parseSentryDsn(rawSentryDsn)?.dsn;
+  let started = false;
+  let terminal = false;
+  let startedAt = 0;
+  let command = UNKNOWN_COMMAND;
+  let context = normalizeContext(undefined);
+  let installIdResolved = false;
+  let resolvedInstallId = settings2.install_id;
+  function installId() {
+    if (isUUID(resolvedInstallId))
+      return resolvedInstallId;
+    if (installIdResolved)
+      return;
+    installIdResolved = true;
+    try {
+      resolvedInstallId = dependencies.resolveInstallId?.();
+    } catch {
+      resolvedInstallId = undefined;
+    }
+    return isUUID(resolvedInstallId) ? resolvedInstallId : undefined;
+  }
+  function debugPayload(payload) {
+    try {
+      writeStderr(payload);
+    } catch {}
+  }
+  async function dispatch(result, exitCode, error) {
+    try {
+      const tasks = [];
+      if (!disabled && analyticsToken) {
+        const id = context.user?.id ?? installId();
+        if (id) {
+          let facets;
+          try {
+            facets = resolveFacets();
+          } catch {
+            facets = undefined;
+          }
+          const payload = buildPostHogPayload({
+            apiKey: analyticsToken,
+            ...context.user ? {} : { installId: id },
+            command,
+            result,
+            durationMs: safeNow(now) - startedAt,
+            exitCode,
+            errorCode: error?.code,
+            ...facets ? { facets } : {},
+            context,
+            runtime
+          });
+          const body = JSON.stringify(payload);
+          if (debug) {
+            debugPayload(body);
+          } else {
+            const base = parseTelemetryWebAppURL(webAppURL());
+            if (base) {
+              tasks.push(sendHttpsRequest(`${base}/ph-api/i/v0/e/`, {
+                method: "POST",
+                headers: { "content-type": "application/json" },
+                body
+              }, fetcher));
+            }
+          }
+        }
+      }
+      if (!disabled && result === "failure" && error && shouldSendToSentry(error) && sentryDsn) {
+        const id = eventId(generateUuid);
+        const envelope = id ? buildSentryEnvelope({
+          dsn: sentryDsn,
+          command,
+          context,
+          runtime,
+          error,
+          eventId: id,
+          timestampMs: safeNow(now),
+          debugId: BUNDLE_DEBUG_ID_PLACEHOLDER
+        }) : null;
+        if (envelope) {
+          if (debug) {
+            debugPayload(envelope.body);
+          } else {
+            tasks.push(sendHttpsRequest(envelope.endpoint, {
+              method: "POST",
+              headers: { "content-type": "application/x-sentry-envelope" },
+              body: envelope.body
+            }, fetcher));
+          }
+        }
+      }
+      await Promise.all(tasks);
+    } catch {}
+  }
+  return {
+    start(commandName, commandContext) {
+      if (started || terminal)
+        return;
+      started = true;
+      command = canonicalCommand(commandName);
+      context = normalizeContext(commandContext);
+      startedAt = safeNow(now);
+    },
+    async complete(exitCode = 0) {
+      if (!started || terminal)
+        return;
+      terminal = true;
+      const normalizedExitCode = normalizeExitCode(exitCode, 0);
+      const result = normalizedExitCode === 0 ? "success" : validationFailure(normalizedExitCode, undefined) ? "validation_error" : "failure";
+      const error = result === "failure" ? { type: "CommandExitError", frames: [], exitCode: normalizedExitCode } : undefined;
+      await dispatch(result, normalizedExitCode, error);
+    },
+    async fail(rawError) {
+      if (!started || terminal)
+        return;
+      terminal = true;
+      const error = sanitizeError(rawError);
+      const exitCode = error.exitCode ?? 1;
+      const result = validationFailure(exitCode, error) ? "validation_error" : "failure";
+      await dispatch(result, exitCode, error);
+    }
+  };
+}
+function shouldSendToSentry(error) {
+  return !["SESSION_EXPIRED", "SESSION_PERSISTENCE_ERROR"].includes(error.code ?? "");
+}
+var REQUEST_TIMEOUT_MS = 500, MAX_RESPONSE_BYTES, MAX_STACK_FRAMES = 20, UNKNOWN_COMMAND = "unknown", FALLBACK_INSTALL_ID = "00000000-0000-4000-8000-000000000000", BUNDLE_CODE_FILE = "app:///bin/dosu.js", CLI_PACKAGE_ROOT, SAFE_ERROR_TYPES, SAFE_ERROR_CODES, SYNC_TRIGGERS, SYNC_STATUSES, LEARNER_OUTCOMES, BACKFILL_OFFERS, pendingFacets;
+var init_telemetry = __esm(() => {
+  MAX_RESPONSE_BYTES = 1024 * 1024;
+  CLI_PACKAGE_ROOT = detectCliPackageRoot();
+  SAFE_ERROR_TYPES = new Set([
+    "AbortError",
+    "AggregateError",
+    "CommanderError",
+    "CliUsageError",
+    "CommandExitError",
+    "Error",
+    "OAuthCallbackError",
+    "RangeError",
+    "ReferenceError",
+    "SessionExpiredError",
+    "SessionPersistenceError",
+    "SessionRefreshError",
+    "SyntaxError",
+    "TRPCClientError",
+    "TypeError"
+  ]);
+  SAFE_ERROR_CODES = new Set([
+    "ABORT_ERR",
+    "BAD_GATEWAY",
+    "BAD_REQUEST",
+    "CLIENT_CLOSED_REQUEST",
+    "CONFLICT",
+    "EACCES",
+    "EAI_AGAIN",
+    "EBUSY",
+    "ECONNREFUSED",
+    "ECONNRESET",
+    "EEXIST",
+    "EHOSTUNREACH",
+    "EINVAL",
+    "EISDIR",
+    "ELOOP",
+    "EMFILE",
+    "ENAMETOOLONG",
+    "ENETUNREACH",
+    "ENFILE",
+    "ENOENT",
+    "ENOMEM",
+    "ENOSPC",
+    "ENOTFOUND",
+    "ENOTDIR",
+    "EPIPE",
+    "EPERM",
+    "EROFS",
+    "ETIMEDOUT",
+    "FORBIDDEN",
+    "GATEWAY_TIMEOUT",
+    "IMPORT_ALREADY_IN_PROGRESS",
+    "INTERNAL_SERVER_ERROR",
+    "INVALID_ARGUMENT",
+    "METHOD_NOT_SUPPORTED",
+    "NOT_FOUND",
+    "NOT_IMPLEMENTED",
+    "PARSE_ERROR",
+    "PAYLOAD_TOO_LARGE",
+    "PAYMENT_REQUIRED",
+    "PRECONDITION_FAILED",
+    "SERVICE_UNAVAILABLE",
+    "SESSION_EXPIRED",
+    "SESSION_PERSISTENCE_ERROR",
+    "SESSION_REFRESH_ERROR",
+    "TIMEOUT",
+    "TOO_MANY_REQUESTS",
+    "UNAUTHORIZED",
+    "UNPROCESSABLE_CONTENT",
+    "UNSUPPORTED_MEDIA_TYPE",
+    "VALIDATION_ERROR",
+    "commander.conflictingOption",
+    "commander.error",
+    "commander.excessArguments",
+    "commander.invalidArgument",
+    "commander.missingArgument",
+    "commander.missingMandatoryOptionValue",
+    "commander.optionMissingArgument",
+    "commander.unknownCommand",
+    "commander.unknownOption"
+  ]);
+  SYNC_TRIGGERS = new Set(["hook", "manual", "bootstrap"]);
+  SYNC_STATUSES = new Set([
+    "backlog",
+    "nothing-new",
+    "skipped-backoff",
+    "skipped-lock",
+    "skipped-gateway",
+    "skipped-paused",
+    "studied",
+    "mine-failed",
+    "error",
+    "detached",
+    "detach-failed",
+    "status-only"
+  ]);
+  LEARNER_OUTCOMES = new Set([
+    "completed",
+    "settings_conflict",
+    "consent_off",
+    "credit_limit",
+    "quota_exceeded",
+    "error"
+  ]);
+  BACKFILL_OFFERS = new Set([
+    "not-offered",
+    "accepted",
+    "declined",
+    "cancelled",
+    "spawn-failed"
+  ]);
+});
+
 // src/report/backfill.ts
 function noteTime2(at) {
   const parsed = Date.parse(at ?? "");
@@ -10872,7 +11720,7 @@ function createRunConfigDir() {
 var init_config_dir = () => {};
 
 // src/learner/conflicts.ts
-import { existsSync as existsSync13, readFileSync as readFileSync15 } from "node:fs";
+import { existsSync as existsSync14, readFileSync as readFileSync15 } from "node:fs";
 function managedSettingsPaths(platform3 = process.platform) {
   switch (platform3) {
     case "darwin":
@@ -10901,7 +11749,7 @@ function conflictingKeysIn(settings2) {
 function detectSettingsConflicts(paths = managedSettingsPaths()) {
   const conflicts = [];
   for (const file of paths) {
-    if (!existsSync13(file))
+    if (!existsSync14(file))
       continue;
     let settings2;
     try {
@@ -10964,7 +11812,7 @@ var init_env = __esm(() => {
 });
 
 // src/learner/executable.ts
-import { accessSync, constants, existsSync as existsSync14 } from "node:fs";
+import { accessSync, constants, existsSync as existsSync15 } from "node:fs";
 import { createRequire as createRequire3 } from "node:module";
 import { homedir as homedir4 } from "node:os";
 import { delimiter as delimiter2, dirname as dirname5, join as join14 } from "node:path";
@@ -10976,7 +11824,7 @@ function sdkNativeBinaryExists() {
     const requireRuntime = createRequire3(import.meta.url);
     const pkg = `@anthropic-ai/claude-agent-sdk-${process.platform}-${process.arch}`;
     const pkgDir = dirname5(requireRuntime.resolve(`${pkg}/package.json`));
-    return binaryNames().some((name) => existsSync14(join14(pkgDir, name)));
+    return binaryNames().some((name) => existsSync15(join14(pkgDir, name)));
   } catch {
     return false;
   }
@@ -73091,1246 +73939,479 @@ async function runLearner(options) {
     const gatewayError = classifyGatewayError(text);
     if (gatewayError) {
       return { outcome: gatewayError.outcome, notesWritten, turns, message: gatewayError.message };
-    }
-    logger.debug("learner", `run ${runID} threw: ${text}`);
-    return {
-      outcome: "error",
-      notesWritten,
-      turns,
-      message: abort.signal.aborted ? "Study run timed out and was aborted." : "Study run failed; see debug log for details."
-    };
-  } finally {
-    clearTimeout(timer);
-    configDir.cleanup();
-  }
-}
-var DEFAULT_MAX_TURNS = 160, DEFAULT_MAX_NOTES = 80, DEFAULT_TIMEOUT_MS2, KNOWLEDGE_SERVER_NAME = "dosu", GATEWAY_ERRORS, TRACE_SNIPPET_LIMIT = 400;
-var init_runner = __esm(() => {
-  init_logger();
-  init_config_helpers();
-  init_notes();
-  init_config_dir();
-  init_conflicts();
-  init_env();
-  init_executable();
-  init_tools();
-  DEFAULT_TIMEOUT_MS2 = 30 * 60 * 1000;
-  GATEWAY_ERRORS = {
-    dosu_consent_off: {
-      outcome: "consent_off",
-      message: "Your org hasn't enabled Dosu Remote Sessions. Ask an org admin to turn it on."
-    },
-    dosu_credit_limit_reached: {
-      outcome: "credit_limit",
-      message: "Your org has used its Dosu credits for this billing period. An admin can enable overage or upgrade."
-    },
-    dosu_quota_exceeded: {
-      outcome: "quota_exceeded",
-      message: "Daily Dosu Remote Sessions budget reached; runs resume tomorrow."
-    }
-  };
-});
-
-// src/version/skill-update-check.ts
-import { existsSync as existsSync17, mkdirSync as mkdirSync10, readFileSync as readFileSync18, writeFileSync as writeFileSync11 } from "node:fs";
-import { join as join20 } from "node:path";
-function getCachePath2() {
-  return join20(getConfigDir(), CACHE_FILENAME3);
-}
-function readSkillCache() {
-  try {
-    const path3 = getCachePath2();
-    if (!existsSync17(path3))
-      return null;
-    const data = JSON.parse(readFileSync18(path3, "utf-8"));
-    if (typeof data.lastCheck === "number" && typeof data.latestSha === "string" && typeof data.installedSha === "string") {
-      return data;
-    }
-    return null;
-  } catch {
-    return null;
-  }
-}
-function writeSkillCache(cache) {
-  try {
-    const dir = getConfigDir();
-    if (!existsSync17(dir)) {
-      mkdirSync10(dir, { recursive: true, mode: 448 });
-    }
-    writeFileSync11(getCachePath2(), JSON.stringify(cache), { mode: 384 });
-  } catch {}
-}
-function clearInstalledSha() {
-  const cache = readSkillCache();
-  if (cache)
-    writeSkillCache({ ...cache, installedSha: "" });
-}
-async function fetchLatestSha() {
-  const controller = new AbortController;
-  const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS2);
-  try {
-    const resp = await fetch(GITHUB_API_URL, {
-      signal: controller.signal,
-      headers: {
-        "User-Agent": `dosu-cli/${VERSION}`,
-        Accept: "application/vnd.github+json"
-      }
-    });
-    if (!resp.ok)
-      return null;
-    const data = await resp.json();
-    const sha = data.sha;
-    return typeof sha === "string" ? sha : null;
-  } catch {
-    return null;
-  } finally {
-    clearTimeout(timeout);
-  }
-}
-function displayNotice() {
-  const msg = `
-${import_picocolors23.default.yellow("  Dosu skill update available")}
-` + `${import_picocolors23.default.dim('  Run "dosu skill update" to upgrade')}
-`;
-  console.error(msg);
-}
-function checkForSkillUpdates() {
-  try {
-    const cache = readSkillCache();
-    if (cache?.installedSha && cache.latestSha && cache.latestSha !== cache.installedSha) {
-      displayNotice();
-    }
-    const isStale = !cache || Date.now() - cache.lastCheck > CHECK_INTERVAL_MS2;
-    if (isStale) {
-      fetchLatestSha().then((latest) => {
-        const fresh = readSkillCache();
-        writeSkillCache({
-          lastCheck: Date.now(),
-          latestSha: latest ?? fresh?.latestSha ?? "",
-          installedSha: fresh?.installedSha ?? ""
-        });
-        if (latest) {
-          logger.debug("skill-update-check", `Cached latest SHA: ${latest}`);
-        }
-      }).catch((err) => {
-        logger.error("skill-update-check", `Background fetch failed: ${err}`);
-      });
-    }
-  } catch (err) {
-    logger.error("skill-update-check", `Skill update check failed: ${err}`);
-  }
-}
-var import_picocolors23, CACHE_FILENAME3 = "skill-update-check.json", CHECK_INTERVAL_MS2, FETCH_TIMEOUT_MS2 = 5000, GITHUB_API_URL = "https://api.github.com/repos/dosu-ai/dosu-skill/commits/HEAD";
-var init_skill_update_check = __esm(() => {
-  init_config();
-  init_logger();
-  import_picocolors23 = __toESM(require_picocolors(), 1);
-  CHECK_INTERVAL_MS2 = 24 * 60 * 60 * 1000;
-});
-
-// src/commands/skill.ts
-import { exec as exec2, execSync as execSync2 } from "node:child_process";
-import { homedir as homedir6 } from "node:os";
-import { join as join21 } from "node:path";
-function skillAgentIDsForProviders(providerIDs) {
-  return [
-    ...new Set(providerIDs.map((providerID) => SKILL_AGENT_BY_PROVIDER[providerID]).filter((agent) => Boolean(agent)))
-  ];
-}
-function skillInstallTargetForProvider(providerID) {
-  const agentID = SKILL_AGENT_BY_PROVIDER[providerID];
-  if (!agentID)
-    return null;
-  if (agentID === "claude-code") {
-    const claudeConfigDir = process.env.CLAUDE_CONFIG_DIR?.trim() || join21(homedir6(), ".claude");
-    return { path: join21(claudeConfigDir, "skills", SKILL_NAME), symlink: true };
-  }
-  if (agentID === "windsurf") {
-    return {
-      path: join21(homedir6(), ".codeium", "windsurf", "skills", SKILL_NAME),
-      symlink: true
-    };
-  }
-  return {
-    path: join21(homedir6(), ".agents", "skills", SKILL_NAME),
-    symlink: false
-  };
-}
-function skillAgentArgs(providerIDs) {
-  const agents = providerIDs === undefined ? SUPPORTED_SKILL_AGENTS : skillAgentIDsForProviders(providerIDs);
-  return agents.map((agent) => `-a ${agent}`).join(" ");
-}
-function execQuiet(command) {
-  return new Promise((resolve6, reject) => {
-    exec2(command, { windowsHide: true }, (error61) => {
-      if (error61)
-        reject(error61);
-      else
-        resolve6();
-    });
-  });
-}
-async function installSkill(providerIDs, options = {}) {
-  const agentArgs = skillAgentArgs(providerIDs);
-  if (!agentArgs) {
-    logger.debug("skill", "No selected providers support the Dosu skill");
-    return { success: true };
-  }
-  try {
-    const command = `npx skills add ${SKILL_REPO} -g ${agentArgs} -s "*" -y`;
-    if (options.quiet)
-      await execQuiet(command);
-    else
-      execSync2(command, { stdio: "inherit" });
-  } catch (err) {
-    logger.error("skill", `Failed to install skill: ${err}`);
-    return { success: false };
-  }
-  const sha = await fetchLatestSha();
-  if (sha) {
-    writeSkillCache({
-      lastCheck: Date.now(),
-      latestSha: sha,
-      installedSha: sha
-    });
-    return { success: true, sha };
-  }
-  logger.debug("skill", "Skill installed but could not fetch latest SHA");
-  return { success: true };
-}
-function installedSkillNames() {
-  let entries;
-  try {
-    const json2 = execSync2("npx skills list -g --json", {
-      encoding: "utf-8",
-      stdio: ["ignore", "pipe", "ignore"]
-    });
-    const parsed = JSON.parse(json2);
-    if (!Array.isArray(parsed))
-      throw new Error("expected a JSON array");
-    entries = parsed;
-  } catch (err) {
-    logger.debug("skill", `Could not list installed skills: ${err}`);
-    return null;
-  }
-  const names = [];
-  for (const entry of entries) {
-    if (entry.source !== SKILL_REPO || typeof entry.name !== "string")
-      continue;
-    if (!SAFE_SKILL_NAME.test(entry.name)) {
-      logger.warn("skill", `Skipping skill with an unsupported name: ${entry.name}`);
-      continue;
-    }
-    names.push(entry.name);
-  }
-  return names;
-}
-function skillCommand() {
-  const cmd = new Command("skill").description("Manage the Dosu agent skill");
-  cmd.command("install").description("Install the Dosu skill for AI coding agents").action(async () => {
-    console.log(`Installing skills from ${SKILL_REPO}...`);
-    const result = await installSkill();
-    if (result.success) {
-      console.log(import_picocolors24.default.green(`
-✓ Skills installed successfully.`));
-    } else {
-      console.error(import_picocolors24.default.red(`
-Failed to install skill. Make sure npx is available.`));
-      process.exit(1);
-    }
-  });
-  cmd.command("remove").description("Remove the Dosu skills").action(() => {
-    const installed = installedSkillNames();
-    if (installed?.length === 0) {
-      console.log(`No skills from ${SKILL_REPO} are installed.`);
-      return;
-    }
-    const targets = installed ?? [SKILL_NAME];
-    console.log(`Removing skills from ${SKILL_REPO}...`);
-    try {
-      execSync2(`npx skills remove -g ${targets.join(" ")} -y`, {
-        stdio: "inherit"
-      });
-      clearInstalledSha();
-      console.log(import_picocolors24.default.green(`
-✓ Skills removed.`));
-    } catch {
-      console.error(import_picocolors24.default.red(`
-Failed to remove skills.`));
-      process.exit(1);
-    }
-  });
-  cmd.command("update").description("Update the Dosu skill to the latest version").action(async () => {
-    console.log(`Updating skills from ${SKILL_REPO}...`);
-    const result = await installSkill();
-    if (!result.success) {
-      console.error(import_picocolors24.default.red(`
-Failed to update skill.`));
-      process.exit(1);
-    }
-    console.log(import_picocolors24.default.green(`
-✓ Skills updated.`));
-  });
-  return cmd;
-}
-var import_picocolors24, SKILL_REPO = "dosu-ai/dosu-skill", SKILL_NAME = "dosu", SAFE_SKILL_NAME, SUPPORTED_SKILL_AGENTS, SKILL_AGENT_BY_PROVIDER;
-var init_skill = __esm(() => {
-  init_commander();
-  init_logger();
-  init_skill_update_check();
-  import_picocolors24 = __toESM(require_picocolors(), 1);
-  SAFE_SKILL_NAME = /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/;
-  SUPPORTED_SKILL_AGENTS = [
-    "claude-code",
-    "cursor",
-    "gemini-cli",
-    "codex",
-    "windsurf",
-    "zed",
-    "cline",
-    "github-copilot",
-    "opencode",
-    "antigravity"
-  ];
-  SKILL_AGENT_BY_PROVIDER = {
-    claude: "claude-code",
-    cursor: "cursor",
-    vscode: "github-copilot",
-    gemini: "gemini-cli",
-    codex: "codex",
-    windsurf: "windsurf",
-    zed: "zed",
-    cline: "cline",
-    "cline-cli": "cline",
-    copilot: "github-copilot",
-    opencode: "opencode",
-    antigravity: "antigravity"
-  };
-});
-
-// src/telemetry/settings.ts
-import { randomUUID as randomUUID3 } from "node:crypto";
-import {
-  existsSync as existsSync18,
-  lstatSync as lstatSync2,
-  mkdirSync as mkdirSync11,
-  readFileSync as readFileSync19,
-  renameSync as renameSync5,
-  unlinkSync as unlinkSync3,
-  writeFileSync as writeFileSync12
-} from "node:fs";
-import { join as join22 } from "node:path";
-function getTelemetrySettingsPath() {
-  return join22(getConfigDir(), TELEMETRY_SETTINGS_FILENAME);
-}
-function loadTelemetrySettings() {
-  return readTelemetrySettings().settings;
-}
-function setTelemetryEnabled(enabled) {
-  if (typeof enabled !== "boolean")
-    return false;
-  const current = readTelemetrySettings();
-  if (current.status === "unsupported" || current.status === "error")
-    return false;
-  const settings2 = current.status === "current" ? current.settings : emptyTelemetrySettings();
-  if (enabled)
-    delete settings2.disabled;
-  else
-    settings2.disabled = true;
-  return writeTelemetrySettings(settings2);
-}
-function telemetryDisabledByEnvironment() {
-  if (isEnabledEnvironmentFlag(process.env.DO_NOT_TRACK))
-    return "DO_NOT_TRACK";
-  if (isEnabledEnvironmentFlag(process.env.DOSU_TELEMETRY_DISABLED)) {
-    return "DOSU_TELEMETRY_DISABLED";
-  }
-  return;
-}
-function isTelemetryEnabled(settings2 = loadTelemetrySettings()) {
-  if (telemetryDisabledByEnvironment() !== undefined)
-    return false;
-  return settings2.disabled !== true;
-}
-function getOrCreateInstallID() {
-  const current = readTelemetrySettings();
-  if (current.status === "current" && current.settings.install_id) {
-    return current.settings.install_id;
-  }
-  if (current.status !== "current" && current.status !== "missing")
-    return;
-  const installID = randomUUID3();
-  const settings2 = current.status === "current" ? current.settings : emptyTelemetrySettings();
-  settings2.install_id = installID;
-  return writeTelemetrySettings(settings2) ? installID : undefined;
-}
-function resetInstallID() {
-  const current = readTelemetrySettings();
-  if (current.status !== "current" && current.status !== "missing")
-    return;
-  const settings2 = current.status === "current" ? current.settings : emptyTelemetrySettings();
-  const installID = randomUUID3();
-  settings2.install_id = installID;
-  return writeTelemetrySettings(settings2) ? installID : undefined;
-}
-function readTelemetrySettings() {
-  const path3 = getTelemetrySettingsPath();
-  let file2;
-  try {
-    file2 = lstatSync2(path3);
-  } catch (error61) {
-    if (isErrorCode(error61, "ENOENT")) {
-      return { status: "missing", settings: emptyTelemetrySettings() };
-    }
-    return { status: "error", settings: disabledTelemetrySettings() };
-  }
-  if (!file2.isFile() || file2.size > MAX_TELEMETRY_SETTINGS_BYTES) {
-    return { status: "invalid", settings: disabledTelemetrySettings() };
-  }
-  let content;
-  try {
-    content = readFileSync19(path3, "utf-8");
-  } catch {
-    return { status: "error", settings: disabledTelemetrySettings() };
-  }
-  let raw;
-  try {
-    raw = JSON.parse(content);
-  } catch {
-    return { status: "invalid", settings: disabledTelemetrySettings() };
-  }
-  if (!isRecord5(raw))
-    return { status: "invalid", settings: disabledTelemetrySettings() };
-  if (raw.schema_version !== TELEMETRY_SCHEMA_VERSION) {
-    const status = "schema_version" in raw ? "unsupported" : "invalid";
-    return { status, settings: disabledTelemetrySettings() };
-  }
-  if ("disabled" in raw && typeof raw.disabled !== "boolean") {
-    return { status: "invalid", settings: disabledTelemetrySettings() };
-  }
-  const settings2 = emptyTelemetrySettings();
-  if (raw.disabled === true)
-    settings2.disabled = true;
-  if (typeof raw.install_id === "string" && isUUID(raw.install_id)) {
-    settings2.install_id = raw.install_id;
-  }
-  return { status: "current", settings: settings2 };
-}
-function writeTelemetrySettings(settings2) {
-  const path3 = getTelemetrySettingsPath();
-  const dir = getConfigDir();
-  const temporaryPath = `${path3}.${process.pid}.${randomUUID3()}.tmp`;
-  try {
-    if (!existsSync18(dir))
-      mkdirSync11(dir, { recursive: true, mode: 448 });
-    writeFileSync12(temporaryPath, `${JSON.stringify(settings2, null, 2)}
-`, {
-      flag: "wx",
-      mode: 384
-    });
-    renameSync5(temporaryPath, path3);
-    return true;
-  } catch {
-    try {
-      unlinkSync3(temporaryPath);
-    } catch {}
-    return false;
+    }
+    logger.debug("learner", `run ${runID} threw: ${text}`);
+    return {
+      outcome: "error",
+      notesWritten,
+      turns,
+      message: abort.signal.aborted ? "Study run timed out and was aborted." : "Study run failed; see debug log for details."
+    };
+  } finally {
+    clearTimeout(timer);
+    configDir.cleanup();
   }
 }
-function emptyTelemetrySettings() {
-  return { schema_version: TELEMETRY_SCHEMA_VERSION };
-}
-function disabledTelemetrySettings() {
-  return { schema_version: TELEMETRY_SCHEMA_VERSION, disabled: true };
-}
-function isEnabledEnvironmentFlag(value) {
-  if (value === undefined)
-    return false;
-  const normalized = value.trim().toLowerCase();
-  if (normalized === "")
-    return false;
-  return !["0", "false", "no", "off"].includes(normalized);
-}
-function isUUID(value) {
-  return /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value);
-}
-function isRecord5(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function isErrorCode(error61, code) {
-  return typeof error61 === "object" && error61 !== null && "code" in error61 && error61.code === code;
-}
-var TELEMETRY_SCHEMA_VERSION = 1, TELEMETRY_SETTINGS_FILENAME = "telemetry.json", MAX_TELEMETRY_SETTINGS_BYTES;
-var init_settings = __esm(() => {
-  init_config();
-  MAX_TELEMETRY_SETTINGS_BYTES = 16 * 1024;
+var DEFAULT_MAX_TURNS = 160, DEFAULT_MAX_NOTES = 80, DEFAULT_TIMEOUT_MS2, KNOWLEDGE_SERVER_NAME = "dosu", GATEWAY_ERRORS, TRACE_SNIPPET_LIMIT = 400;
+var init_runner = __esm(() => {
+  init_logger();
+  init_config_helpers();
+  init_notes();
+  init_config_dir();
+  init_conflicts();
+  init_env();
+  init_executable();
+  init_tools();
+  DEFAULT_TIMEOUT_MS2 = 30 * 60 * 1000;
+  GATEWAY_ERRORS = {
+    dosu_consent_off: {
+      outcome: "consent_off",
+      message: "Your org hasn't enabled Dosu Remote Sessions. Ask an org admin to turn it on."
+    },
+    dosu_credit_limit_reached: {
+      outcome: "credit_limit",
+      message: "Your org has used its Dosu credits for this billing period. An admin can enable overage or upgrade."
+    },
+    dosu_quota_exceeded: {
+      outcome: "quota_exceeded",
+      message: "Daily Dosu Remote Sessions budget reached; runs resume tomorrow."
+    }
+  };
 });
 
-// src/telemetry/debug-id.ts
-var BUNDLE_DEBUG_ID_PLACEHOLDER = "5776df20-501e-ff5f-6475-6e2164756e21";
-
-// src/telemetry/telemetry.ts
-import { randomUUID as randomUUID4 } from "node:crypto";
-import { existsSync as existsSync19 } from "node:fs";
-import { request as httpRequest2 } from "node:http";
-import { request as httpsRequest } from "node:https";
-import { isAbsolute as isAbsolute4, relative as relative2, resolve as resolve6, sep as sep5 } from "node:path";
-import { fileURLToPath as fileURLToPath2 } from "node:url";
-function safeString(value, pattern, fallback) {
-  if (typeof value !== "string" || !pattern.test(value))
-    return fallback;
-  return value;
-}
-function canonicalCommand(value) {
-  if (typeof value !== "string")
-    return UNKNOWN_COMMAND;
-  const command = value.trim();
-  if (command.length > 80)
-    return UNKNOWN_COMMAND;
-  if (!/^[a-z][a-z0-9-]*(?: [a-z][a-z0-9-]*){0,3}$/.test(command)) {
-    return UNKNOWN_COMMAND;
-  }
-  return command;
-}
-function normalizeContext(context) {
-  const isAuthenticated2 = context?.isAuthenticated === true;
-  const id2 = safeRead(context?.user, "id");
-  const email3 = safeRead(context?.user, "email");
-  const orgId = safeRead(context, "orgId");
-  const user = isAuthenticated2 && isUUID2(id2) ? { id: id2, ...validEmail(email3) ? { email: email3 } : {} } : undefined;
-  return {
-    mode: context?.mode === "oss" ? "oss" : "cloud",
-    isAuthenticated: isAuthenticated2,
-    ...user ? { user } : {},
-    ...user && isUUID2(orgId) ? { orgId } : {}
-  };
-}
-function normalizeExitCode(value, fallback = 1) {
-  if (typeof value !== "number" || !Number.isFinite(value))
-    return fallback;
-  return Math.min(255, Math.max(0, Math.trunc(value)));
-}
-function normalizeRuntime(runtime) {
-  return {
-    version: safeString(runtime.version, /^[A-Za-z0-9.+_-]{1,32}$/, "unknown"),
-    installChannel: safeString(runtime.installChannel, /^[A-Za-z][A-Za-z0-9_-]{0,31}$/, "unknown"),
-    platform: safeString(runtime.platform, /^[A-Za-z0-9_-]{1,24}$/, "unknown"),
-    arch: safeString(runtime.arch, /^[A-Za-z0-9_-]{1,24}$/, "unknown"),
-    runtime: safeString(runtime.runtime, /^[A-Za-z][A-Za-z0-9_-]{0,23}$/, "unknown"),
-    runtimeMajor: Math.min(9999, Math.max(0, Math.trunc(runtime.runtimeMajor) || 0)),
-    isCi: runtime.isCi === true,
-    isTty: runtime.isTty === true
-  };
-}
-function isUUID2(value) {
-  return typeof value === "string" && /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value);
-}
-function validEmail(value) {
-  return typeof value === "string" && value.length <= 254 && /^[A-Za-z0-9.!#$%&'*+/=?^_`{|}~-]+@[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?(?:\.[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?)+$/.test(value);
-}
-function validEventId(value) {
-  return typeof value === "string" && /^[0-9a-f]{32}$/i.test(value);
-}
-function validDebugId(value) {
-  return typeof value === "string" && /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(value);
-}
-function validErrorType(value) {
-  return typeof value === "string" && SAFE_ERROR_TYPES.has(value);
-}
-function validErrorCode(value) {
-  return typeof value === "string" && SAFE_ERROR_CODES.has(value);
-}
-function validStatus(value) {
-  return typeof value === "number" && Number.isInteger(value) && value >= 100 && value <= 599;
-}
-function objectLike(value) {
-  return typeof value === "object" && value !== null || typeof value === "function";
+// src/version/skill-update-check.ts
+import { existsSync as existsSync18, mkdirSync as mkdirSync10, readFileSync as readFileSync18, writeFileSync as writeFileSync11 } from "node:fs";
+import { join as join20 } from "node:path";
+function getCachePath2() {
+  return join20(getConfigDir(), CACHE_FILENAME3);
 }
-function safeRead(value, key) {
-  if (!objectLike(value))
-    return;
+function readSkillCache() {
   try {
-    return Reflect.get(value, key);
-  } catch {
-    return;
-  }
-}
-function parseStack(stack) {
-  if (typeof stack !== "string" || !CLI_PACKAGE_ROOT)
-    return [];
-  const frames = [];
-  const lines = stack.slice(0, 1e5).split(`
-`, 200);
-  for (const originalLine of lines) {
-    if (frames.length >= MAX_STACK_FRAMES)
-      break;
-    const parsed = parseOwnedStackLine(originalLine, CLI_PACKAGE_ROOT);
-    if (!parsed)
-      continue;
-    const { filename, lineno, colno } = parsed;
-    if (!Number.isSafeInteger(lineno) || !Number.isSafeInteger(colno) || lineno < 1 || colno < 1 || lineno > 1e7 || colno > 1e7) {
-      continue;
+    const path3 = getCachePath2();
+    if (!existsSync18(path3))
+      return null;
+    const data = JSON.parse(readFileSync18(path3, "utf-8"));
+    if (typeof data.lastCheck === "number" && typeof data.latestSha === "string" && typeof data.installedSha === "string") {
+      return data;
     }
-    frames.push({ filename, lineno, colno, in_app: true });
+    return null;
+  } catch {
+    return null;
   }
-  return frames;
 }
-function detectCliPackageRoot() {
+function writeSkillCache(cache) {
   try {
-    const modulePath = fileURLToPath2(import.meta.url).replaceAll("\\", "/");
-    for (const suffix of ["/src/telemetry/telemetry.ts", "/bin/dosu.js"]) {
-      if (modulePath.endsWith(suffix))
-        return modulePath.slice(0, -suffix.length);
+    const dir = getConfigDir();
+    if (!existsSync18(dir)) {
+      mkdirSync10(dir, { recursive: true, mode: 448 });
     }
+    writeFileSync11(getCachePath2(), JSON.stringify(cache), { mode: 384 });
   } catch {}
-  return;
 }
-function parseOwnedStackLine(originalLine, packageRoot) {
-  const line = originalLine.replaceAll("\\", "/");
-  const match = line.match(/^\s*at\s+.*\s+\((.+):(\d+):(\d+)\)\s*$/) ?? line.match(/^\s*at\s+(.+):(\d+):(\d+)\s*$/);
-  if (!match?.[1] || !match[2] || !match[3])
-    return;
-  let absolutePath = match[1];
-  try {
-    if (absolutePath.startsWith("file://"))
-      absolutePath = fileURLToPath2(absolutePath);
-  } catch {
-    return;
-  }
-  if (!isAbsolute4(absolutePath))
-    return;
-  const resolvedPath = resolve6(absolutePath);
-  const relativePath = relative2(packageRoot, resolvedPath);
-  if (relativePath === "" || relativePath === ".." || relativePath.startsWith(`..${sep5}`) || isAbsolute4(relativePath)) {
-    return;
-  }
-  const filename = relativePath.replaceAll("\\", "/");
-  if (!/^(?:src\/(?:[A-Za-z0-9_.-]+\/)*[A-Za-z0-9_.-]+\.(?:[cm]?[jt]sx?)|bin\/dosu\.js)$/.test(filename)) {
-    return;
-  }
+function clearInstalledSha() {
+  const cache = readSkillCache();
+  if (cache)
+    writeSkillCache({ ...cache, installedSha: "" });
+}
+async function fetchLatestSha() {
+  const controller = new AbortController;
+  const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS2);
   try {
-    if (!existsSync19(resolvedPath))
-      return;
+    const resp = await fetch(GITHUB_API_URL, {
+      signal: controller.signal,
+      headers: {
+        "User-Agent": `dosu-cli/${VERSION}`,
+        Accept: "application/vnd.github+json"
+      }
+    });
+    if (!resp.ok)
+      return null;
+    const data = await resp.json();
+    const sha = data.sha;
+    return typeof sha === "string" ? sha : null;
   } catch {
-    return;
+    return null;
+  } finally {
+    clearTimeout(timeout);
   }
-  return { filename, lineno: Number(match[2]), colno: Number(match[3]) };
 }
-function sanitizeError(error61) {
-  const normalizedError = domainErrorFromCauseChain(error61) ?? error61;
-  const data = safeRead(normalizedError, "data");
-  const typeCandidate = safeRead(normalizedError, "name");
-  const codeCandidates = [safeRead(data, "code"), safeRead(normalizedError, "code")];
-  const statusCandidates = [
-    safeRead(data, "httpStatus"),
-    safeRead(normalizedError, "status"),
-    safeRead(normalizedError, "statusCode")
-  ];
-  const exitCodeCandidate = safeRead(normalizedError, "exitCode");
-  const code = codeCandidates.find(validErrorCode);
-  const status = statusCandidates.find(validStatus);
-  const exitCode = typeof exitCodeCandidate === "number" && Number.isFinite(exitCodeCandidate) ? normalizeExitCode(exitCodeCandidate) : undefined;
-  return {
-    type: validErrorType(typeCandidate) ? typeCandidate : "Error",
-    ...code ? { code } : {},
-    ...status ? { status } : {},
-    frames: parseStack(safeRead(normalizedError, "stack")),
-    ...exitCode === undefined ? {} : { exitCode }
-  };
+function displayNotice() {
+  const msg = `
+${import_picocolors23.default.yellow("  Dosu skill update available")}
+` + `${import_picocolors23.default.dim('  Run "dosu skill update" to upgrade')}
+`;
+  console.error(msg);
 }
-function domainErrorFromCauseChain(error61) {
-  const seen = new Set;
-  let current = error61;
-  for (let depth = 0;depth < 5 && objectLike(current); depth += 1) {
-    if (seen.has(current))
-      return;
-    seen.add(current);
-    const code = safeRead(current, "code");
-    if (code === "SESSION_EXPIRED" || code === "SESSION_PERSISTENCE_ERROR" || code === "SESSION_REFRESH_ERROR") {
-      return current;
+function checkForSkillUpdates() {
+  try {
+    const cache = readSkillCache();
+    if (cache?.installedSha && cache.latestSha && cache.latestSha !== cache.installedSha) {
+      displayNotice();
     }
-    current = safeRead(current, "cause");
+    const isStale = !cache || Date.now() - cache.lastCheck > CHECK_INTERVAL_MS2;
+    if (isStale) {
+      fetchLatestSha().then((latest) => {
+        const fresh = readSkillCache();
+        writeSkillCache({
+          lastCheck: Date.now(),
+          latestSha: latest ?? fresh?.latestSha ?? "",
+          installedSha: fresh?.installedSha ?? ""
+        });
+        if (latest) {
+          logger.debug("skill-update-check", `Cached latest SHA: ${latest}`);
+        }
+      }).catch((err) => {
+        logger.error("skill-update-check", `Background fetch failed: ${err}`);
+      });
+    }
+  } catch (err) {
+    logger.error("skill-update-check", `Skill update check failed: ${err}`);
   }
-  return;
 }
-function durationBucket(durationMs) {
-  const duration3 = Number.isFinite(durationMs) ? Math.max(0, durationMs) : 0;
-  if (duration3 < 100)
-    return "<100ms";
-  if (duration3 < 500)
-    return "100-499ms";
-  if (duration3 < 2000)
-    return "500ms-1.9s";
-  if (duration3 < 1e4)
-    return "2-9.9s";
-  if (duration3 < 60000)
-    return "10-59s";
-  return "60s+";
+var import_picocolors23, CACHE_FILENAME3 = "skill-update-check.json", CHECK_INTERVAL_MS2, FETCH_TIMEOUT_MS2 = 5000, GITHUB_API_URL = "https://api.github.com/repos/dosu-ai/dosu-skill/commits/HEAD";
+var init_skill_update_check = __esm(() => {
+  init_config();
+  init_logger();
+  import_picocolors23 = __toESM(require_picocolors(), 1);
+  CHECK_INTERVAL_MS2 = 24 * 60 * 60 * 1000;
+});
+
+// src/commands/skill.ts
+import { exec as exec2, execSync as execSync2 } from "node:child_process";
+import { homedir as homedir6 } from "node:os";
+import { join as join21 } from "node:path";
+function skillAgentIDsForProviders(providerIDs) {
+  return [
+    ...new Set(providerIDs.map((providerID) => SKILL_AGENT_BY_PROVIDER[providerID]).filter((agent) => Boolean(agent)))
+  ];
 }
-function buildPostHogPayload(input2) {
-  const context = normalizeContext(input2.context);
-  const runtime = normalizeRuntime(input2.runtime);
-  const errorCode = validErrorCode(input2.errorCode) ? input2.errorCode : undefined;
-  const result = input2.result === "success" || input2.result === "validation_error" ? input2.result : "failure";
+function skillInstallTargetForProvider(providerID) {
+  const agentID = SKILL_AGENT_BY_PROVIDER[providerID];
+  if (!agentID)
+    return null;
+  if (agentID === "claude-code") {
+    const claudeConfigDir = process.env.CLAUDE_CONFIG_DIR?.trim() || join21(homedir6(), ".claude");
+    return { path: join21(claudeConfigDir, "skills", SKILL_NAME), symlink: true };
+  }
+  if (agentID === "windsurf") {
+    return {
+      path: join21(homedir6(), ".codeium", "windsurf", "skills", SKILL_NAME),
+      symlink: true
+    };
+  }
   return {
-    api_key: input2.apiKey,
-    distinct_id: context.user?.id ?? (isUUID2(input2.installId) ? input2.installId : FALLBACK_INSTALL_ID),
-    event: "cli_command_completed",
-    properties: {
-      $geoip_disable: true,
-      ...context.user ? {} : { $process_person_profile: false },
-      schema_version: 1,
-      command: canonicalCommand(input2.command),
-      result,
-      duration_bucket: durationBucket(input2.durationMs),
-      cli_version: runtime.version,
-      install_channel: runtime.installChannel,
-      platform: runtime.platform,
-      arch: runtime.arch,
-      runtime: runtime.runtime,
-      runtime_major: runtime.runtimeMajor,
-      is_ci: runtime.isCi,
-      is_tty: runtime.isTty,
-      mode: context.mode,
-      ...context.orgId ? {
-        org_id: context.orgId,
-        $groups: { organization: context.orgId }
-      } : {},
-      is_authenticated: context.isAuthenticated,
-      exit_code: normalizeExitCode(input2.exitCode),
-      ...errorCode ? { error_code: errorCode } : {}
-    }
+    path: join21(homedir6(), ".agents", "skills", SKILL_NAME),
+    symlink: false
   };
 }
-function parsePostHogProjectToken(value) {
-  if (typeof value !== "string")
-    return null;
-  const token = value.trim();
-  return /^phc_[A-Za-z0-9_-]{3,252}$/.test(token) ? token : null;
+function skillAgentArgs(providerIDs) {
+  const agents = providerIDs === undefined ? SUPPORTED_SKILL_AGENTS : skillAgentIDsForProviders(providerIDs);
+  return agents.map((agent) => `-a ${agent}`).join(" ");
 }
-function parseTelemetryWebAppURL(value, allowInsecureLoopback = false) {
-  if (typeof value !== "string" || value.length === 0 || value.length > 2048)
-    return null;
+function execQuiet(command) {
+  return new Promise((resolve7, reject) => {
+    exec2(command, { windowsHide: true }, (error61) => {
+      if (error61)
+        reject(error61);
+      else
+        resolve7();
+    });
+  });
+}
+async function installSkill(providerIDs, options = {}) {
+  const agentArgs = skillAgentArgs(providerIDs);
+  if (!agentArgs) {
+    logger.debug("skill", "No selected providers support the Dosu skill");
+    return { success: true };
+  }
   try {
-    const url2 = new URL(value.trim());
-    if (!url2.hostname || url2.username || url2.password || url2.search || url2.hash)
-      return null;
-    const loopbackHosts = new Set(["localhost", "127.0.0.1", "[::1]"]);
-    const secure = url2.protocol === "https:";
-    const allowedDevelopmentOrigin = allowInsecureLoopback && url2.protocol === "http:" && loopbackHosts.has(url2.hostname);
-    if (!secure && !allowedDevelopmentOrigin)
-      return null;
-    return url2.toString().replace(/\/$/, "");
-  } catch {
-    return null;
+    const command = `npx skills add ${SKILL_REPO} -g ${agentArgs} -s "*" -y`;
+    if (options.quiet)
+      await execQuiet(command);
+    else
+      execSync2(command, { stdio: "inherit" });
+  } catch (err) {
+    logger.error("skill", `Failed to install skill: ${err}`);
+    return { success: false };
+  }
+  const sha = await fetchLatestSha();
+  if (sha) {
+    writeSkillCache({
+      lastCheck: Date.now(),
+      latestSha: sha,
+      installedSha: sha
+    });
+    return { success: true, sha };
   }
+  logger.debug("skill", "Skill installed but could not fetch latest SHA");
+  return { success: true };
 }
-function parseSentryDsn(value) {
-  if (typeof value !== "string" || value.length === 0 || value.length > 2048)
-    return null;
-  const dsn = value.trim();
+function installedSkillNames() {
+  let entries;
   try {
-    const url2 = new URL(dsn);
-    if (url2.protocol !== "https:" || !url2.hostname || !url2.username || url2.password || url2.search || url2.hash || !/^[A-Za-z0-9_.-]{1,128}$/.test(url2.username) || url2.username.toLowerCase().startsWith("sntry")) {
-      return null;
-    }
-    const segments = url2.pathname.split("/").filter(Boolean);
-    const projectId = segments.pop();
-    if (!projectId || !/^[A-Za-z0-9_-]{1,128}$/.test(projectId))
-      return null;
-    if (segments.some((segment) => !/^[A-Za-z0-9._~-]{1,128}$/.test(segment)))
-      return null;
-    const prefix = segments.length > 0 ? `/${segments.join("/")}` : "";
-    return {
-      dsn,
-      endpoint: `${url2.protocol}//${url2.host}${prefix}/api/${projectId}/envelope/`,
-      projectId,
-      publicKey: url2.username
-    };
-  } catch {
+    const json2 = execSync2("npx skills list -g --json", {
+      encoding: "utf-8",
+      stdio: ["ignore", "pipe", "ignore"]
+    });
+    const parsed = JSON.parse(json2);
+    if (!Array.isArray(parsed))
+      throw new Error("expected a JSON array");
+    entries = parsed;
+  } catch (err) {
+    logger.debug("skill", `Could not list installed skills: ${err}`);
     return null;
   }
+  const names = [];
+  for (const entry of entries) {
+    if (entry.source !== SKILL_REPO || typeof entry.name !== "string")
+      continue;
+    if (!SAFE_SKILL_NAME.test(entry.name)) {
+      logger.warn("skill", `Skipping skill with an unsupported name: ${entry.name}`);
+      continue;
+    }
+    names.push(entry.name);
+  }
+  return names;
 }
-function sentryTags(command, context, runtime, error61) {
-  return {
-    schema_version: "1",
-    command,
-    cli_version: runtime.version,
-    install_channel: runtime.installChannel,
-    os: runtime.platform,
-    arch: runtime.arch,
-    runtime: runtime.runtime,
-    runtime_major: String(runtime.runtimeMajor),
-    is_ci: String(runtime.isCi),
-    is_tty: String(runtime.isTty),
-    mode: context.mode,
-    is_authenticated: String(context.isAuthenticated),
-    ...error61.code ? { error_code: error61.code } : {},
-    ...error61.status ? { http_status: String(error61.status) } : {},
-    ...error61.exitCode === undefined ? {} : { exit_code: String(error61.exitCode) }
-  };
-}
-function buildSentryEnvelope(input2) {
-  const parsedDsn = parseSentryDsn(input2.dsn);
-  if (!parsedDsn || !validEventId(input2.eventId))
-    return null;
-  const context = normalizeContext(input2.context);
-  const runtime = normalizeRuntime(input2.runtime);
-  const command = canonicalCommand(input2.command);
-  const debugId = validDebugId(input2.debugId) ? input2.debugId.toLowerCase() : undefined;
-  const error61 = {
-    type: validErrorType(input2.error.type) ? input2.error.type : "Error",
-    ...validErrorCode(input2.error.code) ? { code: input2.error.code } : {},
-    ...validStatus(input2.error.status) ? { status: input2.error.status } : {},
-    ...typeof input2.error.exitCode === "number" && Number.isFinite(input2.error.exitCode) ? { exitCode: normalizeExitCode(input2.error.exitCode) } : {},
-    frames: input2.error.frames.slice(0, MAX_STACK_FRAMES).map((frame) => {
-      const filename = /^(?:src\/(?:[A-Za-z0-9_.-]+\/)*[A-Za-z0-9_.-]+\.(?:[cm]?[jt]sx?)|bin\/dosu\.js)$/.test(frame.filename) ? frame.filename : "src/unknown.ts";
-      return {
-        filename,
-        ...debugId && filename === "bin/dosu.js" ? { abs_path: BUNDLE_CODE_FILE } : {},
-        lineno: Math.min(1e7, Math.max(1, Math.trunc(frame.lineno) || 1)),
-        colno: Math.min(1e7, Math.max(1, Math.trunc(frame.colno) || 1)),
-        in_app: true
-      };
-    }).reverse()
-  };
-  const exceptionValue = {
-    type: error61.type,
-    value: error61.code ?? error61.type,
-    ...error61.frames.length > 0 ? { stacktrace: { frames: error61.frames } } : {}
-  };
-  const newestFrame = error61.frames.at(-1);
-  const safeCallsite = newestFrame ? `${newestFrame.filename}:${newestFrame.lineno}` : "unknown";
-  const timestampMs = Number.isFinite(input2.timestampMs) ? Math.max(0, input2.timestampMs) : 0;
-  const mappedBundle = debugId && error61.frames.some((frame) => frame.abs_path === BUNDLE_CODE_FILE);
-  const event = {
-    event_id: input2.eventId.toLowerCase(),
-    timestamp: timestampMs / 1000,
-    platform: "node",
-    level: "error",
-    release: `dosu-cli@${runtime.version}`,
-    tags: sentryTags(command, context, runtime, error61),
-    ...context.user ? {
-      user: {
-        id: context.user.id,
-        ...context.user.email ? { email: context.user.email } : {}
-      }
-    } : {},
-    ...mappedBundle ? {
-      debug_meta: {
-        images: [{ type: "sourcemap", code_file: BUNDLE_CODE_FILE, debug_id: debugId }]
-      }
-    } : {},
-    fingerprint: ["dosu-cli", command, error61.type, error61.code ?? "unknown", safeCallsite],
-    exception: { values: [exceptionValue] }
-  };
-  const envelopeHeader = {
-    event_id: input2.eventId.toLowerCase(),
-    dsn: parsedDsn.dsn,
-    sent_at: new Date(timestampMs).toISOString()
-  };
-  return {
-    endpoint: parsedDsn.endpoint,
-    body: `${JSON.stringify(envelopeHeader)}
-${JSON.stringify({ type: "event" })}
-${JSON.stringify(event)}`
-  };
-}
-function fetchWithoutRedirect(url2, init = {}) {
-  let parsedURL;
-  try {
-    parsedURL = new URL(url2);
-    if (parsedURL.protocol !== "http:" && parsedURL.protocol !== "https:") {
-      return Promise.reject(new Error("unsupported telemetry protocol"));
+function skillCommand() {
+  const cmd = new Command("skill").description("Manage the Dosu agent skill");
+  cmd.command("install").description("Install the Dosu skill for AI coding agents").action(async () => {
+    console.log(`Installing skills from ${SKILL_REPO}...`);
+    const result = await installSkill();
+    if (result.success) {
+      console.log(import_picocolors24.default.green(`
+✓ Skills installed successfully.`));
+    } else {
+      console.error(import_picocolors24.default.red(`
+Failed to install skill. Make sure npx is available.`));
+      process.exit(1);
+    }
+  });
+  cmd.command("remove").description("Remove the Dosu skills").action(() => {
+    const installed = installedSkillNames();
+    if (installed?.length === 0) {
+      console.log(`No skills from ${SKILL_REPO} are installed.`);
+      return;
     }
-  } catch (error61) {
-    return Promise.reject(error61);
-  }
-  return new Promise((resolve7, reject) => {
-    let request;
-    let response;
-    let settled = false;
-    const signal = init.signal;
-    const cleanup = () => signal?.removeEventListener("abort", onAbort);
-    const fail = (error61) => {
-      if (settled)
-        return;
-      settled = true;
-      cleanup();
-      response?.destroy();
-      request?.socket?.destroy();
-      request?.destroy();
-      reject(error61);
-    };
-    const succeed = (value) => {
-      if (settled)
-        return;
-      settled = true;
-      cleanup();
-      response?.destroy();
-      request?.socket?.destroy();
-      request?.destroy();
-      resolve7(value);
-    };
-    const onAbort = () => {
-      const error61 = new Error("telemetry request aborted");
-      error61.name = "AbortError";
-      fail(error61);
-    };
+    const targets = installed ?? [SKILL_NAME];
+    console.log(`Removing skills from ${SKILL_REPO}...`);
     try {
-      if (signal?.aborted) {
-        onAbort();
-        return;
-      }
-      const body = init.body;
-      if (body !== undefined && body !== null && typeof body !== "string") {
-        fail(new Error("unsupported telemetry request body"));
-        return;
-      }
-      const headers = Object.fromEntries(new Headers(init.headers).entries());
-      const transport = parsedURL.protocol === "https:" ? httpsRequest : httpRequest2;
-      request = transport(parsedURL, {
-        method: init.method ?? "GET",
-        headers,
-        agent: false
-      }, (incoming) => {
-        response = incoming;
-        const chunks = [];
-        let totalBytes = 0;
-        incoming.on("data", (chunk) => {
-          const bytes = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
-          totalBytes += bytes.byteLength;
-          if (totalBytes > MAX_RESPONSE_BYTES) {
-            fail(new Error("telemetry response too large"));
-            return;
-          }
-          chunks.push(bytes);
-        });
-        incoming.once("error", fail);
-        incoming.once("end", () => {
-          try {
-            const responseHeaders = new Headers;
-            for (let index = 0;index < incoming.rawHeaders.length; index += 2) {
-              const name = incoming.rawHeaders[index];
-              const value = incoming.rawHeaders[index + 1];
-              if (name && value)
-                responseHeaders.append(name, value);
-            }
-            const status = incoming.statusCode;
-            if (!status)
-              throw new Error("telemetry response missing status");
-            succeed(new Response(chunks.length > 0 ? Buffer.concat(chunks) : null, {
-              status,
-              statusText: incoming.statusMessage,
-              headers: responseHeaders
-            }));
-          } catch (error61) {
-            fail(error61);
-          }
-        });
+      execSync2(`npx skills remove -g ${targets.join(" ")} -y`, {
+        stdio: "inherit"
       });
-      request.once("error", fail);
-      signal?.addEventListener("abort", onAbort, { once: true });
-      request.end(body);
-    } catch (error61) {
-      fail(error61);
+      clearInstalledSha();
+      console.log(import_picocolors24.default.green(`
+✓ Skills removed.`));
+    } catch {
+      console.error(import_picocolors24.default.red(`
+Failed to remove skills.`));
+      process.exit(1);
+    }
+  });
+  cmd.command("update").description("Update the Dosu skill to the latest version").action(async () => {
+    console.log(`Updating skills from ${SKILL_REPO}...`);
+    const result = await installSkill();
+    if (!result.success) {
+      console.error(import_picocolors24.default.red(`
+Failed to update skill.`));
+      process.exit(1);
     }
+    console.log(import_picocolors24.default.green(`
+✓ Skills updated.`));
   });
+  return cmd;
 }
-async function sendHttpsRequest(url2, init, fetcher = fetchWithoutRedirect) {
-  try {
-    if (new URL(url2).protocol !== "https:")
-      return false;
-  } catch {
+var import_picocolors24, SKILL_REPO = "dosu-ai/dosu-skill", SKILL_NAME = "dosu", SAFE_SKILL_NAME, SUPPORTED_SKILL_AGENTS, SKILL_AGENT_BY_PROVIDER;
+var init_skill = __esm(() => {
+  init_commander();
+  init_logger();
+  init_skill_update_check();
+  import_picocolors24 = __toESM(require_picocolors(), 1);
+  SAFE_SKILL_NAME = /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/;
+  SUPPORTED_SKILL_AGENTS = [
+    "claude-code",
+    "cursor",
+    "gemini-cli",
+    "codex",
+    "windsurf",
+    "zed",
+    "cline",
+    "github-copilot",
+    "opencode",
+    "antigravity"
+  ];
+  SKILL_AGENT_BY_PROVIDER = {
+    claude: "claude-code",
+    cursor: "cursor",
+    vscode: "github-copilot",
+    gemini: "gemini-cli",
+    codex: "codex",
+    windsurf: "windsurf",
+    zed: "zed",
+    cline: "cline",
+    "cline-cli": "cline",
+    copilot: "github-copilot",
+    opencode: "opencode",
+    antigravity: "antigravity"
+  };
+});
+
+// src/telemetry/settings.ts
+import { randomUUID as randomUUID4 } from "node:crypto";
+import {
+  existsSync as existsSync19,
+  lstatSync as lstatSync2,
+  mkdirSync as mkdirSync11,
+  readFileSync as readFileSync19,
+  renameSync as renameSync5,
+  unlinkSync as unlinkSync3,
+  writeFileSync as writeFileSync12
+} from "node:fs";
+import { join as join22 } from "node:path";
+function getTelemetrySettingsPath() {
+  return join22(getConfigDir(), TELEMETRY_SETTINGS_FILENAME);
+}
+function loadTelemetrySettings() {
+  return readTelemetrySettings().settings;
+}
+function setTelemetryEnabled(enabled) {
+  if (typeof enabled !== "boolean")
     return false;
-  }
-  const controller = new AbortController;
-  let timer;
-  const timeout = new Promise((_resolve, reject) => {
-    timer = setTimeout(() => {
-      controller.abort();
-      reject(new Error("telemetry request timed out"));
-    }, REQUEST_TIMEOUT_MS);
-  });
-  try {
-    const request = fetcher(url2, { ...init, redirect: "error", signal: controller.signal });
-    const result = await Promise.race([request, timeout]);
-    return result.ok;
-  } catch {
+  const current = readTelemetrySettings();
+  if (current.status === "unsupported" || current.status === "error")
     return false;
-  } finally {
-    controller.abort();
-    if (timer !== undefined)
-      clearTimeout(timer);
+  const settings2 = current.status === "current" ? current.settings : emptyTelemetrySettings();
+  if (enabled)
+    delete settings2.disabled;
+  else
+    settings2.disabled = true;
+  return writeTelemetrySettings(settings2);
+}
+function telemetryDisabledByEnvironment() {
+  if (isEnabledEnvironmentFlag(process.env.DO_NOT_TRACK))
+    return "DO_NOT_TRACK";
+  if (isEnabledEnvironmentFlag(process.env.DOSU_TELEMETRY_DISABLED)) {
+    return "DOSU_TELEMETRY_DISABLED";
   }
+  return;
 }
-function environmentFlag(value) {
-  if (value === undefined)
+function isTelemetryEnabled(settings2 = loadTelemetrySettings()) {
+  if (telemetryDisabledByEnvironment() !== undefined)
     return false;
-  const normalized = value.trim().toLowerCase();
-  return normalized !== "" && !["0", "false", "no", "off"].includes(normalized);
-}
-function runtimeNameAndMajor() {
-  const versions2 = process.versions;
-  const runtime = versions2.bun ? "bun" : "node";
-  const version2 = versions2.bun ?? versions2.node;
-  return { runtime, runtimeMajor: Number.parseInt(version2.split(".")[0] ?? "0", 10) || 0 };
+  return settings2.disabled !== true;
 }
-function resolveRuntime(dependencies, env) {
-  const detected = runtimeNameAndMajor();
-  return normalizeRuntime({
-    version: dependencies.version ?? VERSION,
-    installChannel: dependencies.installChannel ?? INSTALL_CHANNEL,
-    platform: dependencies.platform ?? process.platform,
-    arch: dependencies.arch ?? process.arch,
-    runtime: dependencies.runtime ?? detected.runtime,
-    runtimeMajor: dependencies.runtimeMajor ?? detected.runtimeMajor,
-    isCi: dependencies.isCi ?? environmentFlag(env.CI),
-    isTty: dependencies.isTty ?? process.stdout.isTTY === true
-  });
+function getOrCreateInstallID() {
+  const current = readTelemetrySettings();
+  if (current.status === "current" && current.settings.install_id) {
+    return current.settings.install_id;
+  }
+  if (current.status !== "current" && current.status !== "missing")
+    return;
+  const installID = randomUUID4();
+  const settings2 = current.status === "current" ? current.settings : emptyTelemetrySettings();
+  settings2.install_id = installID;
+  return writeTelemetrySettings(settings2) ? installID : undefined;
 }
-function validationFailure(exitCode, error61) {
-  if (exitCode === 2)
-    return true;
-  if (error61?.type === "CliUsageError")
-    return true;
-  if (!error61?.code)
-    return false;
-  return error61.code.startsWith("commander.") || ["BAD_REQUEST", "INVALID_ARGUMENT", "UNPROCESSABLE_CONTENT", "VALIDATION_ERROR"].includes(error61.code);
+function resetInstallID() {
+  const current = readTelemetrySettings();
+  if (current.status !== "current" && current.status !== "missing")
+    return;
+  const settings2 = current.status === "current" ? current.settings : emptyTelemetrySettings();
+  const installID = randomUUID4();
+  settings2.install_id = installID;
+  return writeTelemetrySettings(settings2) ? installID : undefined;
 }
-function safeNow(now) {
+function readTelemetrySettings() {
+  const path3 = getTelemetrySettingsPath();
+  let file2;
   try {
-    const value = now();
-    return Number.isFinite(value) ? Math.max(0, value) : 0;
+    file2 = lstatSync2(path3);
+  } catch (error61) {
+    if (isErrorCode(error61, "ENOENT")) {
+      return { status: "missing", settings: emptyTelemetrySettings() };
+    }
+    return { status: "error", settings: disabledTelemetrySettings() };
+  }
+  if (!file2.isFile() || file2.size > MAX_TELEMETRY_SETTINGS_BYTES) {
+    return { status: "invalid", settings: disabledTelemetrySettings() };
+  }
+  let content;
+  try {
+    content = readFileSync19(path3, "utf-8");
   } catch {
-    return 0;
+    return { status: "error", settings: disabledTelemetrySettings() };
   }
-}
-function safeUuid(generate) {
+  let raw;
   try {
-    const value = generate();
-    return isUUID2(value) ? value : undefined;
+    raw = JSON.parse(content);
   } catch {
-    return;
+    return { status: "invalid", settings: disabledTelemetrySettings() };
   }
-}
-function eventId(generate) {
-  const uuid5 = safeUuid(generate);
-  return uuid5?.replaceAll("-", "");
-}
-function createCommandTelemetry(settings2, dependencies = {}) {
-  const env = dependencies.env ?? process.env;
-  const fetcher = dependencies.fetch;
-  const now = dependencies.now ?? Date.now;
-  const generateUuid = dependencies.randomUUID ?? randomUUID4;
-  const writeStderr = dependencies.stderr ?? ((payload) => process.stderr.write(`${payload}
-`));
-  const webAppURL = dependencies.webAppURL ?? getWebAppURL;
-  const runtime = resolveRuntime(dependencies, env);
-  const debug = env.DOSU_TELEMETRY_DEBUG === "1";
-  const disabled = settings2.disabled === true || environmentFlag(env.DO_NOT_TRACK) || environmentFlag(env.DOSU_TELEMETRY_DISABLED);
-  const rawAnalyticsToken = dependencies.env ? env.DOSU_POSTHOG_PROJECT_TOKEN_OVERRIDE ?? env.DOSU_POSTHOG_PROJECT_TOKEN : process.env.DOSU_POSTHOG_PROJECT_TOKEN_OVERRIDE ?? "phc_Uo9RxhN0HRk8gZkPlT18BCr7eqsM0MPWVW88HZB95V5";
-  const rawSentryDsn = dependencies.env ? env.DOSU_CLI_SENTRY_DSN_OVERRIDE ?? env.DOSU_CLI_SENTRY_DSN : process.env.DOSU_CLI_SENTRY_DSN_OVERRIDE ?? "https://f6b3e51dea6f50746316aa1896df76e0@o4505364738670592.ingest.us.sentry.io/4511883653283840";
-  const analyticsToken = parsePostHogProjectToken(rawAnalyticsToken) ?? undefined;
-  const sentryDsn = parseSentryDsn(rawSentryDsn)?.dsn;
-  let started = false;
-  let terminal = false;
-  let startedAt = 0;
-  let command = UNKNOWN_COMMAND;
-  let context = normalizeContext(undefined);
-  let installIdResolved = false;
-  let resolvedInstallId = settings2.install_id;
-  function installId() {
-    if (isUUID2(resolvedInstallId))
-      return resolvedInstallId;
-    if (installIdResolved)
-      return;
-    installIdResolved = true;
-    try {
-      resolvedInstallId = dependencies.resolveInstallId?.();
-    } catch {
-      resolvedInstallId = undefined;
-    }
-    return isUUID2(resolvedInstallId) ? resolvedInstallId : undefined;
+  if (!isRecord5(raw))
+    return { status: "invalid", settings: disabledTelemetrySettings() };
+  if (raw.schema_version !== TELEMETRY_SCHEMA_VERSION) {
+    const status = "schema_version" in raw ? "unsupported" : "invalid";
+    return { status, settings: disabledTelemetrySettings() };
   }
-  function debugPayload(payload) {
-    try {
-      writeStderr(payload);
-    } catch {}
+  if ("disabled" in raw && typeof raw.disabled !== "boolean") {
+    return { status: "invalid", settings: disabledTelemetrySettings() };
+  }
+  const settings2 = emptyTelemetrySettings();
+  if (raw.disabled === true)
+    settings2.disabled = true;
+  if (typeof raw.install_id === "string" && isUUID2(raw.install_id)) {
+    settings2.install_id = raw.install_id;
   }
-  async function dispatch(result, exitCode, error61) {
+  return { status: "current", settings: settings2 };
+}
+function writeTelemetrySettings(settings2) {
+  const path3 = getTelemetrySettingsPath();
+  const dir = getConfigDir();
+  const temporaryPath = `${path3}.${process.pid}.${randomUUID4()}.tmp`;
+  try {
+    if (!existsSync19(dir))
+      mkdirSync11(dir, { recursive: true, mode: 448 });
+    writeFileSync12(temporaryPath, `${JSON.stringify(settings2, null, 2)}
+`, {
+      flag: "wx",
+      mode: 384
+    });
+    renameSync5(temporaryPath, path3);
+    return true;
+  } catch {
     try {
-      const tasks = [];
-      if (!disabled && analyticsToken) {
-        const id2 = context.user?.id ?? installId();
-        if (id2) {
-          const payload = buildPostHogPayload({
-            apiKey: analyticsToken,
-            ...context.user ? {} : { installId: id2 },
-            command,
-            result,
-            durationMs: safeNow(now) - startedAt,
-            exitCode,
-            errorCode: error61?.code,
-            context,
-            runtime
-          });
-          const body = JSON.stringify(payload);
-          if (debug) {
-            debugPayload(body);
-          } else {
-            const base = parseTelemetryWebAppURL(webAppURL());
-            if (base) {
-              tasks.push(sendHttpsRequest(`${base}/ph-api/i/v0/e/`, {
-                method: "POST",
-                headers: { "content-type": "application/json" },
-                body
-              }, fetcher));
-            }
-          }
-        }
-      }
-      if (!disabled && result === "failure" && error61 && shouldSendToSentry(error61) && sentryDsn) {
-        const id2 = eventId(generateUuid);
-        const envelope = id2 ? buildSentryEnvelope({
-          dsn: sentryDsn,
-          command,
-          context,
-          runtime,
-          error: error61,
-          eventId: id2,
-          timestampMs: safeNow(now),
-          debugId: BUNDLE_DEBUG_ID_PLACEHOLDER
-        }) : null;
-        if (envelope) {
-          if (debug) {
-            debugPayload(envelope.body);
-          } else {
-            tasks.push(sendHttpsRequest(envelope.endpoint, {
-              method: "POST",
-              headers: { "content-type": "application/x-sentry-envelope" },
-              body: envelope.body
-            }, fetcher));
-          }
-        }
-      }
-      await Promise.all(tasks);
+      unlinkSync3(temporaryPath);
     } catch {}
+    return false;
   }
-  return {
-    start(commandName, commandContext) {
-      if (started || terminal)
-        return;
-      started = true;
-      command = canonicalCommand(commandName);
-      context = normalizeContext(commandContext);
-      startedAt = safeNow(now);
-    },
-    async complete(exitCode = 0) {
-      if (!started || terminal)
-        return;
-      terminal = true;
-      const normalizedExitCode = normalizeExitCode(exitCode, 0);
-      const result = normalizedExitCode === 0 ? "success" : validationFailure(normalizedExitCode, undefined) ? "validation_error" : "failure";
-      const error61 = result === "failure" ? { type: "CommandExitError", frames: [], exitCode: normalizedExitCode } : undefined;
-      await dispatch(result, normalizedExitCode, error61);
-    },
-    async fail(rawError) {
-      if (!started || terminal)
-        return;
-      terminal = true;
-      const error61 = sanitizeError(rawError);
-      const exitCode = error61.exitCode ?? 1;
-      const result = validationFailure(exitCode, error61) ? "validation_error" : "failure";
-      await dispatch(result, exitCode, error61);
-    }
-  };
 }
-function shouldSendToSentry(error61) {
-  return !["SESSION_EXPIRED", "SESSION_PERSISTENCE_ERROR"].includes(error61.code ?? "");
+function emptyTelemetrySettings() {
+  return { schema_version: TELEMETRY_SCHEMA_VERSION };
 }
-var REQUEST_TIMEOUT_MS = 500, MAX_RESPONSE_BYTES, MAX_STACK_FRAMES = 20, UNKNOWN_COMMAND = "unknown", FALLBACK_INSTALL_ID = "00000000-0000-4000-8000-000000000000", BUNDLE_CODE_FILE = "app:///bin/dosu.js", CLI_PACKAGE_ROOT, SAFE_ERROR_TYPES, SAFE_ERROR_CODES;
-var init_telemetry = __esm(() => {
-  MAX_RESPONSE_BYTES = 1024 * 1024;
-  CLI_PACKAGE_ROOT = detectCliPackageRoot();
-  SAFE_ERROR_TYPES = new Set([
-    "AbortError",
-    "AggregateError",
-    "CommanderError",
-    "CliUsageError",
-    "CommandExitError",
-    "Error",
-    "OAuthCallbackError",
-    "RangeError",
-    "ReferenceError",
-    "SessionExpiredError",
-    "SessionPersistenceError",
-    "SessionRefreshError",
-    "SyntaxError",
-    "TRPCClientError",
-    "TypeError"
-  ]);
-  SAFE_ERROR_CODES = new Set([
-    "ABORT_ERR",
-    "BAD_GATEWAY",
-    "BAD_REQUEST",
-    "CLIENT_CLOSED_REQUEST",
-    "CONFLICT",
-    "EACCES",
-    "EAI_AGAIN",
-    "EBUSY",
-    "ECONNREFUSED",
-    "ECONNRESET",
-    "EEXIST",
-    "EHOSTUNREACH",
-    "EINVAL",
-    "EISDIR",
-    "ELOOP",
-    "EMFILE",
-    "ENAMETOOLONG",
-    "ENETUNREACH",
-    "ENFILE",
-    "ENOENT",
-    "ENOMEM",
-    "ENOSPC",
-    "ENOTFOUND",
-    "ENOTDIR",
-    "EPIPE",
-    "EPERM",
-    "EROFS",
-    "ETIMEDOUT",
-    "FORBIDDEN",
-    "GATEWAY_TIMEOUT",
-    "IMPORT_ALREADY_IN_PROGRESS",
-    "INTERNAL_SERVER_ERROR",
-    "INVALID_ARGUMENT",
-    "METHOD_NOT_SUPPORTED",
-    "NOT_FOUND",
-    "NOT_IMPLEMENTED",
-    "PARSE_ERROR",
-    "PAYLOAD_TOO_LARGE",
-    "PAYMENT_REQUIRED",
-    "PRECONDITION_FAILED",
-    "SERVICE_UNAVAILABLE",
-    "SESSION_EXPIRED",
-    "SESSION_PERSISTENCE_ERROR",
-    "SESSION_REFRESH_ERROR",
-    "TIMEOUT",
-    "TOO_MANY_REQUESTS",
-    "UNAUTHORIZED",
-    "UNPROCESSABLE_CONTENT",
-    "UNSUPPORTED_MEDIA_TYPE",
-    "VALIDATION_ERROR",
-    "commander.conflictingOption",
-    "commander.error",
-    "commander.excessArguments",
-    "commander.invalidArgument",
-    "commander.missingArgument",
-    "commander.missingMandatoryOptionValue",
-    "commander.optionMissingArgument",
-    "commander.unknownCommand",
-    "commander.unknownOption"
-  ]);
+function disabledTelemetrySettings() {
+  return { schema_version: TELEMETRY_SCHEMA_VERSION, disabled: true };
+}
+function isEnabledEnvironmentFlag(value) {
+  if (value === undefined)
+    return false;
+  const normalized = value.trim().toLowerCase();
+  if (normalized === "")
+    return false;
+  return !["0", "false", "no", "off"].includes(normalized);
+}
+function isUUID2(value) {
+  return /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value);
+}
+function isRecord5(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isErrorCode(error61, code) {
+  return typeof error61 === "object" && error61 !== null && "code" in error61 && error61.code === code;
+}
+var TELEMETRY_SCHEMA_VERSION = 1, TELEMETRY_SETTINGS_FILENAME = "telemetry.json", MAX_TELEMETRY_SETTINGS_BYTES;
+var init_settings = __esm(() => {
+  init_config();
+  MAX_TELEMETRY_SETTINGS_BYTES = 16 * 1024;
 });
 
 // src/debug/follow.ts
@@ -77048,6 +77129,7 @@ async function stepOfferInitialSync(cfg) {
   const outcome = await runKnowledgeSync({ bootstrap: true });
   if (outcome.status !== "backlog" || outcome.readySessions === 0) {
     s.stop("No past agent sessions to study. Dosu will learn from new ones as you work.");
+    recordCommandFacets({ backfill_offer: "not-offered" });
     return;
   }
   const n5 = outcome.readySessions;
@@ -77067,10 +77149,12 @@ async function stepOfferInitialSync(cfg) {
     initialValue: true
   });
   if (isCancel2(mineNow) || !mineNow) {
+    recordCommandFacets({ backfill_offer: isCancel2(mineNow) ? "cancelled" : "declined" });
     log2.info(`Skipped. Dosu studies new sessions in the background as you work; run ${info("dosu knowledge sync")} anytime to study these too.`);
     return;
   }
   if (spawnDetachedSelf(["knowledge", "sync", "--quiet", "--bootstrap"])) {
+    recordCommandFacets({ backfill_offer: "accepted" });
     log2.success(`\uD83D\uDCDA Studying ${n5} session${n5 === 1 ? "" : "s"} in the background. Watch progress on the Activity screen; when it finishes, the new notes are in Dosu and agents connected to this MCP can use them.`);
     const watch = await confirm2({
       message: "What next?",
@@ -77081,6 +77165,7 @@ async function stepOfferInitialSync(cfg) {
     if (!isCancel2(watch) && watch)
       await runActivityView();
   } else {
+    recordCommandFacets({ backfill_offer: "spawn-failed" });
     log2.warn(`Could not start the background sync. Run ${info("dosu knowledge sync")} manually.`);
   }
 }
@@ -77818,6 +77903,7 @@ var init_flow2 = __esm(() => {
   init_providers();
   init_detach();
   init_sync();
+  init_telemetry();
   init_activity_view();
   init_layout();
   init_prompts();
@@ -82665,8 +82751,9 @@ init_detach();
 init_status();
 init_sync();
 init_watermark();
+init_telemetry();
 var import_picocolors18 = __toESM(require_picocolors(), 1);
-import { existsSync as existsSync16 } from "node:fs";
+import { existsSync as existsSync17 } from "node:fs";
 import { homedir as homedir5 } from "node:os";
 import { delimiter as delimiter4, join as join19 } from "node:path";
 function requireConfig7() {
@@ -82776,7 +82863,9 @@ ${results.length - opts.limit} more results not shown.`));
     }
   });
   cmd.command("sync").description("Scan local agent session history and report the study backlog").option("--quiet", "Background mode for hooks: honor backoff, exit 0, print nothing").option("--detach", "Re-spawn detached and return immediately (used by agent hooks)").option("--bootstrap", "Backfill mode: study the full local session history regardless of age and drain the backlog (used by setup)").option("--status", "Show whether a sync is running now, plus watermark and recent activity").option("--report", "Write the same HTML harvest report as the log-to-dosu-knowledge skill and open it").option("--out <path>", "HTML report path (default: tmp/dosu-knowledge-report.html)").option("--json", "Output as JSON").action(async (opts) => {
+    const trigger = opts.bootstrap ? "bootstrap" : opts.quiet ? "hook" : "manual";
     if (opts.status) {
+      recordCommandFacets({ sync_trigger: trigger, sync_status: "status-only" });
       const status = getSyncStatus();
       if (opts.json) {
         printResult(status, opts);
@@ -82786,7 +82875,7 @@ ${results.length - opts.limit} more results not shown.`));
       return;
     }
     if (opts.detach) {
-      spawnDetachedSelf([
+      const spawned = spawnDetachedSelf([
         "knowledge",
         "sync",
         ...opts.quiet ? ["--quiet"] : [],
@@ -82794,6 +82883,10 @@ ${results.length - opts.limit} more results not shown.`));
         ...opts.report ? ["--report"] : [],
         ...opts.out ? ["--out", opts.out] : []
       ]);
+      recordCommandFacets({
+        sync_trigger: trigger,
+        sync_status: spawned ? "detached" : "detach-failed"
+      });
       return;
     }
     const deps = { mine: buildLearner(opts.quiet ? "hook" : "manual") };
@@ -82802,14 +82895,25 @@ ${results.length - opts.limit} more results not shown.`));
       bootstrap: opts.bootstrap,
       deps
     });
+    let sessionsStudied = outcome.studiedSessions ?? 0;
+    let notesWritten = outcome.learner?.notesWritten ?? 0;
     if (opts.bootstrap && deps.mine) {
       const maxRounds = Math.ceil(outcome.readySessions / MINE_BATCH_LIMIT) + 2;
       for (let round = 1;outcome.status === "studied" && round < maxRounds; round++) {
         if (!opts.quiet && !opts.json)
           printSyncOutcome(outcome);
         outcome = await runKnowledgeSync({ quiet: opts.quiet, bootstrap: true, deps });
+        sessionsStudied += outcome.studiedSessions ?? 0;
+        notesWritten += outcome.learner?.notesWritten ?? 0;
       }
     }
+    recordCommandFacets({
+      sync_trigger: trigger,
+      sync_status: outcome.status,
+      sessions_studied: sessionsStudied,
+      notes_written: notesWritten,
+      ...outcome.learner ? { learner_outcome: outcome.learner.outcome } : {}
+    });
     if (opts.quiet)
       return;
     if (opts.json) {
@@ -83079,7 +83183,7 @@ function reportHookFailure(agent, err) {
 }
 function dosuOnPath() {
   const bin = process.platform === "win32" ? "dosu.cmd" : "dosu";
-  return (process.env.PATH ?? "").split(delimiter4).some((dir) => dir !== "" && existsSync16(join19(dir, bin)));
+  return (process.env.PATH ?? "").split(delimiter4).some((dir) => dir !== "" && existsSync17(join19(dir, bin)));
 }
 
 // src/commands/libraries.ts
@@ -83871,8 +83975,8 @@ function sourcesCommand() {
         }
         console.log(import_picocolors25.default.dim("Waiting for the install to complete..."));
       }
-      const timedOut = new Promise((resolve6) => {
-        timeoutId = setTimeout(() => resolve6(null), timeoutSeconds * 1000);
+      const timedOut = new Promise((resolve7) => {
+        timeoutId = setTimeout(() => resolve7(null), timeoutSeconds * 1000);
       });
       const result = await Promise.race([installationPromise, timedOut]);
       if (result === null) {
@@ -84988,4 +85092,4 @@ execute().catch((err) => {
   process.exit(1);
 });
 
-//# debugId=5776df20-501e-ff5f-6475-6e2164756e21
+//# debugId=d4304c43-c40e-f448-6475-6e2164756e21