@mintlify/cli 4.0.1634 → 4.0.1635

package/bin/cli.js

@@ -36,7 +36,7 @@ import { ogCommand } from './og.js';
 import { buildOverlayRegistryForCheck, checkOpenApiFile, getOpenApiFilenamesFromDocsConfig, } 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';
@@ -214,7 +214,7 @@ export const cli = ({ packageName = 'mint' }) => {
         }
         const { cli: cliVersion } = getVersions(packageName);
         yield validateBuild(Object.assign(Object.assign({}, argv), { packageName,
-            cliVersion }));
+            cliVersion }), sendPublishPrompt);
     }))
         .command('test', 'Test runnable code blocks with a local coding agent', (yargs) => yargs.usage('usage: mint test'), () => __awaiter(void 0, void 0, void 0, function* () {
         yield mintTestHandler();

package/bin/config.js

@@ -54,3 +54,13 @@ export function clearConfigValue(key) {
         yield writeConfig({ [key]: undefined });
     });
 }
+export function hasShownPublishPrompt(dir) {
+    var _a, _b;
+    return (_b = (_a = readConfig().publishPromptShown) === null || _a === void 0 ? void 0 : _a.includes(dir)) !== null && _b !== void 0 ? _b : false;
+}
+export function markPublishPromptShown(dir) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        yield writeConfig({ publishPromptShown: [...((_a = readConfig().publishPromptShown) !== null && _a !== void 0 ? _a : []), dir] });
+    });
+}

package/bin/init.js

@@ -18,6 +18,9 @@ import { isAI } from './helpers.js';
 import { fetchAvailableTemplates, installFromTemplate, promptForTemplate, validateTemplateName, } from './templates.js';
 const sendOnboardingMessage = (installDir) => {
     addLogs(_jsx(Text, { bold: true, children: "Documentation Setup!" }), _jsx(Text, { children: "To see your docs run" }), _jsxs(Box, { children: [_jsx(Text, { color: "blue", children: "cd" }), _jsxs(Text, { children: [" ", installDir] })] }), _jsx(Text, { color: "blue", children: "mint dev" }));
+    if (isAI()) {
+        addLog(_jsxs(Text, { children: ["When the docs are ready, run `mint validate` in ", installDir, " to check the build and get publish steps."] }));
+    }
 };
 const sendUsageMessageForAI = (directory, contentsOccupied, themes, templateNames) => {
     const templateInfo = templateNames === undefined

package/bin/signup.js

@@ -12,15 +12,30 @@ import { input } from '@inquirer/prompts';
 import { addLog, addLogs, ErrorLog, SuccessLog } from '@mintlify/previewing';
 import { Box, Text } from 'ink';
 import { calculatePKCECodeChallenge, randomNonce, randomPKCECodeVerifier, 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';
 const sendAIUsageMessage = () => {
     addLogs(_jsx(Text, { children: "Agent Detected - sending AI friendly prompt" }), _jsx(Text, { children: '<mint-cli-instructions>' }), _jsx(Text, { children: "You were asked to create a Mintlify account. Here is how to do that with the `mint signup` command. Fill in any values you already have from this conversation; ask the user directly for anything you don't \u2014 never invent a person's name, company, or email." }), _jsx(Text, { children: "Command: `mint signup --firstName [firstName] --lastName [lastName] --company [company] --email [email]`." }), _jsx(Text, { children: "Important: this command blocks until the user clicks a verification link sent to their email, which can take several minutes. Run it as a background task, not in the foreground \u2014 do not wait on it synchronously. You'll be notified when it finishes; then tell the user their account is ready." }), _jsx(Text, { children: '</mint-cli-instructions>' }));
 };
+export const sendPublishPrompt = () => __awaiter(void 0, void 0, void 0, function* () {
+    if (!isAI() ||
+        isCI() ||
+        process.env.MINTLIFY_SESSION_TOKEN ||
+        (yield getAccessToken().catch(() => undefined))) {
+        return;
+    }
+    if (hasShownPublishPrompt(CMD_EXEC_PATH)) {
+        addLog(_jsx(Text, { children: "Not published yet. Run `mint signup` or `mint login` to publish." }));
+        return;
+    }
+    addLogs(_jsx(Text, { children: '<mint-cli-instructions>' }), _jsx(Text, { children: "Ready to publish? The Starter plan is free, no credit card needed." }), _jsx(Text, { children: "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." }), _jsx(Text, { children: "Have an account: `mint login`." }), _jsx(Text, { children: "After the email is verified, connect GitHub in the browser tab to deploy." }), _jsx(Text, { children: "Your site will then be live at https://[subdomain].mintlify.site (`mint status` shows the exact URL)." }), _jsx(Text, { children: '</mint-cli-instructions>' }));
+    yield markPublishPromptShown(CMD_EXEC_PATH).catch(() => undefined);
+});
 export function signup() {
     return __awaiter(this, arguments, void 0, function* (options = {}) {
         var _a, _b, _c, _d, _e, _f, _g, _h;