@asiyst/cli 1.1.1 → 1.1.2

package/dist/index.js

@@ -1,62 +1,18 @@
 #!/usr/bin/env node
 
-// src/config/api.ts
-var PRODUCTION_API_ORIGIN = "https://nqhxpgsjofzqudyqkqib.supabase.co/functions/v1/api";
-var CLI_API_BASE_URL = PRODUCTION_API_ORIGIN;
-var VERIFY_KEY_PATH = "/auth/api-key/verify";
-var VERIFY_KEY_URL = `${CLI_API_BASE_URL}${VERIFY_KEY_PATH}`;
-var ASIYST_WEB_URL = "https://asiyst.com";
-var ASIIYST_WEB_URL = ASIYST_WEB_URL;
-var REQUEST_TIMEOUT_MS = 15e3;
-function readEnv(env, ...keys) {
-  for (const key of keys) {
-    const value = env[key]?.trim();
-    if (value) return value;
-  }
-  return void 0;
-}
-function isLocalUrl(value) {
-  try {
-    const url = new URL(value);
-    return url.hostname === "localhost" || url.hostname === "127.0.0.1" || url.hostname === "::1";
-  } catch {
-    return /localhost|127\.0\.0\.1|::1/i.test(value);
-  }
-}
-function resolveApiBaseUrl(env = process.env) {
-  const explicit = readEnv(env, "ASIYST_API_URL", "ASIIYST_API_URL");
-  const development = readEnv(env, "ASIYST_API_MODE", "ASIIYST_API_MODE") === "development";
-  if (explicit) {
-    if (isLocalUrl(explicit)) {
-      return CLI_API_BASE_URL;
-    }
-    return explicit.replace(/\/+$/, "");
-  }
-  if (development) {
-    return CLI_API_BASE_URL;
-  }
-  return CLI_API_BASE_URL;
-}
-function isDebugEnabled(env = process.env) {
-  return readEnv(env, "ASIYST_DEBUG", "ASIIYST_DEBUG") === "1" || readEnv(env, "ASIYST_DEBUG", "ASIIYST_DEBUG") === "true";
-}
-
 // src/config/ids.ts
-var PUBLIC_IDENTIFIER_PATTERN = /^(?=.{1,128}$)[A-Za-z0-9_][A-Za-z0-9_-]*$/;
-var USER_ID_PATTERN = /^[A-Za-z0-9_]{24}$/;
+var PROJECT_ID_PATTERN = /^[A-Za-z0-9_][A-Za-z0-9_-]{23}$/;
+var API_KEY_PATTERN = /^[A-Za-z0-9_-]{32}$/;
+var USER_ID_PATTERN = /^[A-Za-z0-9-]{16}$/;
 var AVATAR_ID_PATTERN = /^[A-Za-z0-9]{10}$/;
