@hireobi/cli 0.1.8 → 0.1.10

package/dist/obi.js

@@ -14618,6 +14618,7 @@ var optionDefinitions = {
   "field-path": { type: "string" },
   "segment-name": { type: "string" },
   text: { type: "string" },
+  tag: { type: "string" },
   company: { type: "string" },
   "company-unknown": { type: "boolean" },
   product: { type: "string" },
@@ -14632,7 +14633,7 @@ var optionDefinitions = {
   help: { type: "boolean" },
   version: { type: "boolean" }
 };
-var namedCommands = ["business", "capabilities", "credentials", "doctor", "eval", "harness", "login", "logout", "memory", "questions", "readiness", "research", "skill", "status", "strategies"];
+var namedCommands = ["business", "capabilities", "credentials", "doctor", "eval", "harness", "login", "logout", "memory", "questions", "readiness", "research", "skill", "status", "strategies", "support"];
 var memoryKinds = ["preference", "constraint", "decision"];
 var credentialsActions = ["list", "revoke"];
 var emailSchema = external_exports.email().max(254);
@@ -14651,6 +14652,8 @@ var CliError = class extends Error {
   command;
   authorization;
   account;
+  /** The message `obi support` could not send, with the block to paste. */
+  support;
   constructor(options) {
     super(options.message);
     this.name = "CliError";
@@ -14662,6 +14665,7 @@ var CliError = class extends Error {
     this.command = options.command;
     this.authorization = options.authorization;
     this.account = options.account;
+    this.support = options.support;
   }
 };
 function usageError(message = "Invalid command usage.", options = {}) {
@@ -15174,6 +15178,52 @@ function parseMemoryArguments(positionals, values, context, common2) {
   throw invalid3();
 }
 
+// src/support-contract.ts
+var SUPPORT_EMAIL = "support@hireobi.com";
+var SUPPORT_TAGS = ["market-request", "scope-request"];
+var lastErrorSchema = external_exports.strictObject({
+  code: external_exports.string().regex(/^[A-Z][A-Z0-9_]{0,79}$/),
+  command: external_exports.string().regex(/^[a-z][a-z-]{0,39}$/),
+  at: external_exports.iso.datetime({ offset: true })
+});
+var SupportMessageSchema = external_exports.strictObject({
+  requestId: external_exports.string().regex(/^[0-9a-f]{32}$/),
+  message: external_exports.string().trim().min(1).max(2e3),
+  tag: external_exports.enum(SUPPORT_TAGS).nullable(),
+  diagnostic: external_exports.strictObject({
+    cliVersion: external_exports.string().min(1).max(40),
+    node: external_exports.string().min(1).max(40),
+    os: external_exports.string().min(1).max(120),
+    lastError: lastErrorSchema.nullable()
+  })
+});
+var SupportMessageResponseSchema = external_exports.object({
+  schemaVersion: external_exports.literal(1),
+  data: external_exports.object({ received: external_exports.literal(true) })
+});
+var supportDataSchema = external_exports.object({
+  delivery: external_exports.enum(["sent", "not_sent"]),
+  /** Why nothing was sent: the error code met, null once sent. */
+  reason: external_exports.string().nullable(),
+  supportEmail: external_exports.literal(SUPPORT_EMAIL),
+  mailto: external_exports.string(),
+  tag: external_exports.enum(SUPPORT_TAGS).nullable(),
+  account: external_exports.string().nullable(),
+  origin: external_exports.string().min(1),
+  diagnosticText: external_exports.string()
+});
+
+// src/support-arguments.ts
+function parseSupportArguments(positionals, values, context, common2) {
+  const allowed = /* @__PURE__ */ new Set(["json", "timeout-ms", "tag"]);
+  const message = positionals[1]?.trim() ?? "";
+  const tag = values.tag;
+  if (Object.entries(values).some(([key, value]) => value !== void 0 && value !== false && !allowed.has(key)) || positionals.length !== 2 || message.length === 0 || message.length > 2e3 || tag !== void 0 && !SUPPORT_TAGS.includes(tag)) {
+    throw usageError(`Use support "<message of at most 2000 characters>" [--tag ${SUPPORT_TAGS.join("|")}].`, context);
+  }
+  return { command: "support", supportMessage: message, ...tag === void 0 ? {} : { supportTag: tag }, ...common2 };
+}
+
 // src/research-arguments.ts
 function parseResearchScope(values, context) {
   const locale = values.locale;
@@ -15576,7 +15626,7 @@ function commandMode(command, testServer) {
   if (testServer) {
     return "test";
   }
-  return command === "login" || command === "logout" || command === "status" || command === "credentials" || command === "eval" || command === "harness" || command === "business" || command === "questions" || command === "strategies" || command === "readiness" || command === "memory" ? "product" : "local";
+  return command === "login" || command === "logout" || command === "status" || command === "credentials" || command === "eval" || command === "harness" || command === "business" || command === "questions" || command === "strategies" || command === "readiness" || command === "memory" || command === "support" ? "product" : "local";
 }
 function errorContext(argv) {
   const usesTestServer = argv.some(
@@ -15762,6 +15812,8 @@ function parseCommandArguments(argv) {
     throw usageError("Use research crawl <domain> --checkpoint <file> --output <file> [--batch-size <1-100>] [--locale <tag>] [--pages priority|all] [--max-pages <n|none>] [--retry-failed|--refresh], research capture --input <selected-page-file> --checkpoint <file> --output <corpus-file>, research readiness --input <file> --output <file>, or research video <url> --output <directory> [--frames <0-30>].", context);
   }
   if (positionals[0] === "memory") return parseMemoryArguments(positionals, values, context, { evaluationCaseId, json: json2, timeoutMs });
+  if (positionals[0] === "support") return parseSupportArguments(positionals, values, context, { json: json2, timeoutMs });
+  if (values.tag !== void 0) throw usageError("--tag is only valid with obi support.", context);
   if (stage !== void 0 || input !== void 0 || output !== void 0 || checkpoint !== void 0 || batchSize !== void 0 || retryFailed || refresh || scopeFlagsUsed || values.frames !== void 0 || free || evidenceOptionsUsed) {
     throw usageError("--stage and --input are only valid with obi harness.", context);
   }
@@ -15856,9 +15908,6 @@ function parseCommandArguments(argv) {
   }
   if (command === "doctor") {
     if (evaluationCaseId !== void 0) throw usageError("Doctor cannot use --eval-case.", context);
-    if (timeoutValue !== void 0 && testServer === void 0) {
-      throw usageError("A timeout is only valid with a test server.", context);
-    }
     return { command, json: json2, testServer, timeoutMs };
   }
   if (command === "status") {
@@ -16587,14 +16636,78 @@ var BusinessItemReviewRequestSchema = external_exports.discriminatedUnion("decis
   })
 ]);
 
+// ../shared/lib/geo/markets.ts
+var SUPPORTED_MARKETS = [
+  { iso: "US", name: "United States" },
+  { iso: "CA", name: "Canada" },
+  { iso: "GB", name: "United Kingdom" },
+  { iso: "FR", name: "France" },
+  { iso: "DE", name: "Germany" },
+  { iso: "ES", name: "Spain" },
+  { iso: "IT", name: "Italy" },
+  { iso: "NL", name: "Netherlands" },
+  { iso: "BE", name: "Belgium" },
+  { iso: "CH", name: "Switzerland" },
+  { iso: "AU", name: "Australia" },
+  { iso: "SA", name: "Saudi Arabia" },
+  { iso: "AE", name: "UAE" },
+  { iso: "QA", name: "Qatar" },
+  { iso: "KW", name: "Kuwait" }
+];
+var BY_KEY = new Map(
+  SUPPORTED_MARKETS.flatMap((market) => [
+    [market.iso.toLowerCase(), market],
+    [market.name.toLowerCase(), market]
+  ])
+);
+var SUPPORTED_MARKET_NAMES = SUPPORTED_MARKETS.map(
+  (market) => market.name
+);
+
+// ../shared/lib/cli-version.ts
+var CLI_VERSION_HEADER = "x-obi-cli-version";
+var CLI_UPDATE_COMMAND = "npm i -g @hireobi/cli";
+var release = /^(0|[1-9][0-9]{0,8})\.(0|[1-9][0-9]{0,8})\.(0|[1-9][0-9]{0,8})$/;
+function parseRelease(version3) {
+  const match = release.exec(version3);
+  return match === null ? null : [Number(match[1]), Number(match[2]), Number(match[3])];
+}
+function isOlderRelease(version3, other) {
+  const left = parseRelease(version3);
+  const right = parseRelease(other);
+  if (left === null || right === null) return false;
+  for (let index = 0; index < 3; index += 1) {
+    if (left[index] !== right[index]) return left[index] < right[index];
+  }
+  return false;
+}
+
+// src/version.ts
+var cliVersion = "0.1.10";
+
 // src/product-api-failures.ts
+var versionHeaders = { [CLI_VERSION_HEADER]: cliVersion };
+function updateRequiredError() {
+  return new CliError({
+    code: "CLI_UPDATE_REQUIRED",
+    message: `This Obi CLI (${cliVersion}) is too old for the Obi service.`,
+    exitCode: 7,
+    retryable: false,
+    nextAction: `Run ${CLI_UPDATE_COMMAND}, then run obi once to refresh the Skill, and try again.`,
+    mode: "product"
+  });
+}
+function apiFailure(code, httpStatus, retryAfterSeconds) {
+  if (code === "CLI_UPDATE_REQUIRED") throw updateRequiredError();
+  return { ok: false, failure: { code, httpStatus, retryAfterSeconds } };
+}
 function transportError(code, message, exitCode, retryable) {
   return new CliError({
     code,
     message,
     exitCode,
     retryable,
-    nextAction: exitCode === 6 ? "Check the network connection and try again." : "Update the Obi CLI, then try again.",
+    nextAction: exitCode === 6 ? `Check the network connection and try again. If it keeps failing, run obi support "<what happened>" or write to ${SUPPORT_EMAIL} with the command you ran and the error code ${code}.` : "Update the Obi CLI, then try again.",
     mode: "product"
   });
 }
@@ -16624,6 +16737,14 @@ function failureError(failure2, evaluationCaseId) {
     mode: "product",
     nextAction: `Run obi business show${scope} --json and read the current work before preparing a new result.`
   });
+  if (failure2.code === "MARKET_UNSUPPORTED") return new CliError({
+    code: failure2.code,
+    message: "Obi does not measure this market yet.",
+    exitCode: 5,
+    retryable: false,
+    mode: "product",
+    nextAction: `Obi measures in: ${SUPPORTED_MARKET_NAMES.join(", ")}. Choose one of them with the customer, or record the request with obi support "<market and domain>" --tag market-request.`
+  });
   if (failure2.code === "RATE_LIMITED") {
     const wait = failure2.retryAfterSeconds === null ? "a moment" : `${failure2.retryAfterSeconds} seconds`;
     return new CliError({
@@ -17209,11 +17330,13 @@ var pendingAuthorizationViewSchema = external_exports.object({
 var originMarker = {
   origin: external_exports.string().min(1).max(200).optional(),
   development: external_exports.literal(true).optional(),
-  evaluationCaseId: external_exports.uuid().optional()
+  evaluationCaseId: external_exports.uuid().optional(),
+  // Set when npm holds a newer CLI than this one (cli/src/update-check.ts).
+  update: external_exports.object({ installed: external_exports.string().max(32), latest: external_exports.string().max(32), command: external_exports.string().max(80) }).optional()
 };
 var helpDataSchema = external_exports.object({
   usage: external_exports.string(),
-  commands: external_exports.array(external_exports.enum(["business", "capabilities", "credentials", "doctor", "eval", "harness", "login", "logout", "memory", "questions", "readiness", "research", "skill", "status", "strategies"]))
+  commands: external_exports.array(external_exports.enum(["business", "capabilities", "credentials", "doctor", "eval", "harness", "login", "logout", "memory", "questions", "readiness", "research", "skill", "status", "strategies", "support"]))
 });
 var versionDataSchema = external_exports.object({ version: external_exports.string() });
 var skillDataSchema = external_exports.discriminatedUnion("action", [
@@ -17223,6 +17346,13 @@ var skillDataSchema = external_exports.discriminatedUnion("action", [
 var capabilitiesDataSchema = external_exports.object({
   expertise: external_exports.object({ manifestVersion: external_exports.string(), competencies: external_exports.array(external_exports.object({ id: external_exports.string(), reference: external_exports.string(), sha256: external_exports.string(), reviewedOn: external_exports.string(), sources: external_exports.array(external_exports.string()) })) }).optional(),
   version: external_exports.string(),
+  measurementMarkets: external_exports.array(external_exports.object({ iso: external_exports.string().length(2), name: external_exports.string().min(1) })),
+  catalog: external_exports.object({ version: external_exports.string(), currency: external_exports.literal("usd"), monthlyCents: external_exports.object({
+    corePack: external_exports.number().int().positive(),
+    claudePerPack: external_exports.number().int().positive(),
+    perplexityPerPack: external_exports.number().int().positive()
+  }) }),
+  support: external_exports.object({ email: external_exports.literal(SUPPORT_EMAIL) }),
   realLogin: external_exports.literal("available"),
   paidExecution: external_exports.literal("server_authorized"),
   commands: external_exports.object({
@@ -17240,15 +17370,21 @@ var capabilitiesDataSchema = external_exports.object({
     memory: external_exports.object({ actions: external_exports.array(external_exports.string()), options: external_exports.array(external_exports.string()) }).optional(),
     status: external_exports.object({ options: external_exports.array(external_exports.string()) }),
     readiness: external_exports.object({ options: external_exports.array(external_exports.string()) }),
-    strategies: external_exports.object({ options: external_exports.array(external_exports.string()) })
+    strategies: external_exports.object({ options: external_exports.array(external_exports.string()) }),
+    support: external_exports.object({ tags: external_exports.array(external_exports.enum(SUPPORT_TAGS)), options: external_exports.array(external_exports.string()) })
   })
 });
 var localDoctorDataSchema = external_exports.object({
   node: external_exports.string(),
   cliVersion: external_exports.string(),
+  latestVersion: external_exports.string().nullable(),
+  // Set only when npm could not be reached: the last version it named.
+  lastKnownVersion: external_exports.string().nullable(),
+  updateCheck: external_exports.enum(["on", "off"]),
   origin: external_exports.string(),
   credentialStorage: external_exports.union([backendKindSchema, external_exports.literal("none")]),
   videoTools: external_exports.object({ ytDlp: external_exports.boolean(), ffmpeg: external_exports.boolean() }),
+  server: external_exports.enum(["reachable", "degraded", "unreachable"]),
   diagnostic: external_exports.literal("completed")
 });
 var loginDataSchema = external_exports.object({
@@ -17545,6 +17681,7 @@ var successfulResultSchema = external_exports.union([
   external_exports.object({ ...envelope2, command: external_exports.literal("harness"), mode: external_exports.literal("product"), data: harnessCoverageDataSchema }),
   ...harnessEvidenceDataSchema.map((schema) => external_exports.object({ ...envelope2, command: external_exports.literal("harness"), mode: external_exports.literal("product"), data: schema })),
   external_exports.object({ ...envelope2, command: external_exports.literal("harness"), mode: external_exports.literal("product"), data: harnessEvidenceExportDataSchema }),
+  external_exports.object({ ...envelope2, command: external_exports.literal("support"), mode: external_exports.literal("product"), data: supportDataSchema }),
   external_exports.object({ ...envelope2, command: external_exports.literal("memory"), mode: external_exports.literal("product"), data: memoryListDataSchema }),
   external_exports.object({ ...envelope2, command: external_exports.literal("memory"), mode: external_exports.literal("product"), data: memoryChangeDataSchema }),
   external_exports.object({
@@ -17595,7 +17732,8 @@ var failedResultSchema = external_exports.object({
   ...originMarker,
   error: errorSchema,
   authorization: pendingAuthorizationViewSchema.optional(),
-  account: confirmedAccountSchema.optional()
+  account: confirmedAccountSchema.optional(),
+  support: supportDataSchema.optional()
 });
 var cliResultSchema = external_exports.union([successfulResultSchema, failedResultSchema]);
 
@@ -17684,7 +17822,7 @@ function retryAfter(response) {
   return typeof value === "string" && /^[0-9]{1,5}$/.test(value) ? Number(value) : null;
 }
 async function send(context, request) {
-  const headers2 = { accept: "application/json" };
+  const headers2 = { accept: "application/json", ...versionHeaders };
   if (request.body !== void 0) {
     headers2["content-type"] = "application/json";
   }
@@ -17894,12 +18032,7 @@ function interpret(response, schema) {
     return { ok: true, data: parsed.data.data };
   }
   const failure2 = ProductApiErrorResponseSchema.safeParse(body);
-  if (failure2.success) {
-    return {
-      ok: false,
-      failure: { code: failure2.data.error.code, httpStatus: response.status, retryAfterSeconds: retryAfter(response) }
-    };
-  }
+  if (failure2.success) return apiFailure(failure2.data.error.code, response.status, retryAfter(response));
   if (response.status >= 500) {
     throw transportError("SERVICE_UNAVAILABLE", "The Obi API is unavailable.", 6, true);
   }
@@ -18060,6 +18193,9 @@ async function readReadiness(context, accessToken) {
     responseLimitBytes: BUSINESS_REVIEW_RESPONSE_LIMIT_BYTES
   }), ProductReadinessResponseSchema);
 }
+async function sendSupportMessage(context, accessToken, message) {
+  return interpretReview(await send(context, { method: "POST", path: "/api/v1/support", bearer: accessToken, body: SupportMessageSchema.parse(message) }), SupportMessageResponseSchema);
+}
 
 // src/refresh.ts
 import { randomBytes as randomBytes2 } from "node:crypto";
@@ -19210,7 +19346,7 @@ async function submitHarnessObservation(context, path) {
 
 // src/commands.ts
 import { access } from "node:fs/promises";
-import { fileURLToPath } from "node:url";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
 
 // src/onboarding-guide.ts
 var READING_POLL_MS = 6e4;
@@ -20275,6 +20411,108 @@ function memoryText(data) {
 `;
 }
 
+// src/support-commands.ts
+import { createHash as createHash2 } from "node:crypto";
+import { release as release2 } from "node:os";
+
+// src/last-error.ts
+import { readFile as readFile6, writeFile as writeFile3 } from "node:fs/promises";
+import { join as join4 } from "node:path";
+var fileIn = (stateDirectory) => join4(stateDirectory, "last-error.json");
+async function recordLastError(stateDirectory, error51) {
+  try {
+    const parsed = lastErrorSchema.safeParse({ ...error51, at: (/* @__PURE__ */ new Date()).toISOString() });
+    if (!parsed.success) return;
+    await ensureStateDirectory(stateDirectory);
+    await writeFile3(fileIn(stateDirectory), JSON.stringify(parsed.data), { mode: 384 });
+  } catch {
+  }
+}
+async function readLastError(stateDirectory) {
+  try {
+    const parsed = lastErrorSchema.safeParse(JSON.parse(await readFile6(fileIn(stateDirectory), "utf8")));
+    return parsed.success ? parsed.data : null;
+  } catch {
+    return null;
+  }
+}
+
+// src/support-commands.ts
+async function probeServer(origin, timeoutMs) {
+  try {
+    const response = await exchange({
+      url: new URL("/api/health", origin.origin),
+      method: "GET",
+      headers: { accept: "application/json" },
+      timeoutMs
+    });
+    return response.status === 200 ? "reachable" : "degraded";
+  } catch {
+    return "unreachable";
+  }
+}
+async function sendSupport(context, input) {
+  const lastError = await readLastError(context.stateDirectory);
+  const diagnostic = { cliVersion, node: process.version, os: `${process.platform} ${release2()} ${process.arch}`, lastError };
+  let account2 = null;
+  let reason = null;
+  try {
+    const located = await locateCredential(context);
+    if (located === null) {
+      reason = "AUTH_REQUIRED";
+    } else {
+      account2 = located.credential.account.email;
+      const requestId = createHash2("sha256").update(JSON.stringify([
+        context.origin.origin,
+        account2,
+        input.message,
+        input.tag,
+        (/* @__PURE__ */ new Date()).toISOString().slice(0, 10)
+      ])).digest("hex").slice(0, 32);
+      const { result } = await useCredential(
+        context,
+        located,
+        (token) => sendSupportMessage(context, token, { requestId, ...input, diagnostic })
+      );
+      if (!result.ok) reason = result.failure.httpStatus >= 500 ? "SERVICE_UNAVAILABLE" : result.failure.code;
+    }
+  } catch (error51) {
+    reason = error51 instanceof CliError ? error51.code : "INTERNAL_ERROR";
+  }
+  const diagnosticText = [
+    `Message: ${input.message}`,
+    `Tag: ${input.tag ?? "general"}`,
+    `Obi CLI ${diagnostic.cliVersion} \xB7 Node ${diagnostic.node} \xB7 ${diagnostic.os}`,
+    `Last error: ${lastError === null ? "none" : `${lastError.code} (${lastError.command}) at ${lastError.at}`}`,
+    `Account: ${account2 ?? "not signed in"}`
+  ].join("\n");
+  const data = {
+    delivery: reason === null ? "sent" : "not_sent",
+    reason,
+    supportEmail: SUPPORT_EMAIL,
+    mailto: `mailto:${SUPPORT_EMAIL}`,
+    tag: input.tag,
+    account: account2,
+    origin: context.origin.origin,
+    diagnosticText
+  };
+  if (reason === null) return data;
+  throw new CliError({
+    code: "SUPPORT_NOT_SENT",
+    message: `The message was not sent to Obi support (${reason}).`,
+    exitCode: reason === "AUTH_REQUIRED" ? 3 : 6,
+    retryable: reason !== "AUTH_REQUIRED",
+    mode: "product",
+    command: "support",
+    nextAction: `Write to ${SUPPORT_EMAIL} and paste the block below (support.diagnosticText with --json). Never add a token or a credential file.`,
+    support: data
+  });
+}
+function supportText(data) {
+  return `Sent to Obi support (${data.supportEmail}). The reply goes to ${sanitizeHumanText(data.account ?? "the account email")}.
+`;
+}
+
 // src/scan-output.ts
 function heading(data) {
   const scored = `${data.scoredCells}/${data.expectedCells} answers scored from question version ${data.candidateVersion ?? "none"}.`;
@@ -20399,6 +20637,7 @@ function failureText(result) {
     lines.push(`Approving account: ${sanitizeHumanText(result.account.email)} (${result.account.role}).`);
   }
   lines.push(sanitizeHumanText(result.error.nextAction));
+  if (result.support !== void 0) lines.push("", ...result.support.diagnosticText.split("\n").map(sanitizeHumanText));
   return `${lines.join("\n")}
 `;
 }
@@ -20441,11 +20680,12 @@ function toHumanOutput(result) {
     return `Obi \xB7 AI Search Employee
 
 Get started
-  1. obi skill install
-  2. In a new Claude Code or Cursor chat, type /obi.
+  1. In Claude Code or Cursor, type /obi.
      In Codex CLI, type $obi or choose Obi from /skills.
      In the desktop app, select Obi from the skills picker.
-  3. Give Obi a website or ask to continue saved work.
+     In OpenCode, type @obi.
+  2. Give Obi a website or ask to continue saved work.
+  Every obi command registers the Skill; obi skill install repairs it.
 
 Commands
 ${usage2}
@@ -20457,11 +20697,11 @@ ${usage2}
   }
   if (result.command === "skill") {
     return result.data.action === "path" ? `${sanitizeHumanText(result.data.path)}
-` : `Obi Skill registered locally. In a new Claude Code or Cursor chat, type /obi. In Codex CLI, type $obi or choose Obi from /skills. In the desktop app, select Obi from the skills picker.
+` : `Obi Skill registered locally. In a new Claude Code or Cursor chat, type /obi. In Codex CLI, type $obi or choose Obi from /skills. In the desktop app, select Obi from the skills picker. In OpenCode, type @obi.
 ${result.data.removed.length > 0 ? "Earlier Skill links of this package under another name were removed; use /obi.\n" : ""}`;
   }
   if (result.command === "capabilities") {
-    return "Available: business, capabilities, credentials, doctor, eval, harness, login, logout, memory, questions, readiness, research, skill, status, strategies. Scan execution requires server authorization and a separate customer decision.\n";
+    return "Available: business, capabilities, credentials, doctor, eval, harness, login, logout, memory, questions, readiness, research, skill, status, strategies, support. Scan execution requires server authorization and a separate customer decision.\n";
   }
   if (result.command === "eval") {
     if ("evaluation" in result.data) {
@@ -20476,6 +20716,7 @@ Next: ${sanitizeHumanText(result.data.nextStep)}
     return result.data.action === "list" ? connectionListText(result.data) : revocationText(result.data);
   }
   if (result.command === "memory") return memoryText(result.data);
+  if (result.command === "support") return supportText(result.data);
   if (result.command === "doctor") {
     if (result.mode === "test") {
       return `Synthetic test protocol reachable. State: ${String(result.data.state)}.
@@ -20483,7 +20724,14 @@ Next: ${sanitizeHumanText(result.data.nextStep)}
     }
     const storage = result.data.credentialStorage === "none" ? "no stored connection" : `connection stored in ${storageLabels[result.data.credentialStorage]}`;
     const video = result.data.videoTools.ytDlp ? `video reading available${result.data.videoTools.ffmpeg ? " with frames" : " (captions only; frames need ffmpeg)"}` : "video reading needs yt-dlp";
-    return `Local diagnostic completed for ${sanitizeHumanText(result.data.origin)}: ${storage}; ${video}. No request was sent.
+    const server = {
+      reachable: "Obi server reachable.",
+      degraded: `Obi server degraded: try again later, and write to ${SUPPORT_EMAIL} if it lasts.`,
+      unreachable: `Obi server unreachable: check the network connection, and write to ${SUPPORT_EMAIL} if it lasts.`
+    }[result.data.server];
+    const { cliVersion: installed, latestVersion: latest } = result.data;
+    const version3 = result.data.updateCheck === "off" ? `CLI ${sanitizeHumanText(installed)} (update check off)` : latest === null ? `CLI ${sanitizeHumanText(installed)} (latest version unknown: npm could not be reached${result.data.lastKnownVersion === null ? "" : `, last known ${sanitizeHumanText(result.data.lastKnownVersion)}`})` : isOlderRelease(installed, latest) ? `CLI ${sanitizeHumanText(installed)}, latest ${sanitizeHumanText(latest)}: update with ${CLI_UPDATE_COMMAND}` : `CLI ${sanitizeHumanText(installed)}, the latest`;
+    return `Local diagnostic completed for ${sanitizeHumanText(result.data.origin)}: ${version3}; ${storage}; ${video}. ${server}
 `;
   }
   if (result.command === "login") {
@@ -20819,9 +21067,6 @@ async function confirmAccount(account2) {
   }
 }
 
-// src/version.ts
-var cliVersion = "0.1.8";
-
 // src/login.ts
 var loginRequestTimeoutMs = 1e4;
 var maxLinkLength = 200;
@@ -21031,7 +21276,7 @@ function accountMismatch(account2, revoked, expected) {
 }
 async function confirmAndStore(context, store, pair, receivedAt, expectedEmail) {
   const api = context;
-  const release2 = guardNewFamily(api, pair);
+  const release4 = guardNewFamily(api, pair);
   let stored = false;
   try {
     const status = await readAccountStatus(api, pair.accessToken);
@@ -21062,7 +21307,7 @@ async function confirmAndStore(context, store, pair, receivedAt, expectedEmail)
       }
       await store.writeCredential(credentialFromPair(context.origin.origin, pair, confirmed, receivedAt));
       stored = true;
-      release2();
+      release4();
     });
     try {
       await store.removePending();
@@ -21082,7 +21327,7 @@ async function confirmAndStore(context, store, pair, receivedAt, expectedEmail)
     }
     throw error51;
   } finally {
-    release2();
+    release4();
   }
 }
 async function login(session, options) {
@@ -21221,12 +21466,12 @@ async function proceedToFirstScan(context, candidateVersion) {
 }
 
 // src/research-commands.ts
-import { readFile as readFile6, stat as stat6 } from "node:fs/promises";
+import { readFile as readFile7, stat as stat6 } from "node:fs/promises";
 import { isDeepStrictEqual as isDeepStrictEqual2 } from "node:util";
 import { resolve as resolve2 } from "node:path";
 
 // ../geo-engine/src/geo/host-acquisition.ts
-import { createHash as createHash5 } from "node:crypto";
+import { createHash as createHash6 } from "node:crypto";
 
 // ../geo-engine/src/url-safety.ts
 var PRIVATE_IP_RE = /^(127\.|10\.|192\.168\.|169\.254\.|172\.(1[6-9]|2\d|3[01])\.|0\.)/;
@@ -21397,7 +21642,7 @@ async function safeFetch(url3, opts = {}) {
     if (!REDIRECT_STATUSES.has(res.status)) return res;
     const location = res.headers.get("location");
     if (!location) return res;
-    await release(res);
+    await release3(res);
     let next;
     try {
       next = new URL(location, current).href;
@@ -21408,7 +21653,7 @@ async function safeFetch(url3, opts = {}) {
   }
   throw new TooManyRedirectsError(url3, maxRedirects);
 }
-async function release(res) {
+async function release3(res) {
   await res.body?.cancel().catch((err) => {
     console.warn("[safe-fetch] cancelling an unread body failed:", err);
   });
@@ -21416,7 +21661,7 @@ async function release(res) {
 async function readCapped(res, maxBytes = MAX_RESPONSE_BYTES) {
   const declared = Number(res.headers.get("content-length"));
   if (Number.isFinite(declared) && declared > maxBytes) {
-    await release(res);
+    await release3(res);
     return "";
   }
   if (!res.body) return (await res.text()).slice(0, maxBytes);
@@ -21582,7 +21827,7 @@ function createVettedTransport(options = {}) {
 }
 
 // ../geo-engine/src/geo/page-evidence.ts
-import { createHash as createHash2 } from "node:crypto";
+import { createHash as createHash3 } from "node:crypto";
 
 // ../node_modules/parse5/dist/common/unicode.js
 var UNDEFINED_CODE_POINTS = /* @__PURE__ */ new Set([
@@ -29502,7 +29747,7 @@ function* descendants(node) {
   }
 }
 function sha256(s) {
-  return createHash2("sha256").update(s).digest("hex");
+  return createHash3("sha256").update(s).digest("hex");
 }
 var SKIPPED = /* @__PURE__ */ new Set(["script", "style", "noscript", "template", "svg", "iframe", "object", "canvas", "select", "head"]);
 var HEADING = /^h([1-6])$/;
@@ -29793,7 +30038,7 @@ function headingTexts(html, level) {
 }
 
 // ../geo-engine/src/geo/selected-page-evidence.ts
-import { createHash as createHash3 } from "node:crypto";
+import { createHash as createHash4 } from "node:crypto";
 
 // ../geo-engine/src/geo/material-fact-contract.ts
 var text = external_exports.string().trim().min(1);
@@ -29899,10 +30144,10 @@ var SelectedPageEvidenceSchema = external_exports.strictObject({
 function selectedPageId(pageUrl) {
   const selected = new URL(pageUrl);
   selected.hash = "";
-  return `page:${createHash3("sha256").update(selected.href).digest("hex")}`;
+  return `page:${createHash4("sha256").update(selected.href).digest("hex")}`;
 }
 function observationBodyHash(body) {
-  return createHash3("sha256").update(body).digest("hex");
+  return createHash4("sha256").update(body).digest("hex");
 }
 function sameSelectedHost(selectedUrl, finalUrl) {
   const host = (value) => new URL(value).hostname.toLowerCase().replace(/^www\./, "");
@@ -30354,14 +30599,14 @@ function evaluateAccess(parsed, token, url3, fallbackTokens = []) {
 }
 
 // ../geo-engine/src/geo/readiness/findings.ts
-import { createHash as createHash4 } from "node:crypto";
+import { createHash as createHash5 } from "node:crypto";
 function issueId(origin, checkId, scopeKey) {
-  return createHash4("sha256").update(`${origin.toLowerCase()}
+  return createHash5("sha256").update(`${origin.toLowerCase()}
 ${checkId}
 ${scopeKey}`).digest("hex").slice(0, 16);
 }
 function fingerprint(body) {
-  return body === null ? null : createHash4("sha256").update(body).digest("hex");
+  return body === null ? null : createHash5("sha256").update(body).digest("hex");
 }
 function makeFinding({ origin, scopeKey, policyChoice = false, materiality = "site", ...rest }) {
   return { id: issueId(origin, rest.checkId, scopeKey), policyChoice, materiality, ...rest };
@@ -30864,7 +31109,7 @@ function validateState(raw) {
   return state;
 }
 function matchesFingerprint(observation) {
-  return observation.body === null ? observation.bodyHash === null : observation.bodyHash === createHash5("sha256").update(observation.body).digest("hex");
+  return observation.body === null ? observation.bodyHash === null : observation.bodyHash === createHash6("sha256").update(observation.body).digest("hex");
 }
 function pendingProbeRequests(state) {
   const home = state.resources.find((resource) => resource.kind === "page" && resource.url === `${state.origin}/`);
@@ -32635,7 +32880,7 @@ async function readJson(path, maxBytes = maxCorpusBytes) {
   try {
     const info = await stat6(path);
     if (!info.isFile() || info.size > maxBytes) throw fileError(`The research file is not a regular JSON file within the ${maxBytes / 1024 / 1024} MiB local limit.`);
-    const content = await readFile6(path);
+    const content = await readFile7(path);
     if (content.byteLength > maxBytes) throw fileError(`The research file exceeds the ${maxBytes / 1024 / 1024} MiB local limit.`);
     return JSON.parse(content.toString("utf8"));
   } catch (error51) {
@@ -32823,8 +33068,8 @@ async function captureResearch(input, checkpoint, output) {
 
 // src/research-video.ts
 import { spawn as spawn2 } from "node:child_process";
-import { mkdir as mkdir2, readdir as readdir3, readFile as readFile7, rm as rm2 } from "node:fs/promises";
-import { join as join4, resolve as resolve3 } from "node:path";
+import { mkdir as mkdir2, readdir as readdir3, readFile as readFile8, rm as rm2 } from "node:fs/promises";
+import { join as join5, resolve as resolve3 } from "node:path";
 var maxToolOutputBytes = 256 * 1024;
 var runTool = (executable, args, timeoutMs) => new Promise((done, fail) => {
   const child = spawn2(executable, [...args], { stdio: ["ignore", "pipe", "pipe"], shell: false });
@@ -32923,12 +33168,12 @@ async function readVideo(rawUrl, outputDir, frames, runner = runTool) {
   const directory = resolve3(outputDir);
   await mkdir2(directory, { recursive: true });
   const base = ["--ignore-config", "--no-playlist", "--quiet", "--no-warnings"];
-  const target = ["-o", join4(templateSafe(directory), "video.%(ext)s")];
+  const target = ["-o", join5(templateSafe(directory), "video.%(ext)s")];
   const failed = (message, nextAction) => videoError("RESEARCH_VIDEO_FAILED", message, nextAction);
   const metadata = await runner("yt-dlp", [...base, "--skip-download", "--write-info-json", ...target, url3.href], 18e4).catch((error51) => {
     throw error51.code === "ENOENT" ? missingTool(frames) : failed("yt-dlp did not finish reading this video page.", "Retry once; a slow or blocked network leaves the video unread.");
   });
-  const info = metadata.exitCode === 0 ? JSON.parse(await readFile7(join4(directory, "video.info.json"), "utf8")) : null;
+  const info = metadata.exitCode === 0 ? JSON.parse(await readFile8(join5(directory, "video.info.json"), "utf8")) : null;
   if (!info) {
     throw failed("yt-dlp could not read this video page.", "Check the address in a browser; a private or region-locked video stays unread.");
   }
@@ -32950,11 +33195,11 @@ async function readVideo(rawUrl, outputDir, frames, runner = runTool) {
     if (subtitles?.exitCode !== 0 || !file2) {
       throw failed("The video has captions but their download failed.", "Retry in a minute; the platform may be rate-limiting.");
     }
-    segments = parseVtt(await readFile7(join4(directory, file2), "utf8"));
+    segments = parseVtt(await readFile8(join5(directory, file2), "utf8"));
   }
   const duration3 = typeof info.duration === "number" ? info.duration : null;
   const frameFiles = [];
-  const output = join4(directory, "transcript.json");
+  const output = join5(directory, "transcript.json");
   const save = () => writeJsonAtomic(
     output,
     {
@@ -32974,7 +33219,7 @@ async function readVideo(rawUrl, outputDir, frames, runner = runTool) {
     throw failed("The video's length is unknown, so frames cannot be spaced.", "Retry with --frames 0 to keep the captions only.");
   }
   if (frames > 0 && duration3) {
-    const removeMedia = async () => Promise.all((await readdir3(directory)).filter((file2) => file2.startsWith("media.")).map((file2) => rm2(join4(directory, file2), { force: true })));
+    const removeMedia = async () => Promise.all((await readdir3(directory)).filter((file2) => file2.startsWith("media.")).map((file2) => rm2(join5(directory, file2), { force: true })));
     await removeMedia();
     try {
       const download = await runner("yt-dlp", [
@@ -32982,7 +33227,7 @@ async function readVideo(rawUrl, outputDir, frames, runner = runTool) {
         "-f",
         "b[height<=480]/bv*[height<=480]/w",
         "-o",
-        join4(templateSafe(directory), "media.%(ext)s"),
+        join5(templateSafe(directory), "media.%(ext)s"),
         url3.href
       ], 6e5).catch(() => {
         throw failed("The video download did not finish.", "Retry with --frames 0 to keep the captions only.");
@@ -33002,14 +33247,14 @@ async function readVideo(rawUrl, outputDir, frames, runner = runTool) {
           "-ss",
           String(atSeconds),
           "-i",
-          join4(directory, media),
+          join5(directory, media),
           "-frames:v",
           "1",
           "-vf",
           "scale=1024:-2",
-          join4(directory, file2)
+          join5(directory, file2)
         ], 6e4).catch(() => null);
-        if (extracted?.exitCode === 0) frameFiles.push({ file: join4(directory, file2), atSeconds });
+        if (extracted?.exitCode === 0) frameFiles.push({ file: join5(directory, file2), atSeconds });
       }
     } finally {
       await removeMedia();
@@ -33128,13 +33373,15 @@ async function showAlphaStrategies(context) {
 // src/skill-install.ts
 import { lstat as lstat3, mkdir as mkdir3, readlink, realpath, symlink, unlink as unlink5 } from "node:fs/promises";
 import { homedir as homedir2 } from "node:os";
-import { join as join5, sep } from "node:path";
+import { join as join6, sep } from "node:path";
+import { fileURLToPath } from "node:url";
 var skillDirectories = [".agents/skills", ".claude/skills"];
 var alphaSkillName = "heysurface";
+var messageLimit = 300;
 function installError(message) {
   return new CliError({
     code: "SKILL_INSTALL_FAILED",
-    message,
+    message: message.length > messageLimit ? `${message.slice(0, messageLimit - 1)}\u2026` : message,
     exitCode: 4,
     retryable: false,
     nextAction: "Check the personal Skill directories and run obi skill install again. Existing files are never replaced.",
@@ -33164,7 +33411,7 @@ async function linksIntoPackage(path, packageRoot) {
     return target === packageRoot || target.startsWith(`${packageRoot}${sep}`);
   } catch {
     try {
-      return await readlink(path) === join5(packageRoot, "skills", alphaSkillName);
+      return await readlink(path) === join6(packageRoot, "skills", alphaSkillName);
     } catch {
       return false;
     }
@@ -33173,37 +33420,70 @@ async function linksIntoPackage(path, packageRoot) {
 async function installSkill(sourceDirectory) {
   const source = await realpath(sourceDirectory);
   const home = homedir2();
-  const destinations = skillDirectories.map((directory) => join5(home, directory, "obi"));
+  const destinations = skillDirectories.map((directory) => join6(home, directory, "obi"));
+  const registered = async (destination) => {
+    try {
+      return await realpath(destination) === source;
+    } catch {
+      return false;
+    }
+  };
   for (const destination of destinations) {
-    if (!await existingPath(destination)) continue;
+    if (!await existingPath(destination) || await registered(destination)) continue;
+    let target = null;
     try {
-      if (await realpath(destination) === source) continue;
+      if ((await lstat3(destination)).isSymbolicLink()) target = await readlink(destination);
     } catch {
+      continue;
     }
-    throw installError(`A Skill entry already exists at ${destination}.`);
+    throw installError(target === null ? `A Skill entry already exists: a file or folder this package did not create. Move it, then run obi skill install. It is at ${destination}` : `A Skill entry already exists: a link outside this installation. To use this installation, remove that link, then run obi skill install. The link: ${destination} -> ${target}`);
   }
   for (const destination of destinations) {
-    if (await existingPath(destination)) continue;
+    if (await registered(destination)) continue;
     try {
-      await mkdir3(join5(destination, ".."), { recursive: true });
+      await mkdir3(join6(destination, ".."), { recursive: true });
       await symlink(source, destination, process.platform === "win32" ? "junction" : "dir");
     } catch {
-      throw installError(`Could not register the Obi Skill at ${destination}.`);
+      if (await registered(destination)) continue;
+      throw installError(`Could not register the Obi Skill. Check that its folder can be written, then run obi skill install. The link to make: ${destination}`);
     }
   }
   const removed = [];
-  const packageRoot = await realpath(join5(source, "..", ".."));
-  for (const alpha of skillDirectories.map((directory) => join5(home, directory, alphaSkillName))) {
+  const packageRoot = await realpath(join6(source, "..", ".."));
+  for (const alpha of skillDirectories.map((directory) => join6(home, directory, alphaSkillName))) {
     if (!await linksIntoPackage(alpha, packageRoot)) continue;
     try {
       await unlink5(alpha);
-    } catch {
+    } catch (error51) {
+      if (error51.code === "ENOENT") continue;
       throw installError(`Could not retire the earlier Skill link at ${alpha}.`);
     }
     removed.push(alpha);
   }
   return { paths: destinations, removed };
 }
+function packagedSkillDirectory() {
+  return fileURLToPath(new URL("../skills/obi", import.meta.url));
+}
+async function registerSkillLinks(sourceDirectory, env) {
+  if (env.OBI_SKILL_LINKS === "off") return { state: "off" };
+  try {
+    const source = await realpath(sourceDirectory);
+    let present3 = true;
+    for (const directory of skillDirectories) {
+      try {
+        if (await realpath(join6(homedir2(), directory, "obi")) !== source) present3 = false;
+      } catch {
+        present3 = false;
+      }
+    }
+    if (present3) return { state: "present" };
+    await installSkill(sourceDirectory);
+    return { state: "created" };
+  } catch (error51) {
+    return { state: "failed", reason: error51 instanceof CliError ? error51.message : "The Obi Skill could not be registered." };
+  }
+}
 
 // src/transport.ts
 var loopbackOrigin = /^http:\/\/(127\.0\.0\.1|\[::1\]):([1-9][0-9]{0,4})$/;
@@ -33328,7 +33608,7 @@ async function fetchTestStatus(origin, timeoutMs) {
 }
 
 // src/commands.ts
-var usage = "obi <business|capabilities|credentials|doctor|eval|harness|login|logout|memory|questions|readiness|research|skill|status|strategies> [--json]\n       obi eval <start <domain>|list> [--json]\n       Evaluation commands: add --eval-case <id> to status, business, harness, readiness, questions and strategies\n       obi harness coverage [--json]\n       obi harness activate --free [--json]\n       obi harness show --stage <business|questions|strategies> [--packs <1-40> for questions review] [--json]\n       obi harness submit --stage <business|questions|strategies> --input <file> [--json]\n       obi harness outcomes --task-id <UUID> [--cursor <event-id>] [--limit <1-50>] [--json]\n       obi harness observe --input <file> [--json]\n       obi harness purchase <quote|prepare|status|resume|change> [--input <quote-and-basket.json>; resume: quote ID only] [--confirm-checkout for prepare] [--confirm-change for change] [--json]\n       obi harness artifact <save|show|history|export> --work-id <UUID> [--input <JSON file>] [--revision <n>] [--output <new file>] [--cursor <opaque>] [--limit <1-100>] [--json]\n       obi harness evidence --work-id <UUID> [--kind claims|sections|measurements] [--cursor <opaque>] [--query <text>] [--url <exact URL>] [--all --output <file>] [--json]\n       obi research crawl <domain> --checkpoint <file> --output <file> [--batch-size <1-100>] [--locale <tag>] [--pages priority|all] [--max-pages <n|none>] [--retry-failed|--refresh] [--json]\n       obi research capture --input <selected-page-file> --checkpoint <file> --output <corpus-file> [--json]\n       obi research readiness --input <corpus-file> --output <report-file> [--json]\n       obi research video <url> --output <directory> [--frames <0-30>] [--json]\n       obi memory <list|add --kind <preference|constraint|decision> --text <words>|remove <id>> [--eval-case <id>] [--json]\n       obi questions show [--json]\n       obi questions prepare --confirm-preparation [--json]\n       obi questions edit <id> --candidate-version <n> --text <wording> [--json]\n       obi questions proceed --candidate-version <n> --confirm-scan [--json]\n       obi questions results [--run latest|first|<run ID>] [--from <question position>] [--json]\n       obi readiness [--json]\n       obi strategies [--json]\n       obi skill <path|install> [--json]\n       obi credentials <list|revoke <credentialId>> [--force]\n       obi business start --confirm-domain <domain>\n       obi business show\n       obi business discover --snapshot <token> --confirm-discovery\n       obi business clarify-identity --snapshot <token> --company <name>\n       obi business clarify-fact <itemId> --snapshot <token> --field-path <path> --text <answer> --company <current name> --company-wide [--segment-name <name> for segments.append]\n       obi business challenge <itemId> --snapshot <token> --reason <reason>\n       obi business correct <itemId> --snapshot <token> --claim-id <id> --field-path <path> --text <affirmative correction> --company <current name> --company-wide\n       obi business remove <competitorItemId> --snapshot <token> [--reason <reason>]\n       obi business <add-competitor|remove-competitor|readd-competitor> <domain> --snapshot <token> [--reason <reason>]\n       obi business confirm --snapshot <token> --confirm-review\n       Global options: --json, --timeout-ms <100-30000>; login: --expect-email <email> [--storage file]; status/doctor test: --test-server <origin>";
+var usage = 'obi <business|capabilities|credentials|doctor|eval|harness|login|logout|memory|questions|readiness|research|skill|status|strategies|support> [--json]\n       obi support "<message>" [--tag market-request|scope-request] [--json]\n       obi eval <start <domain>|list> [--json]\n       Evaluation commands: add --eval-case <id> to status, business, harness, readiness, questions and strategies\n       obi harness coverage [--json]\n       obi harness activate --free [--json]\n       obi harness show --stage <business|questions|strategies> [--packs <1-40> for questions review] [--json]\n       obi harness submit --stage <business|questions|strategies> --input <file> [--json]\n       obi harness outcomes --task-id <UUID> [--cursor <event-id>] [--limit <1-50>] [--json]\n       obi harness observe --input <file> [--json]\n       obi harness purchase <quote|prepare|status|resume|change> [--input <quote-and-basket.json>; resume: quote ID only] [--confirm-checkout for prepare] [--confirm-change for change] [--json]\n       obi harness artifact <save|show|history|export> --work-id <UUID> [--input <JSON file>] [--revision <n>] [--output <new file>] [--cursor <opaque>] [--limit <1-100>] [--json]\n       obi harness evidence --work-id <UUID> [--kind claims|sections|measurements] [--cursor <opaque>] [--query <text>] [--url <exact URL>] [--all --output <file>] [--json]\n       obi research crawl <domain> --checkpoint <file> --output <file> [--batch-size <1-100>] [--locale <tag>] [--pages priority|all] [--max-pages <n|none>] [--retry-failed|--refresh] [--json]\n       obi research capture --input <selected-page-file> --checkpoint <file> --output <corpus-file> [--json]\n       obi research readiness --input <corpus-file> --output <report-file> [--json]\n       obi research video <url> --output <directory> [--frames <0-30>] [--json]\n       obi memory <list|add --kind <preference|constraint|decision> --text <words>|remove <id>> [--eval-case <id>] [--json]\n       obi questions show [--json]\n       obi questions prepare --confirm-preparation [--json]\n       obi questions edit <id> --candidate-version <n> --text <wording> [--json]\n       obi questions proceed --candidate-version <n> --confirm-scan [--json]\n       obi questions results [--run latest|first|<run ID>] [--from <question position>] [--json]\n       obi readiness [--json]\n       obi strategies [--json]\n       obi skill <path|install> [--json]\n       obi credentials <list|revoke <credentialId>> [--force]\n       obi business start --confirm-domain <domain>\n       obi business show\n       obi business discover --snapshot <token> --confirm-discovery\n       obi business clarify-identity --snapshot <token> --company <name>\n       obi business clarify-fact <itemId> --snapshot <token> --field-path <path> --text <answer> --company <current name> --company-wide [--segment-name <name> for segments.append]\n       obi business challenge <itemId> --snapshot <token> --reason <reason>\n       obi business correct <itemId> --snapshot <token> --claim-id <id> --field-path <path> --text <affirmative correction> --company <current name> --company-wide\n       obi business remove <competitorItemId> --snapshot <token> [--reason <reason>]\n       obi business <add-competitor|remove-competitor|readd-competitor> <domain> --snapshot <token> [--reason <reason>]\n       obi business confirm --snapshot <token> --confirm-review\n       Global options: --json, --timeout-ms <100-30000>; login: --expect-email <email> [--storage file]; status/doctor test: --test-server <origin>';
 function success2(command, mode, data) {
   return cliResultSchema.parse({ schemaVersion: 1, command, mode, ok: true, data });
 }
@@ -33355,14 +33635,19 @@ function statusResult(status) {
   }
   return success2("status", "test", status);
 }
-async function localDoctor(runtime) {
+async function localDoctor(runtime, timeoutMs) {
   const located = await locateCredential(runtime);
+  const updates = await runtime.updates;
   return success2("doctor", "local", {
     node: process.version,
     cliVersion,
+    latestVersion: updates?.state === "on" && updates.reached ? updates.latest : null,
+    lastKnownVersion: updates?.state === "on" && !updates.reached ? updates.latest : null,
+    updateCheck: updates?.state ?? "off",
     origin: runtime.origin.origin,
     credentialStorage: located === null ? "none" : located.store.backend.kind,
     videoTools: await videoTools(),
+    server: await probeServer(runtime.origin, timeoutMs),
     diagnostic: "completed"
   });
 }
@@ -33375,7 +33660,7 @@ async function executeCommand(args, runtime) {
   if (args.command === "help") {
     return success2("help", "local", {
       usage,
-      commands: ["business", "capabilities", "credentials", "doctor", "eval", "harness", "login", "logout", "memory", "questions", "readiness", "research", "skill", "status", "strategies"]
+      commands: ["business", "capabilities", "credentials", "doctor", "eval", "harness", "login", "logout", "memory", "questions", "readiness", "research", "skill", "status", "strategies", "support"]
     });
   }
   if (args.command === "version") {
@@ -33384,6 +33669,13 @@ async function executeCommand(args, runtime) {
   if (args.command === "capabilities") {
     return success2("capabilities", "local", {
       version: cliVersion,
+      measurementMarkets: SUPPORTED_MARKETS,
+      catalog: { version: CLI_DOLLAR_CATALOG_VERSION, currency: "usd", monthlyCents: {
+        corePack: CLI_DOLLAR_PRICES.core,
+        claudePerPack: CLI_DOLLAR_PRICES.claude,
+        perplexityPerPack: CLI_DOLLAR_PRICES.perplexity
+      } },
+      support: { email: SUPPORT_EMAIL },
       realLogin: "available",
       paidExecution: "server_authorized",
       expertise: { manifestVersion: AI_SEARCH_COMPETENCY_VERSION, competencies: AI_SEARCH_COMPETENCIES },
@@ -33402,13 +33694,14 @@ async function executeCommand(args, runtime) {
         skill: { actions: ["path", "install"], options: ["--json"] },
         status: { options: ["--json", "--eval-case", "--test-server", "--timeout-ms"] },
         readiness: { options: ["--json", "--eval-case", "--timeout-ms"] },
-        strategies: { options: ["--json", "--eval-case", "--timeout-ms"] }
+        strategies: { options: ["--json", "--eval-case", "--timeout-ms"] },
+        support: { tags: [...SUPPORT_TAGS], options: ["--json", "--tag", "--timeout-ms"] }
       }
     });
   }
   if (args.command === "doctor") {
     if (args.testServer === void 0) {
-      return localDoctor(runtime);
+      return localDoctor(runtime, args.timeoutMs);
     }
     const status = await fetchTestStatus(args.testServer, args.timeoutMs);
     return success2("doctor", "test", {
@@ -33418,7 +33711,7 @@ async function executeCommand(args, runtime) {
     });
   }
   if (args.command === "skill") {
-    const path = fileURLToPath(new URL("../skills/obi/SKILL.md", import.meta.url));
+    const path = fileURLToPath2(new URL("../skills/obi/SKILL.md", import.meta.url));
     try {
       await access(path);
     } catch {
@@ -33431,7 +33724,7 @@ async function executeCommand(args, runtime) {
         mode: "local"
       });
     }
-    return success2("skill", "local", args.skillAction === "install" ? { action: "install", ...await installSkill(fileURLToPath(new URL("../skills/obi", import.meta.url))) } : { action: "path", path });
+    return success2("skill", "local", args.skillAction === "install" ? { action: "install", ...await installSkill(fileURLToPath2(new URL("../skills/obi", import.meta.url))) } : { action: "path", path });
   }
   if (args.command === "login") {
     return success2("login", "product", await login(session, {
@@ -33488,6 +33781,9 @@ async function executeCommand(args, runtime) {
       }
     ) : args.researchAction === "video" ? await readVideo(args.researchVideoUrl, args.researchOutput, args.researchFrames ?? 0) : args.researchAction === "capture" ? await captureResearch(args.researchInput, args.researchCheckpoint, args.researchOutput) : await assessResearch(args.researchInput, args.researchOutput));
   }
+  if (args.command === "support") {
+    return success2("support", "product", await sendSupport(session, { message: args.supportMessage, tag: args.supportTag ?? null }));
+  }
   if (args.command === "memory") {
     if (args.memoryAction === "list") return success2("memory", "product", await listMemory(session));
     return success2("memory", "product", await changeMemory(session, args.memoryAction === "add" ? { op: "add", kind: args.memoryKind, text: args.memoryText } : { op: "remove", id: args.memoryEntryId }));
@@ -33540,23 +33836,126 @@ async function executeCommand(args, runtime) {
   return success2("status", "product", await readStatus(session));
 }
 
+// src/start.ts
+import { join as join7 } from "node:path";
+var linkStates = {
+  created: "created",
+  present: "present",
+  off: "off (OBI_SKILL_LINKS), run obi skill install"
+};
+function renderStart(input) {
+  const links = input.registration.state === "failed" ? `failed. ${sanitizeHumanText(input.registration.reason)}` : `${linkStates[input.registration.state]}.`;
+  const account2 = input.accountEmail === null ? [
+    "Account: not connected. Connect: obi login --expect-email <the user's email> (prints an address and a code for the user).",
+    "Then: obi status --json"
+  ] : [`Account: connected as ${sanitizeHumanText(input.accountEmail)}. Its state: obi status --json`];
+  return [
+    `Obi CLI ${cliVersion}, npm package @hireobi/cli. Skill links: ${links}`,
+    `Agent guide, a local file in this package: ${sanitizeHumanText(join7(input.skillDirectory, "SKILL.md"))}`,
+    ...account2,
+    input.registration.state === "created" || input.registration.state === "present" ? "In the agent: /obi (Claude Code, Cursor), $obi (Codex) or @obi (OpenCode); /reload-skills in Claude Code if /obi is missing." : "In the agent: /obi, $obi and @obi exist once the Skill links do; until then, read the guide above.",
+    'The obi command comes only from npm i -g @hireobi/cli; the npm package named "obi" is unrelated.'
+  ].join("\n") + "\n";
+}
+
+// src/update-check.ts
+import { readFile as readFile9, writeFile as writeFile4 } from "node:fs/promises";
+import { join as join8 } from "node:path";
+var UPDATE_CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
+var UPDATE_CHECK_TIMEOUT_MS = 1500;
+var releaseSchema = external_exports.string().max(32).refine((value) => parseRelease(value) !== null);
+var cacheSchema = external_exports.object({
+  checkedAt: external_exports.iso.datetime(),
+  latest: releaseSchema.nullable()
+});
+var cacheFile = (stateDirectory) => join8(stateDirectory, "update-check.json");
+var npmRegistry = "https://registry.npmjs.org";
+var loopbackRegistry = /^http:\/\/(127\.0\.0\.1|\[::1\]):[1-9][0-9]{0,4}$/;
+function updateCheckDisabled(env) {
+  const on = (value) => value !== void 0 && value !== "" && value !== "0" && value.toLowerCase() !== "false";
+  return on(env.OBI_NO_UPDATE_CHECK) || on(env.CI);
+}
+async function fetchLatestVersion(env, timeoutMs) {
+  const override = env.OBI_UPDATE_REGISTRY;
+  const registry2 = override !== void 0 && loopbackRegistry.test(override) ? override : npmRegistry;
+  try {
+    const response = await exchange({
+      url: new URL("/-/package/@hireobi%2fcli/dist-tags", registry2),
+      method: "GET",
+      headers: { accept: "application/json" },
+      timeoutMs,
+      responseLimitBytes: 16 * 1024
+    });
+    if (response.status !== 200) return null;
+    const parsed = external_exports.object({ latest: releaseSchema }).safeParse(JSON.parse(response.body));
+    return parsed.success ? parsed.data.latest : null;
+  } catch {
+    return null;
+  }
+}
+async function readCache(stateDirectory) {
+  try {
+    const parsed = cacheSchema.safeParse(JSON.parse(await readFile9(cacheFile(stateDirectory), "utf8")));
+    return parsed.success ? parsed.data : null;
+  } catch {
+    return null;
+  }
+}
+async function writeCache(stateDirectory, cache) {
+  try {
+    await ensureStateDirectory(stateDirectory);
+    await writeFile4(cacheFile(stateDirectory), JSON.stringify(cache), { mode: 384 });
+  } catch {
+  }
+}
+async function checkForUpdate(input) {
+  if (updateCheckDisabled(input.env) || parseRelease(input.installed) === null) return { state: "off" };
+  try {
+    const now = (input.now ?? Date.now)();
+    const cache = await readCache(input.stateDirectory);
+    const age = cache === null ? Infinity : now - Date.parse(cache.checkedAt);
+    let latest = cache?.latest ?? null;
+    let reached = true;
+    if (input.fresh === true || !(age >= 0 && age < UPDATE_CHECK_INTERVAL_MS)) {
+      const fetched = await (input.fetchLatest ?? ((timeoutMs) => fetchLatestVersion(input.env, timeoutMs)))(UPDATE_CHECK_TIMEOUT_MS);
+      reached = fetched !== null;
+      latest = fetched ?? latest;
+      await writeCache(input.stateDirectory, { checkedAt: new Date(now).toISOString(), latest });
+    }
+    const notice = latest !== null && isOlderRelease(input.installed, latest) ? { installed: input.installed, latest, command: CLI_UPDATE_COMMAND } : null;
+    return { state: "on", latest, reached, notice };
+  } catch {
+    return { state: "on", latest: null, reached: false, notice: null };
+  }
+}
+function updateNoticeLine(notice) {
+  return `Obi CLI ${notice.latest} is available (you have ${notice.installed}). Update with: ${notice.command}
+`;
+}
+
 // src/welcome.ts
 var copy = {
   en: {
     tagline: "Your AI Search employee.",
     greeting: "Hi, I'm Obi. Let's get you discovered.",
-    install: "Get started: obi skill install",
+    ready: "I'm in your assistants: Claude Code, Codex, Cursor and OpenCode.",
+    off: "Get started: obi skill install",
+    failed: "I could not join your assistants.",
     claude: "Claude Code / Cursor: /obi",
     codex: "Codex: $obi or the skills picker",
+    opencode: "OpenCode: @obi",
     next: "Then give me your website in your assistant's chat.",
     help: "All commands: obi --help"
   },
   fr: {
     tagline: "Ton agent AI Search.",
     greeting: "Salut, moi c'est Obi. Faisons conna\xEEtre ton entreprise.",
-    install: "Pour d\xE9marrer : obi skill install",
+    ready: "Je suis dans tes assistants : Claude Code, Codex, Cursor et OpenCode.",
+    off: "Pour d\xE9marrer : obi skill install",
+    failed: "Je n'ai pas pu rejoindre tes assistants.",
     claude: "Claude Code / Cursor : /obi",
     codex: "Codex : $obi ou le s\xE9lecteur de skills",
+    opencode: "OpenCode : @obi",
     next: "Donne-moi ensuite ton site dans ton assistant.",
     help: "Toutes les commandes : obi --help"
   }
@@ -33610,7 +34009,7 @@ function mascotLine(row, depth) {
     return `${color(top, false, depth)}${color(bottom, true, depth)}\u2580`;
   }).join("") + reset;
 }
-function renderWelcome(env, columns, colorDepth) {
+function renderWelcome(env, columns, colorDepth, registration) {
   const locale = [env.OBI_LANGUAGE, env.LC_ALL, env.LC_MESSAGES, env.LANG].find((value) => value?.trim())?.trim().toLowerCase() ?? "en";
   const text2 = copy[/^fr(?:[-_.@]|$)/.test(locale) ? "fr" : "en"];
   const colorful = columns >= 64 && colorDepth >= 8 && env.TERM !== "dumb" && !env.NO_COLOR;
@@ -33619,14 +34018,16 @@ function renderWelcome(env, columns, colorDepth) {
     return `  ${mascotLine(row, colorDepth)}     ${aside}`;
   }).join("\n") : `Obi \xB7 ${cliVersion}
 ${text2.tagline}`;
+  const skill = registration.state === "failed" ? `${text2.failed} ${sanitizeHumanText(registration.reason)}` : registration.state === "off" ? text2.off : text2.ready;
   return `
 ${title}
 
 ${text2.greeting}
 
-  ${text2.install}
+  ${skill}
   ${text2.claude}
   ${text2.codex}
+  ${text2.opencode}
 
 ${text2.next}
 ${text2.help}
@@ -33648,22 +34049,37 @@ function failureResult(error51, command, mode) {
       nextAction: error51.nextAction
     },
     authorization: error51.authorization,
-    account: error51.account
+    account: error51.account,
+    support: error51.support
   });
 }
 function markOrigin(result, origin) {
   return origin?.development === true ? cliResultSchema.parse({ ...result, origin: origin.origin, development: true }) : result;
 }
+async function updateNotice(updates) {
+  const check3 = await updates;
+  return check3?.state === "on" ? check3.notice : null;
+}
+function withUpdate(result, notice) {
+  return notice === null ? result : cliResultSchema.parse({ ...result, update: notice });
+}
+async function announceUpdate(updates) {
+  const notice = await updateNotice(updates);
+  if (notice !== null) process.stderr.write(updateNoticeLine(notice));
+}
 async function runCli() {
   const argv = process.argv.slice(2);
   const json2 = wantsJson(argv);
   const welcome = argv.length === 0 && process.stdin.isTTY === true && process.stdout.isTTY === true;
+  const start = argv.length === 0 && !welcome;
+  const registration = await registerSkillLinks(packagedSkillDirectory(), process.env);
   let command = "unknown";
   let mode = commandMode(
     void 0,
     argv.some((value) => value === "--test-server" || value.startsWith("--test-server="))
   );
   let origin;
+  let updates;
   let warned = false;
   const activeOrigin = () => {
     const resolved = resolveOrigin(process.env);
@@ -33675,14 +34091,24 @@ async function runCli() {
     return resolved;
   };
   try {
-    const args = parseCommandArguments(welcome ? ["--help"] : argv);
+    const args = parseCommandArguments(welcome || start ? ["--help"] : argv);
     command = args.command;
     mode = commandMode(args.command, args.testServer !== void 0);
     origin = activeOrigin();
-    const result = await executeCommand(args, {
-      origin,
-      stateDirectory: await prepareStateDirectory(process.env)
-    });
+    const stateDirectory = await prepareStateDirectory(process.env);
+    updates = checkForUpdate({ env: process.env, stateDirectory, installed: cliVersion, fresh: command === "doctor" });
+    const runtime = { origin, stateDirectory, updates };
+    if (start) {
+      const located = await locateCredential(runtime, "skip");
+      process.stdout.write(renderStart({
+        registration,
+        skillDirectory: packagedSkillDirectory(),
+        accountEmail: located === null ? null : located.credential.account.email
+      }));
+      await announceUpdate(updates);
+      return;
+    }
+    const result = await executeCommand(args, runtime);
     const evaluationCaseId = args.evaluationCaseId;
     const scopeNext = (data) => ({
       ...data,
@@ -33694,9 +34120,11 @@ async function runCli() {
       ...result.ok && result.command === "status" && result.mode === "product" ? { data: scopeNext(result.data) } : result.ok && result.command === "business" && result.data.action === "start" ? { data: scopeNext(result.data) } : {}
     }) : result;
     if (scoped.ok && welcome) {
-      process.stdout.write(renderWelcome(process.env, process.stdout.columns, process.stdout.getColorDepth()));
+      process.stdout.write(renderWelcome(process.env, process.stdout.columns, process.stdout.getColorDepth(), registration));
+      await announceUpdate(updates);
     } else {
-      writeResult(markOrigin(scoped, origin), args.json);
+      writeResult(withUpdate(markOrigin(scoped, origin), args.json ? await updateNotice(updates) : null), args.json);
+      if (!args.json) await announceUpdate(updates);
     }
   } catch (error51) {
     if (origin === void 0) {
@@ -33712,7 +34140,15 @@ async function runCli() {
       retryable: false,
       nextAction: "Run the command again or inspect the local CLI installation."
     });
-    writeResult(markOrigin(failureResult(knownError, knownError.command ?? command, mode), origin), json2);
+    const failure2 = failureResult(knownError, knownError.command ?? command, mode);
+    if (failure2.mode !== "test" && failure2.command !== "support" && knownError.code !== "AUTHORIZATION_PENDING") {
+      await prepareStateDirectory(process.env).then((directory) => recordLastError(
+        directory,
+        { code: knownError.code, command: failure2.command }
+      ), () => void 0);
+    }
+    writeResult(withUpdate(markOrigin(failure2, origin), json2 ? await updateNotice(updates) : null), json2);
+    if (!json2) await announceUpdate(updates);
     process.exitCode = knownError.exitCode;
   } finally {
     closeIdleConnections();