@mintlify/cli 4.0.1634 → 4.0.1635

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mintlify/cli",
-  "version": "4.0.1634",
+  "version": "4.0.1635",
   "description": "The Mintlify CLI",
   "engines": {
     "node": ">=18.0.0"
@@ -46,11 +46,11 @@
   "dependencies": {
     "@inquirer/prompts": "7.9.0",
     "@mintlify/common": "1.0.1238",
-    "@mintlify/link-rot": "3.0.1453",
+    "@mintlify/link-rot": "3.0.1454",
     "@mintlify/models": "0.0.372",
     "@mintlify/og": "0.0.36",
     "@mintlify/prebuild": "1.0.1400",
-    "@mintlify/previewing": "4.0.1474",
+    "@mintlify/previewing": "4.0.1475",
     "@mintlify/validation": "0.1.910",
     "adm-zip": "0.6.0",
     "chalk": "5.2.0",
@@ -105,5 +105,5 @@
     "vitest": "2.1.9",
     "vitest-mock-process": "1.0.4"
   },
-  "gitHead": "f9509a110d307e51d75111b5bf5c0a5644ed22f2"
+  "gitHead": "f5423bcdc7906b51202bdbc5fd729c2a647f79ff"
 }

package/src/cli.tsx

@@ -53,7 +53,7 @@ import {
 } from './openApiCheck.js';
 import { resolveExplicitFiles } from './resolveFiles.js';
 import { scoreHandler } from './score/index.js';
-import { signup } from './signup.js';
+import { sendPublishPrompt, signup } from './signup.js';
 import { status, getCliSubdomains } from './status.js';
 import { trackTelemetryPreferenceChange } from './telemetry/track.js';
 import { update } from './update.js';
@@ -257,11 +257,14 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
           }
 
           const { cli: cliVersion } = getVersions(packageName);
-          await validateBuild({
-            ...argv,
-            packageName,
-            cliVersion,
-          });
+          await validateBuild(
+            {
+              ...argv,
+              packageName,
+              cliVersion,
+            },
+            sendPublishPrompt
+          );
         }
       )
       .command(

package/src/config.ts

@@ -8,6 +8,7 @@ interface MintlifyConfig {
   subdomain?: string;
   dateFrom?: string;
   dateTo?: string;
+  publishPromptShown?: string[];
 }
 
 function readConfig(): MintlifyConfig {
@@ -48,3 +49,11 @@ export async function setConfigValue(key: string, value: string): Promise<void>
 export async function clearConfigValue(key: string): Promise<void> {
   await writeConfig({ [key]: undefined });
 }
+
+export function hasShownPublishPrompt(dir: string): boolean {
+  return readConfig().publishPromptShown?.includes(dir) ?? false;
+}
+
+export async function markPublishPromptShown(dir: string): Promise<void> {
+  await writeConfig({ publishPromptShown: [...(readConfig().publishPromptShown ?? []), dir] });
+}

package/src/init.tsx

@@ -23,6 +23,14 @@ const sendOnboardingMessage = (installDir: string) => {
     </Box>,
     <Text color="blue">mint dev</Text>
   );
+  if (isAI()) {
+    addLog(
+      <Text>
+        When the docs are ready, run `mint validate` in {installDir} to check the build and get
+        publish steps.
+      </Text>
+    );
+  }
 };
 
 const sendUsageMessageForAI = (

package/src/signup.tsx

@@ -8,12 +8,13 @@ import {
   randomState,
 } from 'openid-client';
 
+import { isCI } from './agent.js';
 import { startCallbackServer } from './callbackServer.js';
-import { clearConfigValue } from './config.js';
+import { clearConfigValue, hasShownPublishPrompt, markPublishPromptShown } from './config.js';
 import { API_URL, TOKEN_ENDPOINT } from './constants.js';
-import { isAI } from './helpers.js';
+import { CMD_EXEC_PATH, isAI } from './helpers.js';
 import { getEmailFromIdToken } from './idToken.js';
-import { storeCredentials } from './keyring.js';
+import { getAccessToken, storeCredentials } from './keyring.js';
 import type { TokenResponse } from './login.js';
 
 export interface SignupOptions {
@@ -46,6 +47,39 @@ const sendAIUsageMessage = () => {
   );
 };
 
+export const sendPublishPrompt = async () => {
+  if (
+    !isAI() ||
+    isCI() ||
+    process.env.MINTLIFY_SESSION_TOKEN ||
+    (await getAccessToken().catch(() => undefined))
+  ) {
+    return;
+  }
+  if (hasShownPublishPrompt(CMD_EXEC_PATH)) {
+    addLog(<Text>Not published yet. Run `mint signup` or `mint login` to publish.</Text>);
+    return;
+  }
+  addLogs(
+    <Text>{'<mint-cli-instructions>'}</Text>,
+    <Text>Ready to publish? The Starter plan is free, no credit card needed.</Text>,
+    <Text>
+      Offer to create the user's Mintlify account with `mint signup --firstName [firstName]
+      --lastName [lastName] --company [company] --email [email]`. Ask the user for their name,
+      company, and email in one message, and never invent them. Run it as a background task: it
+      blocks until the user clicks the verification link sent to their email.
+    </Text>,
+    <Text>Have an account: `mint login`.</Text>,
+    <Text>After the email is verified, connect GitHub in the browser tab to deploy.</Text>,
+    <Text>
+      Your site will then be live at https://[subdomain].mintlify.site (`mint status` shows the
+      exact URL).
+    </Text>,
+    <Text>{'</mint-cli-instructions>'}</Text>
+  );
+  await markPublishPromptShown(CMD_EXEC_PATH).catch(() => undefined);
+};
+
 export async function signup(options: SignupOptions = {}): Promise<void> {
   if (isAI() && (!options.firstName || !options.lastName || !options.company || !options.email)) {
     sendAIUsageMessage();