jamdesk 1.1.119 → 1.1.120

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jamdesk",
-  "version": "1.1.119",
+  "version": "1.1.120",
   "description": "CLI for Jamdesk — build, preview, and deploy documentation sites from MDX. Dev server with hot reload, 50+ components, OpenAPI support, AI search, and Mintlify migration",
   "keywords": [
     "jamdesk",

package/vendored/lib/build/clone-error-format.ts

@@ -59,7 +59,7 @@ export function formatCloneError(err: CloneError): ErrorDetails {
     case 'auth_failed': {
       return {
         type: 'clone_failed',
-        message: 'GitHub authentication failed',
+        message: fitInHeadline('GitHub authentication failed'),
         details:
           `The GitHub App token was rejected when cloning ${repoQuoted}. ` +
           `The installation may have been suspended, revoked, or had its ` +
@@ -70,11 +70,28 @@ export function formatCloneError(err: CloneError): ErrorDetails {
       };
     }
 
+    case 'network_error': {
+      return {
+        type: 'clone_failed',
+        message: fitInHeadline(`Network error cloning ${repoText}`),
+        details:
+          `git could not reach GitHub when cloning ${repoQuoted}. This is ` +
+          `usually transient — DNS, TLS, or GitHub's git endpoint having a ` +
+          `bad moment — but a persistent firewall or proxy change can also ` +
+          `cause it.`,
+        suggestion:
+          'Re-trigger the build. If it keeps failing:\n' +
+          '• Check https://www.githubstatus.com for ongoing incidents\n' +
+          '• Confirm any custom egress proxy/firewall still allows ' +
+          'github.com:443',
+      };
+    }
+
     case 'unknown':
     default: {
       return {
         type: 'clone_failed',
-        message: 'Failed to clone repository',
+        message: fitInHeadline('Failed to clone repository'),
         details: `Could not clone ${repoText}.`,
         suggestion:
           'Check that:\n' +

package/vendored/lib/email-templates/components/error-box.tsx

@@ -65,15 +65,39 @@ const styles = {
     fontStyle: 'italic' as const,
     margin: '4px 0 0 0',
   },
+  // Used when the previous source line was blank — gives a visible paragraph
+  // break (e.g. between bullets and the "If you need help…" reference line).
+  suggestionParagraphBreak: {
+    color: colors.textSecondary,
+    fontSize: '13px',
+    fontStyle: 'italic' as const,
+    margin: '14px 0 0 0',
+  },
 };
 
 export function ErrorBox({ error, errorRef, errorType, errorSuggestion }: ErrorBoxProps) {
   // Split on `\n` so multi-line suggestions render as a real list. A single
   // <Text> (which becomes <p>) collapses whitespace, so "Either:\n• one\n• two"
-  // would otherwise reach the reader as a wall of prose.
-  const suggestionLines = errorSuggestion
-    ? errorSuggestion.split('\n').filter(line => line.length > 0)
-    : [];
+  // would otherwise reach the reader as a wall of prose. Blank source lines
+  // (from "...\n\nIf you need help...") translate to a visible paragraph
+  // break — the next non-empty line gets a larger top margin.
+  const suggestionLines: Array<{ text: string; afterBlank: boolean }> = [];
+  if (errorSuggestion) {
+    let pendingBlank = false;
+    for (const raw of errorSuggestion.split('\n')) {
+      if (raw.trim().length === 0) {
+        pendingBlank = true;
+        continue;
+      }
+      suggestionLines.push({ text: raw, afterBlank: pendingBlank });
+      pendingBlank = false;
+    }
+  }
+
+  const styleFor = (i: number, afterBlank: boolean) => {
+    if (i === 0) return styles.suggestion;
+    return afterBlank ? styles.suggestionParagraphBreak : styles.suggestionContinuation;
+  };
 
   return (
     <Section style={styles.container} className="email-error-box">
@@ -88,13 +112,13 @@ export function ErrorBox({ error, errorRef, errorType, errorSuggestion }: ErrorB
         <Text style={styles.errorType} className="email-paragraph">Type: {errorType}</Text>
       )}
 
-      {suggestionLines.map((line, i) => (
+      {suggestionLines.map(({ text, afterBlank }, i) => (
         <Text
           key={i}
-          style={i === 0 ? styles.suggestion : styles.suggestionContinuation}
+          style={styleFor(i, afterBlank)}
           className="email-paragraph"
         >
-          {i === 0 ? `💡 ${line}` : line}
+          {i === 0 ? `💡 ${text}` : text}
         </Text>
       ))}
     </Section>