-function isValidPublicIdentifier(value) {
-  if (typeof value !== "string") return false;
-  const trimmed = value.trim();
-  if (!trimmed || trimmed.length > 128) return false;
-  if (trimmed === "undefined" || trimmed === "null") return false;
-  if (/^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(trimmed)) {
-    return false;
-  }
-  return PUBLIC_IDENTIFIER_PATTERN.test(trimmed);
+function isValidProjectId(value) {
+  return typeof value === "string" && PROJECT_ID_PATTERN.test(value.trim());
+}
+function isValidApiKey(value) {
+  return typeof value === "string" && API_KEY_PATTERN.test(value.trim());
 }
 function isValidUserId(value) {
-  return typeof value === "string" && value.trim() !== "undefined" && value.trim() !== "null" && USER_ID_PATTERN.test(value.trim());
+  return typeof value === "string" && value.trim() !== "undefined" && value.trim() !== "null" && USER_ID_PATTERN.test(value);
 }
 function isValidAvatarId(value) {
   return typeof value === "string" && value.trim() !== "undefined" && value.trim() !== "null" && AVATAR_ID_PATTERN.test(value.trim());
@@ -91,6 +47,8 @@ function errorCodeFromStatus(status, bodyCode) {
   if (bodyCode === "INVALID_API_KEY") return "INVALID_API_KEY";
   if (bodyCode === "API_KEY_REVOKED") return "API_KEY_REVOKED";
   if (bodyCode === "FORBIDDEN") return "FORBIDDEN";
+  if (bodyCode === "USER_MISMATCH") return "USER_MISMATCH";
+  if (bodyCode === "PROJECT_MISMATCH") return "PROJECT_MISMATCH";
   if (bodyCode === "PROJECT_NOT_FOUND") return "PROJECT_NOT_FOUND";
   if (bodyCode === "AVATAR_NOT_FOUND") return "AVATAR_NOT_FOUND";
   if (bodyCode === "AVATAR_ALREADY_IMPORTED") return "AVATAR_ALREADY_IMPORTED";
@@ -113,6 +71,8 @@ function friendlyApiMessage(error, endpointUrl) {
   if (error.code === "FORBIDDEN") {
     return "\u2717 This API key does not have permission to access this resource.";
   }
+  if (error.code === "USER_MISMATCH") return "\u2717 The supplied identifiers do not belong to the verified user.";
+  if (error.code === "PROJECT_MISMATCH") return "\u2717 The supplied identifiers do not belong to the verified project.";
   if (error.code === "NOT_FOUND") {
     return endpointUrl ? `\u2717 Asiyst API endpoint was not found.
 Verify that the CLI is using:
@@ -131,68 +91,133 @@ ${endpointUrl}` : "\u2717 Asiyst API endpoint was not found.";
   return "\u2717 Asiyst request failed.";
 }
 
-// src/api/auth.ts
-function asRecord(value) {
-  return value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+// src/api/verification.ts
+function record(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw new ApiError("Received an unexpected response from Asiyst.", 200, "MALFORMED_RESPONSE");
+  }
+  const root = value;
+  const data = root.data && typeof root.data === "object" && !Array.isArray(root.data) ? root.data : root;
+  return data;
+}
+function stringValue(body, ...keys) {
+  for (const key of keys) {
+    if (typeof body[key] === "string" && body[key].trim()) return body[key].trim();
+  }
+  return void 0;
 }
-function bearerToken(apiKey) {
-  const trimmed = apiKey.trim();
-  return trimmed.toLowerCase().startsWith("bearer ") ? trimmed.slice(7).trim() : trimmed;
-}
-function projectFromBody(body) {
-  const nested = asRecord(body.project) ?? asRecord(body.data);
-  const nestedProject = nested ? asRecord(nested.project) ?? nested : void 0;
-  return nestedProject ?? body;
-}
-function parseVerifyKeyResponse(value, apiKey) {
-  const body = asRecord(value);
-  if (!body) throw new ApiError("Received an unexpected response from Asiyst.", 200, "MALFORMED_RESPONSE");
-  if (body.valid === false) {
-    const code = typeof body.code === "string" ? body.code : void 0;
-    if (code === "API_KEY_REVOKED" || body.revoked === true) {
-      throw new ApiError("This API key has been revoked.", 401, "API_KEY_REVOKED");
+function nestedStringValue(body, containers, ...keys) {
+  const direct = stringValue(body, ...keys);
+  if (direct) return direct;
+  for (const container of containers) {
+    const nested = body[container];
+    if (nested && typeof nested === "object" && !Array.isArray(nested)) {
+      const value = stringValue(nested, ...keys);
+      if (value) return value;
     }
-    throw new ApiError("The Asiyst API key was rejected.", 401, "INVALID_API_KEY");
   }
-  if (body.valid !== void 0 && body.valid !== true) {
-    throw new ApiError("Received an unexpected response from Asiyst.", 200, "MALFORMED_RESPONSE");
+  return void 0;
+  return void 0;
+}
+function assertValid(value, name, validator) {
+  const trimmed = value.trim();
+  if (!validator(trimmed)) {
+    const code = name === "User ID" ? "INVALID_USER_ID" : name === "Project ID" ? "INVALID_PROJECT_ID" : name === "Avatar ID" ? "INVALID_AVATAR_ID" : "INVALID_API_KEY";
+    throw new ApiError(`Invalid ${name}.`, 400, code);
   }
-  const project = projectFromBody(body);
-  if (!project) throw new ApiError("Received an unexpected response from Asiyst.", 200, "MALFORMED_RESPONSE");
-  const projectIdCandidate = project.projectId ?? project.project_id ?? project.projectID ?? project.id;
-  const projectId = typeof projectIdCandidate === "string" && isValidPublicIdentifier(projectIdCandidate) ? projectIdCandidate.trim() : void 0;
-  if (!projectId) {
-    throw new ApiError("Received an unexpected response from Asiyst.", 200, "MALFORMED_RESPONSE");
+  return trimmed;
+}
+function assertVerified(body, message) {
+  if (body.valid === false || body.verified === false || body.success === false) {
+    throw new ApiError(stringValue(body, "message", "error") ?? message, 400, "FORBIDDEN");
   }
-  const website = project.website ?? project.websiteUrl ?? project.url ?? project.domain ?? project.website_url;
-  const projectName = project.projectName ?? project.name ?? project.title;
-  const publicKey = project.publicKey ?? project.public_key ?? project.publishableKey;
-  const userId = project.userId ?? project.user_id ?? project.asiystUserId ?? project.asiyst_user_id ?? body.userId ?? body.user_id ?? body.asiystUserId ?? body.asiyst_user_id;
+}
+async function verifyUser(api, userId) {
+  const verifiedUserId = assertValid(userId, "User ID", isValidUserId);
+  const body = record(await api.request("/verify/user", {
+    method: "POST",
+    body: JSON.stringify({ userId: verifiedUserId })
+  }));
+  assertVerified(body, "User ID verification failed.");
+  const returned = nestedStringValue(body, ["user"], "userId", "user_id", "id");
+  if (returned !== verifiedUserId) throw new ApiError("The API returned a different User ID.", 200, "USER_MISMATCH");
+  return { userId: verifiedUserId, userName: stringValue(body, "userName", "name") };
+}
+async function verifyProject(api, userId, projectId) {
+  const verifiedUserId = assertValid(userId, "User ID", isValidUserId);
+  const verifiedProjectId = assertValid(projectId, "Project ID", isValidProjectId);
+  const body = record(await api.request("/verify/project", {
+    method: "POST",
+    body: JSON.stringify({ userId: verifiedUserId, projectId: verifiedProjectId })
+  }));
+  assertVerified(body, "Project verification failed.");
+  const returnedProjectId = nestedStringValue(body, ["project"], "projectId", "project_id", "id");
+  const returnedUserId = nestedStringValue(body, ["user"], "userId", "user_id", "id");
+  if (returnedProjectId && returnedProjectId !== verifiedProjectId) throw new ApiError("The API returned a different Project ID.", 200, "PROJECT_MISMATCH");
+  if (returnedUserId && returnedUserId !== verifiedUserId) throw new ApiError("The API returned a different User ID.", 200, "USER_MISMATCH");
+  return {
+    userId: verifiedUserId,
+    projectId: verifiedProjectId,
+    projectName: nestedStringValue(body, ["project"], "projectName", "project_name", "name"),
+    website: nestedStringValue(body, ["project"], "website", "websiteUrl", "website_url", "domain"),
+    publicKey: nestedStringValue(body, ["project"], "publicKey", "public_key", "publishableKey")
+  };
+}
+async function verifyApiKeyRelationship(api, input) {
+  const userId = assertValid(input.userId, "User ID", isValidUserId);
+  const projectId = assertValid(input.projectId, "Project ID", isValidProjectId);
+  const apiKey = assertValid(input.apiKey, "API key", isValidApiKey);
+  const body = record(await api.request("/verify/api-key", {
+    method: "POST",
+    headers: { Authorization: `Bearer ${apiKey}`, "X-Asiyst-API-Key": apiKey },
+    body: JSON.stringify({ userId, projectId, apiKey })
+  }));
+  assertVerified(body, "API key verification failed.");
+  const returnedUserId = nestedStringValue(body, ["user"], "userId", "user_id", "id");
+  const returnedProjectId = nestedStringValue(body, ["project"], "projectId", "project_id", "id");
+  if (returnedUserId && returnedUserId !== userId) throw new ApiError("The API returned a different User ID.", 200, "USER_MISMATCH");
+  if (returnedProjectId && returnedProjectId !== projectId) throw new ApiError("The API returned a different Project ID.", 200, "PROJECT_MISMATCH");
   return {
-    projectId,
-    projectName: typeof projectName === "string" ? projectName : void 0,
-    website: typeof website === "string" ? website : void 0,
-    publicKey: typeof publicKey === "string" ? publicKey : void 0,
     apiKey,
-    userId: typeof userId === "string" && isValidPublicIdentifier(userId) ? userId : void 0
+    userId,
+    projectId,
+    projectName: nestedStringValue(body, ["project"], "projectName", "project_name", "name"),
+    website: nestedStringValue(body, ["project"], "website", "websiteUrl", "website_url", "domain"),
+    publicKey: nestedStringValue(body, ["project"], "publicKey", "public_key", "publishableKey")
   };
 }
-async function verifyApiKey(api, apiKey, expected) {
-  const token = bearerToken(apiKey);
-  if (!token) throw new ApiError("Invalid API key.", 401, "INVALID_API_KEY");
-  const value = await api.request(VERIFY_KEY_PATH, {
+async function verifyAvatar(api, input) {
+  const userId = assertValid(input.userId, "User ID", isValidUserId);
+  const projectId = assertValid(input.projectId, "Project ID", isValidProjectId);
+  const apiKey = assertValid(input.apiKey, "API key", isValidApiKey);
+  const avatarId = assertValid(input.avatarId, "Avatar ID", isValidAvatarId);
+  const body = record(await api.request("/verify/avatar", {
     method: "POST",
-    headers: {
-      Authorization: "Bearer " + token,
-      "X-Asiyst-API-Key": token
-    },
-    body: JSON.stringify({
-      apiKey: token,
-      ...expected?.userId ? { userId: expected.userId } : {},
-      ...expected?.projectId ? { projectId: expected.projectId } : {}
-    })
-  });
-  return parseVerifyKeyResponse(value, token);
+    headers: { Authorization: `Bearer ${apiKey}`, "X-Asiyst-API-Key": apiKey },
+    body: JSON.stringify({ userId, projectId, apiKey, avatarId })
+  }));
+  assertVerified(body, "Avatar verification failed.");
+  const returnedAvatarId = nestedStringValue(body, ["avatar"], "avatarId", "avatar_id", "id");
+  const returnedUserId = nestedStringValue(body, ["user"], "userId", "user_id", "id");
+  const returnedProjectId = nestedStringValue(body, ["project"], "projectId", "project_id", "id");
+  if (returnedAvatarId && returnedAvatarId !== avatarId) throw new ApiError("The API returned a different Avatar ID.", 200, "AVATAR_MISMATCH");
+  if (returnedUserId && returnedUserId !== userId) throw new ApiError("The API returned a different User ID.", 200, "USER_MISMATCH");
+  if (returnedProjectId && returnedProjectId !== projectId) throw new ApiError("The API returned a different Project ID.", 200, "PROJECT_MISMATCH");
+  return { userId, projectId, avatarId, avatarName: nestedStringValue(body, ["avatar"], "avatarName", "avatar_name", "name") };
+}
+async function createImportSession(api, input) {
+  const userId = assertValid(input.userId, "User ID", isValidUserId);
+  const projectId = assertValid(input.projectId, "Project ID", isValidProjectId);
+  const apiKey = assertValid(input.apiKey, "API key", isValidApiKey);
+  const avatarId = assertValid(input.avatarId, "Avatar ID", isValidAvatarId);
+  const body = record(await api.request("/import-session", {
+    method: "POST",
+    headers: { Authorization: `Bearer ${apiKey}`, "X-Asiyst-API-Key": apiKey },
+    body: JSON.stringify({ userId, projectId, apiKey, avatarId })
+  }));
+  const sessionId = stringValue(body, "sessionId", "session_id", "id");
+  if (!sessionId) throw new ApiError("The API did not return an import session.", 200, "MALFORMED_RESPONSE");
+  return { sessionId, expiresAt: stringValue(body, "expiresAt", "expires_at") };
 }
 
 // src/browser/open.ts
@@ -210,6 +235,47 @@ async function openBrowser(url) {
   }
 }
 
+// src/config/api.ts
+var PRODUCTION_API_ORIGIN = "https://nqhxpgsjofzqudyqkqib.supabase.co/functions/v1/api";
+var CLI_API_BASE_URL = PRODUCTION_API_ORIGIN;
+var VERIFY_KEY_PATH = "/auth/api-key/verify";
+var VERIFY_KEY_URL = `${CLI_API_BASE_URL}${VERIFY_KEY_PATH}`;
+var ASIYST_WEB_URL = "https://asiyst.com";
+var ASIIYST_WEB_URL = ASIYST_WEB_URL;
+var REQUEST_TIMEOUT_MS = 15e3;
+function readEnv(env, ...keys) {
+  for (const key of keys) {
+    const value = env[key]?.trim();
+    if (value) return value;
+  }
+  return void 0;
+}
+function isLocalUrl(value) {
+  try {
+    const url = new URL(value);
+    return url.hostname === "localhost" || url.hostname === "127.0.0.1" || url.hostname === "::1";
+  } catch {
+    return /localhost|127\.0\.0\.1|::1/i.test(value);
+  }
+}
+function resolveApiBaseUrl(env = process.env) {
+  const explicit = readEnv(env, "ASIYST_API_URL", "ASIIYST_API_URL");
+  const development = readEnv(env, "ASIYST_API_MODE", "ASIIYST_API_MODE") === "development";
+  if (explicit) {
+    if (isLocalUrl(explicit)) {
+      return CLI_API_BASE_URL;
+    }
+    return explicit.replace(/\/+$/, "");
+  }
+  if (development) {
+    return CLI_API_BASE_URL;
+  }
+  return CLI_API_BASE_URL;
+}
+function isDebugEnabled(env = process.env) {
+  return readEnv(env, "ASIYST_DEBUG", "ASIIYST_DEBUG") === "1" || readEnv(env, "ASIYST_DEBUG", "ASIIYST_DEBUG") === "true";
+}
+
 // src/config/credentials.ts
 import { execFile as execFile2 } from "child_process";
 import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "fs";
@@ -252,11 +318,11 @@ async function dpapiProtect(plaintext) {
     "[Convert]::ToBase64String($protected)"
   ].join("; ");
   try {
-    const { stdout: stdout3 } = await execFileAsync2("powershell.exe", ["-NoProfile", "-NonInteractive", "-Command", script], {
+    const { stdout: stdout5 } = await execFileAsync2("powershell.exe", ["-NoProfile", "-NonInteractive", "-Command", script], {
       env: { ...process.env, ASIYST_DPAPI_PAYLOAD: plaintext },
       windowsHide: true
     });
-    const value = stdout3.trim();
+    const value = stdout5.trim();
     return value || void 0;
   } catch {
     return void 0;
@@ -271,11 +337,11 @@ async function dpapiUnprotect(payload) {
     "[System.Text.Encoding]::UTF8.GetString($bytes)"
   ].join("; ");
   try {
-    const { stdout: stdout3 } = await execFileAsync2("powershell.exe", ["-NoProfile", "-NonInteractive", "-Command", script], {
+    const { stdout: stdout5 } = await execFileAsync2("powershell.exe", ["-NoProfile", "-NonInteractive", "-Command", script], {
       env: { ...process.env, ASIYST_DPAPI_PAYLOAD: payload },
       windowsHide: true
     });
-    const value = stdout3.trim();
+    const value = stdout5.trim();
     return value || void 0;
   } catch {
     return void 0;
@@ -371,6 +437,7 @@ function readProjectMetadata(cwd) {
       publicKey: typeof body.publicKey === "string" ? body.publicKey : void 0,
       userId: typeof body.userId === "string" ? body.userId : void 0,
       avatarId: typeof body.avatarId === "string" ? body.avatarId : void 0,
+      avatarName: typeof body.avatarName === "string" ? body.avatarName : void 0,
       connected: body.connected === true
     };
   } catch {
@@ -389,6 +456,7 @@ function writeProjectMetadata(cwd, connection) {
     publicKey: connection.publicKey,
     userId: connection.userId,
     avatarId: connection.avatarId,
+    avatarName: connection.avatarName,
     connected: true
   };
   writeFileSync2(projectConfigPath(cwd), `${JSON.stringify(next, null, 2)}
@@ -411,8 +479,8 @@ import { existsSync as existsSync3, readFileSync as readFileSync3 } from "fs";
 import { resolve as resolve3 } from "path";
 function dependencyVersion(pkg) {
   const sections = ["dependencies", "devDependencies", "peerDependencies", "optionalDependencies"];
-  for (const section of sections) {
-    const values = pkg[section];
+  for (const section2 of sections) {
+    const values = pkg[section2];
     if (values && typeof values === "object" && "@asiyst/sdk" in values) {
       const version = values["@asiyst/sdk"];
       return typeof version === "string" ? version : void 0;
@@ -465,9 +533,58 @@ function detectProject(cwd = process.cwd()) {
   };
 }
 
+// src/ui/format.ts
+import { stdout } from "process";
+var supportsColor = Boolean(stdout.isTTY && !process.env.NO_COLOR && process.env.TERM !== "dumb");
+var codes = {
+  reset: "\x1B[0m",
+  bold: "\x1B[1m",
+  dim: "\x1B[2m",
+  cyan: "\x1B[36m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  red: "\x1B[31m"
+};
+function color(code, value) {
+  return supportsColor ? `${codes[code]}${value}${codes.reset}` : value;
+}
+var symbols = {
+  connected: "\u25CF",
+  disconnected: "\u25CB",
+  warning: "\u26A0",
+  error: "\u2715",
+  success: "\u2713",
+  pointer: "\u203A"
+};
+function title(value) {
+  return color("bold", value);
+}
+function section(value) {
+  return color("cyan", value);
+}
+function muted(value) {
+  return color("dim", value);
+}
+function success(value) {
+  return color("green", value);
+}
+function warning(value) {
+  return color("yellow", value);
+}
+function maskSecret(value, visible = 0) {
+  if (visible <= 0) return "\u2022\u2022\u2022\u2022\u2022\u2022\u2022\u2022";
+  return `${value.slice(0, visible)}\u2022\u2022\u2022\u2022\u2022\u2022\u2022\u2022`;
+}
+function printHeader(value, subtitle) {
+  console.log(`
+${title(value)}`);
+  if (subtitle) console.log(muted(subtitle));
+  console.log();
+}
+
 // src/ui/output.ts
-var ok = (label, detail = "") => console.log(`\u2713 ${label}${detail ? ` (${detail})` : ""}`);
-var fail = (label, detail = "") => console.log(`\u2717 ${label}${detail ? `: ${detail}` : ""}`);
+var ok = (label, detail = "") => console.log(`${success(symbols.success)} ${label}${detail ? ` (${detail})` : ""}`);
+var fail = (label, detail = "") => console.log(`${symbols.error} ${label}${detail ? `: ${detail}` : ""}`);
 function projectChecks(project) {
   project.packageJson ? ok("Project detected", typeof project.packageJson.name === "string" ? project.packageJson.name : project.cwd) : fail("Project not detected", "package.json is missing");
   if (project.framework === "Unknown") fail("Framework detected", "No supported project type was identified.");
@@ -475,14 +592,23 @@ function projectChecks(project) {
   ok("Language detected", project.language);
   ok("Node.js detected", process.version);
   ok("Package manager detected", project.packageManager);
-  project.sdkVersion ? ok("@asiyst/sdk detected", project.sdkVersion) : console.log("@asiyst/sdk is not installed. You can connect the project now and install the SDK later.");
-}
-function homeStatus() {
-  console.log("\nConnect your project to Asiyst to view stats.\n");
+  project.sdkVersion ? ok("@asiyst/sdk detected", project.sdkVersion) : console.log(`${muted(symbols.disconnected)} @asiyst/sdk not installed. Install it with your package manager.`);
+}
+function printProjectSummary(project, connected, projectName, website) {
+  console.log(title("Asiyst CLI"));
+  console.log();
+  console.log(section("Project"));
+  console.log(`  ${projectName || (typeof project.packageJson?.name === "string" ? project.packageJson.name : project.cwd)}`);
+  if (website) console.log(`  ${muted(website)}`);
+  const marker = connected ? success(symbols.connected) : muted(symbols.disconnected);
+  console.log(`  ${marker} ${connected ? "Connected" : "Not connected"}`);
+  console.log();
+  console.log(section("Environment"));
+  console.log(`  ${project.framework} \xB7 ${project.language} \xB7 ${project.packageManager}`);
 }
 
 // src/ui/selector.ts
-import { stdin, stdout } from "process";
+import { stdin, stdout as stdout2 } from "process";
 import { clearLine, cursorTo, emitKeypressEvents, moveCursor } from "readline";
 var HIDE_CURSOR = "\x1B[?25l";
 var SHOW_CURSOR = "\x1B[?25h";
@@ -527,12 +653,12 @@ function renderSelectorFrame(output, previousLineCount, lines) {
   return lines.length;
 }
 function restoreTerminal(wasRaw) {
-  stdout.write(SHOW_CURSOR);
+  stdout2.write(SHOW_CURSOR);
   if (stdin.isTTY) stdin.setRawMode?.(wasRaw);
 }
-function selectOption(title, options) {
-  if (!stdin.isTTY || !stdout.isTTY) return Promise.resolve({ type: "cancelled" });
-  return new Promise((resolve5) => {
+function selectOption(title2, options) {
+  if (!stdin.isTTY || !stdout2.isTTY) return Promise.resolve({ type: "cancelled" });
+  return new Promise((resolve6) => {
     let active = 0;
     let renderedLines = 0;
     let settled = false;
@@ -542,24 +668,24 @@ function selectOption(title, options) {
       if (settled) return;
       settled = true;
       stdin.off("keypress", onKeypress);
-      clearSelectorFrame(stdout, renderedLines);
+      clearSelectorFrame(stdout2, renderedLines);
       restoreTerminal(wasRaw);
       stdin.pause();
-      if (confirmation) stdout.write(`${confirmation}
+      if (confirmation) stdout2.write(`${confirmation}
 `);
-      resolve5(result);
+      resolve6(result);
     };
     const render = () => {
-      const lines = [title, "", ...enabled.map((option, index) => `${index === active ? "\u276F" : " "} ${option.label}`)];
-      renderedLines = renderSelectorFrame(stdout, renderedLines, lines);
+      const lines = [title2, "", ...enabled.map((option, index) => `${index === active ? "\u276F" : " "} ${option.label}`)];
+      renderedLines = renderSelectorFrame(stdout2, renderedLines, lines);
     };
     const onKeypress = (_value, key) => {
       if (!key) return;
       if (key.ctrl && key.name === "c") {
-        clearSelectorFrame(stdout, renderedLines);
+        clearSelectorFrame(stdout2, renderedLines);
         restoreTerminal(wasRaw);
         stdin.pause();
-        stdout.write("\n");
+        stdout2.write("\n");
         process.exit(130);
       }
       if (key.name === "escape") return finish({ type: "cancelled" });
@@ -576,30 +702,30 @@ function selectOption(title, options) {
     emitKeypressEvents(stdin);
     stdin.setRawMode?.(true);
     stdin.resume();
-    stdout.write(HIDE_CURSOR);
+    stdout2.write(HIDE_CURSOR);
     stdin.on("keypress", onKeypress);
     render();
   });
 }
 
 // src/ui/secret.ts
-import { stdin as stdin2, stdout as stdout2 } from "process";
+import { stdin as stdin2, stdout as stdout3 } from "process";
 import { emitKeypressEvents as emitKeypressEvents2 } from "readline";
 async function readSecret(prompt) {
   if (!stdin2.isTTY) return void 0;
-  return new Promise((resolve5) => {
+  return new Promise((resolve6) => {
     let value = "";
     let settled = false;
     const wasRaw = Boolean(stdin2.isRaw);
-    stdout2.write(prompt);
+    stdout3.write(prompt);
     const finish = (result) => {
       if (settled) return;
       settled = true;
       stdin2.off("keypress", onKeypress);
       if (stdin2.isTTY) stdin2.setRawMode?.(wasRaw);
       stdin2.pause();
-      stdout2.write("\n");
-      resolve5(result);
+      stdout3.write("\n");
+      resolve6(result);
     };
     const onKeypress = (chunk, key) => {
       if (!key) return;
@@ -624,17 +750,17 @@ async function readSecret(prompt) {
 }
 async function readInput(prompt) {
   if (!stdin2.isTTY) return void 0;
-  return new Promise((resolve5) => {
+  return new Promise((resolve6) => {
     let value = "";
     const onData = (chunk) => {
       value += String(chunk);
       const newline = value.search(/[\r\n]/);
       if (newline >= 0) {
         stdin2.off("data", onData);
-        resolve5(value.slice(0, newline).trim());
+        resolve6(value.slice(0, newline).trim());
       }
     };
-    stdout2.write(prompt);
+    stdout3.write(prompt);
     stdin2.resume();
     stdin2.on("data", onData);
   });
@@ -671,14 +797,19 @@ function revokeTrust(cwd) {
 }
 
 // src/api/client.ts
-function asRecord2(value) {
+function asRecord(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
 }
 function bodyErrorCode(body) {
-  const record = asRecord2(body);
-  const code = record?.code ?? record?.errorCode ?? asRecord2(record?.error)?.code;
+  const record2 = asRecord(body);
+  const code = record2?.code ?? record2?.errorCode ?? record2?.error ?? asRecord(record2?.error)?.code;
   return typeof code === "string" ? code : void 0;
 }
+function bodyErrorMessage(body) {
+  const record2 = asRecord(body);
+  const message = record2?.message ?? asRecord(record2?.error)?.message;
+  return typeof message === "string" && message.trim() ? message.trim() : void 0;
+}
 function isAbortError(error) {
   return error instanceof DOMException && error.name === "AbortError" || error instanceof Error && error.name === "AbortError";
 }
@@ -725,7 +856,7 @@ var ApiClient = class {
       if (code === "API_KEY_REVOKED" || bodyErrorCode(body) === "API_KEY_REVOKED") {
         throw new ApiError("This API key has been revoked.", response.status, "API_KEY_REVOKED");
       }
-      throw new ApiError(`Asiyst API returned HTTP ${response.status}.`, response.status, code);
+      throw new ApiError(bodyErrorMessage(body) ?? `Asiyst API returned HTTP ${response.status}.`, response.status, code);
     }
     if (rawText && body === void 0) {
       if (isDebugEnabled()) {
@@ -738,8 +869,8 @@ var ApiClient = class {
   async health() {
     try {
       const body = await this.request("/health");
-      const record = asRecord2(body);
-      if (record) return record;
+      const record2 = asRecord(body);
+      if (record2) return record2;
     } catch {
     }
     throw new ApiError("Received an unexpected response from Asiyst.", 200, "MALFORMED_RESPONSE");
@@ -775,11 +906,12 @@ Asiyst may read project files and modify Asiyst configuration during setup.`)) {
   return true;
 }
 async function trustCommand(cwd = process.cwd()) {
+  printHeader("Project Trust", cwd);
   await ensureTrusted(cwd);
 }
 function revokeTrustCommand(cwd = process.cwd()) {
   revokeTrust(cwd);
-  console.log("\u2713 Folder trust revoked.");
+  console.log("\u2713 Project trust revoked.");
 }
 
 // src/commands/connect.ts
@@ -793,6 +925,9 @@ async function retryOrCancel(message) {
 }
 function printApiFailure(error) {
   if (error instanceof ApiError) {
+    if (error.status !== void 0 && error.status < 500 && error.code !== "INVALID_API_KEY" && error.code !== "API_KEY_REVOKED") {
+      return `\u2717 ${error.message}`;
+    }
     return friendlyApiMessage(error, error.code === "NOT_FOUND" ? VERIFY_KEY_URL : void 0);
   }
   if (isDebugEnabled() && error instanceof Error) return `\u2717 ${error.message}`;
@@ -818,14 +953,14 @@ async function promptForUserId() {
     return void 0;
   }
   if (!isValidUserId(value)) {
-    console.log("Invalid User ID. It must be a 24-character public Asiyst account ID.");
+    console.log("Invalid Asiyst User ID.");
+    console.log("Expected: exactly 16 characters using letters, numbers, and hyphens only.");
     return void 0;
   }
   return value.trim();
 }
 async function connectCommand(cwd = process.cwd(), api = createApiClient(), cliProjectId) {
-  console.log(`Project folder:
-${cwd}`);
+  printHeader("Connect project", cwd);
   if (!await ensureTrusted(cwd)) return;
   const project = detectProject(cwd);
   projectChecks(project);
@@ -840,50 +975,65 @@ ${cwd}`);
     console.log("Connection cancelled.");
     return;
   }
+  console.log("Opening Asiyst...");
+  if (!await openBrowser(ASIIYST_WEB_URL)) {
+    console.log(`Open this URL manually:
+${ASIIYST_WEB_URL}`);
+  }
+  console.log("Register or log in, complete onboarding, create or select a project, then create an API key.");
+  const userId = await promptForUserId();
+  if (!userId) return;
+  try {
+    await verifyUser(api, userId);
+    ok("User verified.");
+  } catch (error) {
+    console.log(printApiFailure(error));
+    return;
+  }
   const projectIdArg = cliProjectId ?? parseProjectIdArgument(process.argv.slice(2));
   if (projectIdArg === "") {
     console.log("Project ID is required. Use: asiyst connect --project-id <PROJECT_ID>");
     return;
   }
   let projectId = typeof projectIdArg === "string" ? projectIdArg.trim() : "";
-  if (!projectId) {
-    projectId = await promptForProjectId() || "";
-  }
+  if (!projectId) projectId = await promptForProjectId() || "";
   if (!projectId) {
     console.log("Project ID is required. Use: asiyst connect --project-id <PROJECT_ID>");
     return;
   }
-  if (!isValidPublicIdentifier(projectId)) {
-    console.log("Invalid Project ID. Use a public project ID such as K8mP2xQ7_vL4N9cR5T1zB6Y3");
+  if (!isValidProjectId(projectId)) {
+    console.log("Invalid Project ID. It must be exactly 24 characters.");
     return;
   }
-  const userId = await promptForUserId();
-  if (!userId) return;
-  console.log("Opening Asiyst...");
-  if (!await openBrowser(ASIIYST_WEB_URL)) {
-    console.log(`Open this URL manually:
-${ASIIYST_WEB_URL}`);
+  let verifiedProject;
+  try {
+    verifiedProject = await verifyProject(api, userId, projectId);
+    ok("Project verified.");
+  } catch (error) {
+    console.log(printApiFailure(error));
+    return;
   }
-  console.log("Register or log in, complete onboarding, create or select a project, then create an API key.");
   for (; ; ) {
     const apiKey = await readSecret("Paste your Asiyst API key: ");
     if (apiKey === void 0) {
       console.log("Connection cancelled.");
       return;
     }
-    if (!apiKey) {
-      fail("Invalid API key.");
+    if (!isValidApiKey(apiKey)) {
+      fail("Invalid API key. It must be exactly 32 characters.");
       continue;
     }
     try {
-      const connected = await verifyApiKey(api, apiKey, { userId, projectId });
-      if (connected.projectId && connected.projectId !== projectId) {
-        console.log("The provided Project ID does not match the authenticated project.");
-        return;
-      }
-      const finalConnection = { ...connected, projectId, userId };
+      const connected = await verifyApiKeyRelationship(api, { userId, projectId, apiKey });
+      const finalConnection = {
+        ...connected,
+        projectName: connected.projectName ?? verifiedProject.projectName,
+        website: connected.website ?? verifiedProject.website,
+        publicKey: connected.publicKey ?? verifiedProject.publicKey,
+        projectId,
+        userId
+      };
       ok("API key verified.");
-      ok("Project ID verified.");
       await saveConnection(cwd, finalConnection);
       writeProjectMetadata(cwd, finalConnection);
       ok("Project connected successfully.");
@@ -942,43 +1092,51 @@ async function logoutCommand() {
 async function statusCommand(cwd = process.cwd(), api = createApiClient()) {
   const stored = await loadConnection(cwd);
   if (!stored?.apiKey) {
-    const metadata = readProjectMetadata(cwd);
-    if (metadata?.connected && metadata.projectId) {
-      console.log("\u2713 Connected");
-      console.log(`Project:
-${metadata.projectId}`);
-      if (metadata.userId) console.log(`User ID:
-${metadata.userId}`);
-      return;
-    }
-    console.log("Connect your website to show stats.");
+    printHeader("Asiyst Project Status");
+    printProjectSummary(detectProject(cwd), false);
+    console.log(`
+${warning(symbols.warning)} Not connected to Asiyst.`);
     return;
   }
   if (!stored.userId || !stored.projectId) {
-    console.log("\u2717 Connection is missing a User ID or Project ID. Please run:\nasiyst connect");
+    console.log(`${symbols.error} Connection is missing a User ID or Project ID. Please run:
+asiyst connect`);
     return;
   }
   try {
-    const connected = await verifyApiKey(api, stored.apiKey, {
+    const connected = await verifyApiKeyRelationship(api, {
       userId: stored.userId,
-      projectId: stored.projectId
+      projectId: stored.projectId,
+      apiKey: stored.apiKey
     });
+    if (stored.avatarId) {
+      await verifyAvatar(api, {
+        userId: stored.userId,
+        projectId: stored.projectId,
+        apiKey: stored.apiKey,
+        avatarId: stored.avatarId
+      });
+    }
     const projectId = stored.projectId || connected.projectId;
     const userId = stored.userId || connected.userId;
-    console.log("\u2713 Connected");
-    if (userId) console.log(`
-User ID:
-${userId}`);
+    printHeader("Asiyst Project Status");
+    printProjectSummary(detectProject(cwd), true, connected.projectName, connected.website);
     console.log(`
-Project ID:
-${projectId || connected.projectName || "Unknown"}`);
-    console.log("\nAPI Key:\n\u2022\u2022\u2022\u2022\u2022\u2022\u2022\u2022");
-    if (stored.avatarId) console.log(`
-Avatar:
-${stored.avatarId}`);
-    if (connected.website) console.log(`
-Website:
-${connected.website}`);
+${section("Identifiers")}`);
+    if (userId) console.log(`  User ID: ${maskSecret(userId)}`);
+    console.log(`  Project ID: ${projectId}`);
+    console.log(`  API Key: ${maskSecret(stored.apiKey)}`);
+    console.log(`
+${section("Integration")}`);
+    console.log(`  User: ${success(symbols.success)} Connected`);
+    console.log(`  Project: ${success(symbols.success)} ${connected.projectName ?? projectId}`);
+    if (stored.avatarId) console.log(`  Avatar: ${success(symbols.success)} ${stored.avatarName ?? stored.avatarId}`);
+    else console.log(`  Avatar: ${symbols.error} Not imported`);
+    const detection = detectProject(cwd);
+    console.log(`  SDK: ${detection.sdkVersion ? `${success(symbols.success)} Installed (${detection.sdkVersion})` : `${symbols.error} Not installed`}`);
+    console.log(`  Integration: ${detection.sdkVersion && stored.avatarId ? `${success(symbols.success)} Configured` : `${symbols.error} Not configured`}`);
+    console.log(`
+${success(symbols.success)} Everything looks good.`);
   } catch (error) {
     if (error instanceof ApiError && error.code === "API_KEY_REVOKED") {
       console.log("\u2717 API key revoked.");
@@ -986,10 +1144,10 @@ ${connected.website}`);
       return;
     }
     if (error instanceof ApiError && (error.code === "INVALID_API_KEY" || error.code === "FORBIDDEN")) {
-      console.log("\u2717 Connection invalid.");
+      console.log(`${symbols.error} Connection invalid. Run \`asiyst connect\` to reconnect.`);
       return;
     }
-    console.log("\u2717 Connection invalid.");
+    console.log(`${symbols.error} Connection invalid. Run \`asiyst doctor\` for diagnostics.`);
   }
 }
 
@@ -1013,8 +1171,21 @@ function parseAvatarImportResponse(value, projectId, userId, avatarId) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
     throw new ApiError("Received an unexpected response from Asiyst.", 200, "MALFORMED_RESPONSE");
   }
-  const body = value;
+  const response = value;
+  const body = response.data && typeof response.data === "object" && !Array.isArray(response.data) ? response.data : response;
   const imported = body.imported === true || body.success === true || body.status === "imported";
+  const alreadyImported = body.code === "AVATAR_ALREADY_IMPORTED" || body.status === "already_imported";
+  if (alreadyImported) {
+    return {
+      imported: true,
+      alreadyImported: true,
+      avatarId,
+      projectId,
+      userId,
+      avatarName: typeof body.avatarName === "string" ? body.avatarName : void 0,
+      publicKey: typeof body.publicKey === "string" ? body.publicKey : void 0
+    };
+  }
   if (!imported) {
     const code = typeof body.code === "string" ? body.code : "IMPORT_FAILED";
     const supportedCode = ["AVATAR_NOT_FOUND", "AVATAR_ALREADY_IMPORTED", "FORBIDDEN", "PROJECT_NOT_FOUND", "CONFLICT"].includes(code) ? code : "IMPORT_FAILED";
@@ -1024,24 +1195,33 @@ function parseAvatarImportResponse(value, projectId, userId, avatarId) {
   if (returnedAvatarId !== void 0 && returnedAvatarId !== avatarId) {
     throw new ApiError("The API returned a different avatar than requested.", 200, "AVATAR_MISMATCH");
   }
+  const returnedProjectId = body.projectId ?? body.project_id;
+  if (returnedProjectId !== void 0 && returnedProjectId !== projectId) {
+    throw new ApiError("The API returned a different project than requested.", 200, "PROJECT_MISMATCH");
+  }
+  const returnedUserId = body.userId ?? body.user_id;
+  if (returnedUserId !== void 0 && returnedUserId !== userId) {
+    throw new ApiError("The API returned a different user than requested.", 200, "USER_MISMATCH");
+  }
   return {
     imported: true,
     avatarId,
     projectId,
     userId,
-    avatarName: typeof body.avatarName === "string" ? body.avatarName : void 0
+    avatarName: typeof body.avatarName === "string" ? body.avatarName : void 0,
+    publicKey: typeof body.publicKey === "string" ? body.publicKey : void 0
   };
 }
 async function importAvatar(api, input) {
   const userId = requireIdentifier(input.userId, "User ID", isValidUserId);
-  const projectId = requireIdentifier(input.projectId, "Project ID", isValidPublicIdentifier);
+  const projectId = requireIdentifier(input.projectId, "Project ID", isValidProjectId);
   const avatarId = requireIdentifier(input.avatarId, "Avatar ID", isValidAvatarId);
   const apiKey = input.apiKey.trim();
-  if (!apiKey) throw new ApiError("An API key is required.", 401, "INVALID_API_KEY");
+  if (!isValidApiKey(apiKey)) throw new ApiError("Invalid API key. It must be exactly 32 characters.", 401, "INVALID_API_KEY");
   const value = await api.request(`/cli/projects/${encodeURIComponent(projectId)}/avatars/import`, {
     method: "POST",
     headers: {
-      Authorization: `Bearer ${apiKey}`,
+      Authorization: "Bearer " + apiKey,
       "X-Asiyst-API-Key": apiKey
     },
     body: JSON.stringify({ userId, projectId, avatarId })
@@ -1083,7 +1263,7 @@ async function verifyCommand(cwd = process.cwd()) {
 import { readFileSync as readFileSync5 } from "fs";
 import { fileURLToPath } from "url";
 function readCurrentVersion() {
-  if ("1.1.1") return "1.1.1";
+  if ("1.1.2") return "1.1.2";
   try {
     const packageJson = JSON.parse(readFileSync5(fileURLToPath(new URL("../package.json", import.meta.url)), "utf8"));
     if (packageJson && typeof packageJson === "object" && typeof packageJson.version === "string") {
@@ -1130,12 +1310,234 @@ ${url}`);
   else console.log(`Opening ${url}`);
 }
 
+// src/integration/writer.ts
+import { execFile as execFile3 } from "child_process";
+import { existsSync as existsSync5, mkdirSync as mkdirSync4, readFileSync as readFileSync6, writeFileSync as writeFileSync4 } from "fs";
+import { dirname, join as join4, relative, resolve as resolve5 } from "path";
+import { promisify as promisify3 } from "util";
+var execFileAsync3 = promisify3(execFile3);
+var MARKER_START = "// ASIIYST CLI START";
+var MARKER_END = "// ASIIYST CLI END";
+function componentSource(values, extension) {
+  if (extension === "ts" || extension === "js") {
+    return `${MARKER_START}
+import { Asiyst } from "@asiyst/sdk";
+
+void Asiyst.init({
+  projectId: ${JSON.stringify(values.projectId)},
+  publicKey: ${JSON.stringify(values.publicKey)},
+  avatarId: ${JSON.stringify(values.avatarId)},
+  position: "bottom-right",
+});
+${MARKER_END}
+`;
+  }
+  const importLine = extension === "tsx" ? 'import * as React from "react";' : 'import React from "react";';
+  return `${MARKER_START}
+${importLine}
+import { Asiyst } from "@asiyst/sdk";
+
+let asiystStarted = false;
+
+export function AsiystAssistant() {
+  React.useEffect(() => {
+    if (asiystStarted) return;
+    asiystStarted = true;
+    void Asiyst.init({
+      projectId: ${JSON.stringify(values.projectId)},
+      publicKey: ${JSON.stringify(values.publicKey)},
+      avatarId: ${JSON.stringify(values.avatarId)},
+      position: "bottom-right",
+    }).catch((error) => {
+      asiystStarted = false;
+      console.error("Asiyst failed to initialize.", error);
+    });
+  }, []);
+
+  return null;
+}
+${MARKER_END}
+`;
+}
+function read(path) {
+  return readFileSync6(path, "utf8");
+}
+function findFirst(cwd, paths) {
+  return paths.map((path) => resolve5(cwd, path)).find((path) => existsSync5(path));
+}
+function isTypeScript(project) {
+  return project.language === "TypeScript" || existsSync5(resolve5(project.cwd, "tsconfig.json"));
+}
+function pathsFor(project) {
+  if (project.framework === "Vanilla TypeScript" || project.framework === "Vanilla JavaScript") {
+    const extension2 = project.framework === "Vanilla TypeScript" ? "ts" : "js";
+    return {
+      component: join4("src", `asiyst.${extension2}`),
+      entry: findFirst(project.cwd, [`src/index.${extension2}`, `index.${extension2}`]),
+      extension: extension2
+    };
+  }
+  const extension = isTypeScript(project) ? "tsx" : "jsx";
+  const component = join4("src", "components", `AsiystAssistant.${extension}`);
+  if (project.framework === "Next.js") {
+    const appEntry = findFirst(project.cwd, ["src/app/layout.tsx", "src/app/layout.jsx", "app/layout.tsx", "app/layout.jsx"]);
+    if (appEntry) return { component, entry: appEntry, extension: appEntry.endsWith(".tsx") ? "tsx" : "jsx" };
+    const pagesEntry = findFirst(project.cwd, ["src/pages/_app.tsx", "src/pages/_app.jsx", "pages/_app.tsx", "pages/_app.jsx"]);
+    if (pagesEntry) return { component, entry: pagesEntry, extension: pagesEntry.endsWith(".tsx") ? "tsx" : "jsx" };
+    return { component, extension };
+  }
+  const entry = findFirst(project.cwd, [
+    "src/main.tsx",
+    "src/main.jsx",
+    "src/main.ts",
+    "src/main.js",
+    "src/index.tsx",
+    "src/index.jsx",
+    "src/index.ts",
+    "src/index.js"
+  ]);
+  return { component, entry, extension: entry?.endsWith(".tsx") || entry?.endsWith(".ts") ? "tsx" : "jsx" };
+}
+function updateComponent(path, source, values) {
+  if (!existsSync5(path)) {
+    mkdirSync4(dirname(path), { recursive: true });
+    writeFileSync4(path, source, "utf8");
+    return "create";
+  }
+  const current = read(path);
+  const start = current.indexOf(MARKER_START);
+  const end = current.indexOf(MARKER_END);
+  if (start >= 0 && end >= start) {
+    const next2 = current.slice(0, start) + source.trimEnd() + current.slice(end + MARKER_END.length);
+    if (next2 === current) return "unchanged";
+    writeFileSync4(path, next2, "utf8");
+    return "update";
+  }
+  const replacements = {
+    projectId: JSON.stringify(values.projectId),
+    publicKey: JSON.stringify(values.publicKey),
+    avatarId: JSON.stringify(values.avatarId)
+  };
+  let next = source;
+  for (const [name, value] of Object.entries(replacements)) {
+    const pattern = new RegExp(`(${name}\\s*:\\s*)["'\`][^"'\`]+["'\`]`);
+    if (!pattern.test(next)) {
+      throw new Error(`Existing Asiyst component is not safely updateable: ${path}`);
+    }
+    next = next.replace(pattern, `$1${value}`);
+  }
+  if (next === source) return "unchanged";
+  writeFileSync4(path, next, "utf8");
+  return "update";
+}
+function updateEntry(path, componentPath) {
+  const current = read(path);
+  const importPath = relative(dirname(path), resolve5(componentPath)).replace(/\\/g, "/").replace(/\.(tsx|jsx)$/, "").replace(/^\.\//, "");
+  const importLine = componentPath.endsWith(".ts") || componentPath.endsWith(".js") ? `import "./${importPath}";` : `import { AsiystAssistant } from "./${importPath}";`;
+  const hasImport = current.includes("AsiystAssistant") && current.includes("@asiyst/sdk");
+  const nextImport = hasImport ? current : `${importLine}
+${current}`;
+  const componentPattern = /<AsiystAssistant\s*\/>/;
+  let next = componentPattern.test(nextImport) ? nextImport : nextImport;
+  if (!componentPattern.test(nextImport)) {
+    if (/\{children\}/.test(nextImport)) {
+      next = nextImport.replace(/\{children\}/, "<AsiystAssistant />\n        {children}");
+    } else if (/<App\s*\/>/.test(nextImport)) {
+      next = nextImport.replace(/<App\s*\/>/, "<><AsiystAssistant /><App /></>");
+    } else if (/<Component\s+\{\.\.\.pageProps\}\s*\/>/.test(nextImport)) {
+      next = nextImport.replace(/<Component\s+\{\.\.\.pageProps\}\s*\/>/, "<><AsiystAssistant /><Component {...pageProps} /></>");
+    } else if (componentPath.endsWith(".ts") || componentPath.endsWith(".js")) {
+      next = nextImport;
+    } else {
+      throw new Error(`Could not find a safe render location in ${path}. Add <AsiystAssistant /> to this entry point.`);
+    }
+  }
+  if (next === current) return "unchanged";
+  writeFileSync4(path, next, "utf8");
+  return "update";
+}
+function planIntegration(project, values) {
+  if (!values.projectId || !values.publicKey || !values.avatarId) {
+    throw new Error("Verified projectId, publicKey, and avatarId are required before configuring the SDK.");
+  }
+  const paths = pathsFor(project);
+  const componentPath = resolve5(project.cwd, paths.component);
+  const entryPath = paths.entry;
+  if (!entryPath && !project.framework.startsWith("Vanilla") && project.framework !== "Next.js" && project.framework !== "React" && project.framework !== "Vite") {
+    return {
+      framework: project.framework,
+      sdkInstalled: Boolean(project.sdkVersion),
+      sdkVersion: project.sdkVersion,
+      componentPath,
+      componentAction: existsSync5(componentPath) ? "update" : "create",
+      entryAction: "unsupported",
+      reason: "No supported React entry point was detected. Add AsiystAssistant to the website entry point manually."
+    };
+  }
+  return {
+    framework: project.framework,
+    sdkInstalled: Boolean(project.sdkVersion),
+    sdkVersion: project.sdkVersion,
+    componentPath,
+    entryPath,
+    componentAction: existsSync5(componentPath) ? "update" : "create",
+    entryAction: entryPath ? "update" : "unsupported",
+    reason: entryPath ? void 0 : "No supported application entry point was detected."
+  };
+}
+async function installSdk(project) {
+  const commands = {
+    npm: { command: "npm", args: ["install", "@asiyst/sdk"] },
+    pnpm: { command: "pnpm", args: ["add", "@asiyst/sdk"] },
+    yarn: { command: "yarn", args: ["add", "@asiyst/sdk"] },
+    bun: { command: "bun", args: ["add", "@asiyst/sdk"] }
+  };
+  const selected = commands[project.packageManager] ?? commands.npm;
+  await execFileAsync3(selected.command, selected.args, { cwd: project.cwd, windowsHide: true });
+}
+function applyIntegration(project, values, plan = planIntegration(project, values)) {
+  if (plan.entryAction === "unsupported" || !plan.entryPath) {
+    throw new Error(plan.reason ?? "The project entry point could not be detected safely.");
+  }
+  const paths = pathsFor(project);
+  const componentAction = updateComponent(plan.componentPath, componentSource(values, paths.extension), values);
+  const entryAction = updateEntry(plan.entryPath, plan.componentPath);
+  return { ...plan, componentAction, entryAction, installed: plan.sdkInstalled };
+}
+function printDryRun(plan) {
+  console.log(`Framework: ${plan.framework}`);
+  console.log(`SDK: ${plan.sdkInstalled ? `installed${plan.sdkVersion ? ` (${plan.sdkVersion})` : ""}` : "missing"}`);
+  console.log(`Component: ${plan.componentAction} ${plan.componentPath}`);
+  console.log(`Entry point: ${plan.entryPath ? `${plan.entryAction} ${plan.entryPath}` : "not detected"}`);
+  if (plan.reason) console.log(`Note: ${plan.reason}`);
+}
+function readIntegrationValues(plan) {
+  if (!existsSync5(plan.componentPath)) return {};
+  const source = read(plan.componentPath);
+  const value = (name) => {
+    const match = source.match(new RegExp(`${name}\\s*:\\s*["'\`]([^"'\`]+)["'\`]`));
+    return match?.[1];
+  };
+  return {
+    projectId: value("projectId"),
+    publicKey: value("publicKey"),
+    avatarId: value("avatarId")
+  };
+}
+
 // src/commands/avatar.ts
 function parseAvatarId(argv) {
   const index = argv.findIndex((value) => value === "--avatar-id");
   if (index >= 0) return argv[index + 1];
   const inline = argv.find((value) => value.startsWith("--avatar-id="));
-  return inline?.slice("--avatar-id=".length);
+  return inline?.slice("--avatar-id=".length) || argv.slice(1).find((value) => !value.startsWith("--"));
+}
+async function confirm2(message) {
+  const result = await selectOption(message, [
+    { label: "Continue", value: true },
+    { label: "Cancel", value: false }
+  ]);
+  return result.type === "selected" && result.value;
 }
 async function avatarImportCommand(cwd = process.cwd(), api = createApiClient(), suppliedAvatarId) {
   const stored = await loadConnection(cwd);
@@ -1148,24 +1550,112 @@ async function avatarImportCommand(cwd = process.cwd(), api = createApiClient(),
     console.log("Invalid Avatar ID. It must contain exactly 10 alphanumeric characters.");
     return;
   }
+  console.log("Opening Asiyst Avatar Studio...");
+  if (!await openBrowser(ASIIYST_WEB_URL)) {
+    console.log(`Open this URL manually:
+${ASIIYST_WEB_URL}`);
+  }
+  console.log("Configure and save your avatar in Avatar Studio, then return here.");
+  const project = detectProject(cwd);
+  const dryRun = process.argv.includes("--dry-run");
+  const detectedProjectId = project.config.projectId;
+  if (detectedProjectId && detectedProjectId !== stored.projectId) {
+    console.log(`Existing projectId ${detectedProjectId} differs from verified project ${stored.projectId}.`);
+    if (!await confirm2("Switch this website to the verified project?")) return;
+  }
+  const existingPlan = planIntegration(project, {
+    projectId: stored.projectId,
+    publicKey: stored.publicKey ?? "pending-public-key",
+    avatarId: avatarId.trim()
+  });
+  const existing = readIntegrationValues(existingPlan);
+  if (existing.projectId && existing.projectId !== stored.projectId) {
+    console.log(`\u2717 Existing integration uses project ${existing.projectId}, but the verified project is ${stored.projectId}.`);
+    if (!await confirm2("Replace the existing project configuration?")) return;
+  }
+  if (existing.avatarId && existing.avatarId !== avatarId.trim()) {
+    console.log(`\u2717 Existing integration uses avatar ${existing.avatarId}, but the verified avatar is ${avatarId.trim()}.`);
+    if (!await confirm2("Replace the existing avatar configuration?")) return;
+  }
   try {
+    if (dryRun) {
+      const plan2 = planIntegration(project, {
+        projectId: stored.projectId,
+        publicKey: stored.publicKey ?? "",
+        avatarId: avatarId.trim()
+      });
+      printDryRun(plan2);
+      return;
+    }
+    const verifiedConnection = await verifyApiKeyRelationship(api, {
+      userId: stored.userId,
+      projectId: stored.projectId,
+      apiKey: stored.apiKey
+    });
+    await verifyAvatar(api, {
+      userId: stored.userId,
+      projectId: stored.projectId,
+      apiKey: stored.apiKey,
+      avatarId
+    });
+    await createImportSession(api, {
+      userId: stored.userId,
+      projectId: stored.projectId,
+      apiKey: stored.apiKey,
+      avatarId
+    });
+    const shouldImport = await confirm2("Import this avatar into this website?");
+    if (!shouldImport) {
+      console.log("Avatar import cancelled. Your verified connection has been saved.");
+      return;
+    }
     const result = await importAvatar(api, {
       userId: stored.userId,
       projectId: stored.projectId,
       apiKey: stored.apiKey,
       avatarId
     });
-    await saveConnection(cwd, { ...stored, avatarId: result.avatarId });
-    console.log(`\u2713 Avatar ${result.avatarId} imported into project ${result.projectId}.`);
+    const publicKey = stored.publicKey ?? verifiedConnection.publicKey ?? result.publicKey;
+    if (!publicKey) {
+      console.log("\u2717 The verified project did not return a public SDK key. No files were changed.");
+      return;
+    }
+    const plan = planIntegration(detectProject(cwd), {
+      projectId: result.projectId,
+      publicKey,
+      avatarId: result.avatarId
+    });
+    if (!plan.sdkInstalled) {
+      console.log(`Installing @asiyst/sdk with ${project.packageManager}...`);
+      await installSdk(project);
+    }
+    const configured = applyIntegration(detectProject(cwd), {
+      projectId: result.projectId,
+      publicKey,
+      avatarId: result.avatarId
+    });
+    const next = { ...stored, avatarId: result.avatarId, avatarName: result.avatarName, publicKey };
+    await saveConnection(cwd, next);
+    writeProjectMetadata(cwd, next);
+    console.log("\u2713 Avatar verified");
+    console.log("\u2713 Project verified");
+    console.log("\u2713 API key verified");
+    console.log("\u2713 SDK installed");
+    console.log(`\u2713 Asiyst integration ${configured.componentAction === "unchanged" ? "already " : ""}configured`);
+    console.log(`\u2713 Avatar ${result.alreadyImported ? "already imported" : "imported"}`);
+    console.log(`
+Your Asiyst avatar is ready.`);
   } catch (error) {
     if (error instanceof ApiError) {
       if (error.code === "FORBIDDEN") console.log("\u2717 You do not have permission to import an avatar into this project.");
+      else if (error.code === "USER_MISMATCH") console.log("\u2717 The avatar is not owned by the verified Asiyst user.");
+      else if (error.code === "PROJECT_MISMATCH") console.log("\u2717 The avatar is not assigned to the verified project.");
       else if (error.code === "NOT_FOUND") console.log("\u2717 Project or avatar was not found.");
       else if (error.code === "CONFLICT" || error.code === "AVATAR_ALREADY_IMPORTED") console.log("\u2717 This avatar is already imported into the project.");
       else console.log(`\u2717 ${error.message}`);
       return;
     }
-    console.log("\u2717 Unable to import the avatar.");
+    console.log(`\u2717 ${error instanceof Error ? error.message : "Unable to import the avatar."}`);
   }
 }
 async function avatarCommand(cwd = process.cwd(), argv = process.argv.slice(2)) {
@@ -1188,55 +1678,79 @@ ${ASIIYST_WEB_URL}`);
 }
 
 // src/commands/interactive.ts
-function interactiveHelp() {
-  console.log(`
-Asiyst CLI
-
-Usage: asiyst [command]
-
-Commands
-  connect       Connect this project to Asiyst
-  avatar import Import an avatar into the connected project
-  status        Show connection status
-  health        Check Asiyst API connectivity
-  disconnect    Remove local connection information
-  help          Show available commands
-  version       Show CLI version
-
-Also available
-  trust         Trust this project folder
-  revoke-trust  Revoke folder trust
-  doctor        Run diagnostics
-  update        Check for CLI updates
+import { stdin as stdin3, stdout as stdout4 } from "process";
+import { emitKeypressEvents as emitKeypressEvents3 } from "readline";
 
-Examples
-  asiyst connect
-  asiyst status
-  asiyst disconnect
-`);
-}
-async function interactiveHome() {
-  homeStatus();
-  for (; ; ) {
-    const result = await selectOption("What would you like to do?", [
-      { label: "Connect", value: "connect" },
-      { label: "Status", value: "status" },
-      { label: "Help", value: "help" },
-      { label: "Exit", value: "exit" }
-    ]);
-    if (result.type !== "selected" || result.value === "exit") {
-      break;
+// src/commands/health.ts
+async function healthCommand(api = createApiClient(), cwd = process.cwd()) {
+  printHeader("Asiyst Health Check");
+  const project = detectProject(cwd);
+  let healthy = true;
+  ok("Project detected", project.framework);
+  if (project.sdkVersion) ok("SDK installed", project.sdkVersion);
+  else {
+    fail("SDK installed", "Run the avatar import command to install it");
+    healthy = false;
+  }
+  try {
+    await api.health();
+    ok("Asiyst API reachable");
+  } catch {
+    fail("Asiyst API reachable", "Unable to reach Asiyst API");
+    console.log(`
+Health: ${warning(symbols.warning)} Action required`);
+    return;
+  }
+  const stored = await loadConnection(cwd);
+  if (!stored?.apiKey || !stored.userId || !stored.projectId) {
+    console.log(`
+Health: ${warning(symbols.warning)} Action required`);
+    console.log("Run `asiyst connect` to connect this project.");
+    return;
+  }
+  ok("Authentication valid");
+  try {
+    await verifyApiKeyRelationship(api, {
+      userId: stored.userId,
+      projectId: stored.projectId,
+      apiKey: stored.apiKey
+    });
+    ok("Project authorized");
+    const metadata = readProjectMetadata(cwd);
+    if (metadata?.avatarId) {
+      await verifyAvatar(api, {
+        userId: stored.userId,
+        projectId: stored.projectId,
+        apiKey: stored.apiKey,
+        avatarId: metadata.avatarId
+      });
+      ok("Avatar verified", metadata.avatarName ?? metadata.avatarId);
+    } else {
+      fail("Avatar", "No imported avatar is recorded for this project");
+      healthy = false;
     }
-    if (result.value === "connect") await connectCommand();
-    else if (result.value === "status") await statusCommand();
-    else if (result.value === "help") interactiveHelp();
-    else if (result.value === "version") console.log(readCurrentVersion());
+    if (metadata?.projectId === stored.projectId && metadata.publicKey) ok("Local configuration", "Project and public key present");
+    else {
+      fail("Local configuration", "Project metadata is incomplete");
+      healthy = false;
+    }
+    if (project.sdkVersion && metadata?.avatarId) ok("Website integration", "SDK and avatar are configured");
+    else {
+      fail("Website integration", "Run `asiyst avatar import`");
+      healthy = false;
+    }
+    console.log(`
+Health: ${healthy ? `${success(symbols.connected)} Healthy` : `${warning(symbols.warning)} Action required`}`);
+  } catch {
+    fail("Project authorization", "Run `asiyst connect` to reconnect");
+    console.log(`
+Health: ${warning(symbols.warning)} Action required`);
   }
 }
 
 // src/update/check.ts
 import { execFileSync } from "child_process";
-import { readFileSync as readFileSync6 } from "fs";
+import { readFileSync as readFileSync7 } from "fs";
 var PACKAGE_NAME = "@asiyst/cli";
 var REGISTRY_URL = "https://registry.npmjs.org/%40asiyst%2Fcli/latest";
 var TIMEOUT_MS = 800;
@@ -1308,7 +1822,7 @@ function detectInstallKind(executablePath = process.argv[1] ?? "", env = process
 }
 function installedVersion(packageRoot) {
   try {
-    const value = JSON.parse(readFileSync6(`${packageRoot}/package.json`, "utf8"));
+    const value = JSON.parse(readFileSync7(`${packageRoot}/package.json`, "utf8"));
     return value && typeof value === "object" && typeof value.version === "string" ? value.version : void 0;
   } catch {
     return void 0;
@@ -1331,18 +1845,18 @@ function installLatest(latestVersion, kind, executablePath = process.argv[1] ??
 
 // src/commands/update.ts
 async function updateCommand() {
+  printHeader("Asiyst CLI Update");
   const result = await checkForUpdate();
   if (!result.latestVersion || compareVersions(result.latestVersion, result.currentVersion) <= 0) {
-    console.log(`\u2713 Asiyst CLI is already up to date.
+    console.log(`${success(symbols.success)} Latest version
 
 Current version: ${result.currentVersion}`);
     return;
   }
-  console.log(`
-Update available
+  console.log(`${warning(symbols.warning)} Update available
 
 Current version: ${result.currentVersion}
-New version: ${result.latestVersion}
+Latest version: ${result.latestVersion}
 `);
   if (!process.stdin.isTTY || !await confirm(`Update Asiyst CLI from ${result.currentVersion} to ${result.latestVersion}?`)) {
     console.log("Update cancelled.");
@@ -1359,7 +1873,7 @@ New version: ${result.latestVersion}
     if (!installed || compareVersions(installed, result.latestVersion) !== 0) {
       throw new Error("installed version could not be verified");
     }
-    console.log(`\u2713 Verifying installation
+    console.log(`${success(symbols.success)} Verifying installation
 
 Asiyst CLI updated from ${result.currentVersion} to ${installed}.
 Restart Asiyst to use the new version.`);
@@ -1369,13 +1883,201 @@ ${error instanceof Error ? error.message : "Installation could not be verified."
   }
 }
 
-// src/commands/health.ts
-async function healthCommand(api = createApiClient()) {
-  try {
-    await api.health();
-    console.log("\u2713 Asiyst API is reachable.");
-  } catch {
-    console.log("\u2717 Unable to reach Asiyst API.");
+// src/commands/interactive.ts
+function interactiveHelp() {
+  console.log(`
+Asiyst CLI
+
+Usage: asiyst [command]
+
+Commands
+  connect       Connect this project to Asiyst
+  status        Show connection status
+  avatar        Manage and import avatars
+  health        Check Asiyst API connectivity
+  disconnect    Remove local connection information
+  help          Show available commands
+  version       Show CLI version
+
+Also available
+  trust         Trust this project folder
+  revoke-trust  Revoke folder trust
+  doctor        Run diagnostics
+  update        Check for CLI updates
+
+Examples
+  asiyst connect
+  asiyst status
+  asiyst health
+  asiyst avatar import
+  asiyst avatar import <avatar-id>
+  asiyst disconnect
+`);
+}
+var COMMANDS = [
+  { input: "connect", label: "Connect this project to Asiyst" },
+  { input: "status", label: "Show connection status" },
+  { input: "avatar", label: "Manage avatars" },
+  { input: "avatar import", label: "Import an avatar" },
+  { input: "health", label: "Check Asiyst API health" },
+  { input: "disconnect", label: "Disconnect this project" },
+  { input: "help", label: "Show available commands" },
+  { input: "version", label: "Show CLI version" },
+  { input: "update", label: "Check for CLI updates" },
+  { input: "exit", label: "Exit the interactive CLI" }
+];
+function suggestions(value) {
+  const query = value.trim().toLowerCase();
+  if (!query) return COMMANDS;
+  return COMMANDS.filter((command) => command.input.startsWith(query));
+}
+function readCommand() {
+  if (!stdin3.isTTY || !stdout4.isTTY) return Promise.resolve(void 0);
+  return new Promise((resolve6) => {
+    let value = "";
+    let active = 0;
+    let settled = false;
+    let renderedLines = 0;
+    const wasRaw = Boolean(stdin3.isRaw);
+    const clear = () => {
+      if (renderedLines === 0) return;
+      stdout4.write(`\x1B[${renderedLines}A\x1B[0J`);
+      renderedLines = 0;
+    };
+    const render = () => {
+      clear();
+      const matches = suggestions(value);
+      if (active >= matches.length) active = Math.max(0, matches.length - 1);
+      const lines = [
+        `${section("Command")} ${value || muted("type a command")}`,
+        "",
+        ...matches.slice(0, 6).map((command, index) => `${index === active ? symbols.pointer : " "} ${command.input.padEnd(18)} ${muted(command.label)}`),
+        "",
+        muted("\u2191\u2193 select  Enter run  Esc cancel  Ctrl+C exit")
+      ];
+      stdout4.write(`${lines.join("\n")}
+`);
+      renderedLines = lines.length;
+    };
+    const finish = (result) => {
+      if (settled) return;
+      settled = true;
+      clear();
+      stdin3.off("keypress", onKeypress);
+      if (stdin3.isTTY) stdin3.setRawMode?.(wasRaw);
+      stdin3.pause();
+      stdout4.write("\n");
+      resolve6(result);
+    };
+    const onKeypress = (chunk, key) => {
+      if (key.ctrl && key.name === "c") {
+        finish(void 0);
+        process.exit(130);
+      }
+      if (key.name === "escape") return finish(void 0);
+      if (key.name === "up") {
+        const matches = suggestions(value);
+        active = Math.max(0, active - 1);
+        if (matches[active]) value = matches[active].input;
+        return render();
+      }
+      if (key.name === "down") {
+        const matches = suggestions(value);
+        active = Math.min(Math.max(0, matches.length - 1), active + 1);
+        if (matches[active]) value = matches[active].input;
+        return render();
+      }
+      if (key.name === "backspace") {
+        value = value.slice(0, -1);
+        active = 0;
+        return render();
+      }
+      if (key.name === "return" || key.name === "enter") {
+        const matches = suggestions(value);
+        const selected = value.trim() || matches[active]?.input;
+        return finish(selected);
+      }
+      if (key.name === "tab") {
+        const matches = suggestions(value);
+        if (matches[active]) value = matches[active].input;
+        return render();
+      }
+      const sequence = key.sequence || chunk;
+      if (sequence && /^[\x20-\x7e]+$/.test(sequence)) {
+        value += sequence;
+        active = 0;
+        return render();
+      }
+      if (key.name === "left" || key.name === "right") return;
+    };
+    emitKeypressEvents3(stdin3);
+    stdin3.setRawMode?.(true);
+    stdin3.resume();
+    stdin3.on("keypress", onKeypress);
+    render();
+  });
+}
+async function runInteractiveCommand(command) {
+  const parts = command.trim().split(/\s+/).filter(Boolean);
+  const root = parts[0];
+  if (root === "exit" || root === "quit") return false;
+  if (root === "connect") await connectCommand();
+  else if (root === "status") await statusCommand();
+  else if (root === "avatar") await avatarCommand(process.cwd(), parts.slice(1));
+  else if (root === "health") await healthCommand();
+  else if (root === "disconnect") await disconnectCommand();
+  else if (root === "help") interactiveHelp();
+  else if (root === "version") console.log(readCurrentVersion());
+  else if (root === "update") await updateCommand();
+  else {
+    console.log(`
+${symbols.error} Unknown command: ${command}`);
+    console.log(`Try ${muted("help")} to see available commands.`);
+  }
+  return true;
+}
+function renderLogo() {
+  const lines = [
+    " \u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557",
+    "\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D \u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255D",
+    "\u2588\u2588\u2588\u2588\u2588\u2557   \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557   \u2588\u2588\u2551   ",
+    "\u2588\u2588\u2554\u2550\u2550\u255D   \u255A\u2550\u2550\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2551\u255A\u2550\u2550\u2550\u2550\u2588\u2588\u2551   \u2588\u2588\u2551   ",
+    "\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551   \u2588\u2588\u2551   ",
+    "\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D   \u255A\u2550\u255D   "
+  ];
+  console.log(title(lines.join("\n")));
+  console.log();
+}
+function renderWelcome(project, connected) {
+  console.log(muted("Developer Assistant CLI"));
+  console.log();
+  console.log("Welcome to Asiyst CLI.");
+  console.log("Connect your project, manage your avatar, and verify your website integration.");
+  console.log();
+  console.log(section("Project"));
+  console.log(`  ${project && project.packageJson?.name ? String(project.packageJson.name) : process.cwd().split(/[\\/]/).pop() || "current-project"}`);
+  console.log(`  ${connected ? `${symbols.connected} Connected` : `${symbols.disconnected} Not connected`}`);
+  console.log();
+  console.log(section("Environment"));
+  if (project) {
+    console.log(`  ${project.framework} \xB7 ${project.language} \xB7 ${project.packageManager}`);
+    console.log(`  SDK: ${project.sdkVersion ? project.sdkVersion : "not installed"}`);
+  } else {
+    console.log("  Unable to detect project metadata automatically.");
+  }
+  console.log();
+  console.log(muted("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  console.log();
+}
+async function interactiveHome() {
+  const project = detectProject();
+  const initialConnection = await loadConnection(process.cwd());
+  console.clear();
+  renderLogo();
+  renderWelcome(project, Boolean(initialConnection));
+  for (; ; ) {
+    const command = await readCommand();
+    if (!command || !await runInteractiveCommand(command)) break;
   }
 }
 
@@ -1410,7 +2112,8 @@ async function main(argv = process.argv.slice(2)) {
   if (command === "revoke-trust") return revokeTrustCommand();
   if (command === "update") return updateCommand();
   if (command === "help") return help();
-  if (command === "version") return console.log(CLI_VERSION);
+  if (command === "version") return console.log(`Asiyst CLI v${CLI_VERSION}
+\u2713 Latest version`);
   if (!process.stdin.isTTY) {
     help();
     return;