@jieunmarslim/server-editable-slides 0.2.10 → 0.2.12

package/index.js

@@ -214,47 +214,64 @@ async function runDoctor() {
   const token = getAuthToken();
   const project = getProject();
 
+  const useColor = !process.env.NO_COLOR;
+  const red = (s) => (useColor ? `\x1b[1;31m${s}\x1b[0m` : s);
+  const green = (s) => (useColor ? `\x1b[1;32m${s}\x1b[0m` : s);
+  const yellow = (s) => (useColor ? `\x1b[1;33m${s}\x1b[0m` : s);
+  const cyan = (s) => (useColor ? `\x1b[1;36m${s}\x1b[0m` : s);
+  const bold = (s) => (useColor ? `\x1b[1m${s}\x1b[0m` : s);
+  const badgePass = useColor ? '\x1b[42;97;1m PASS \x1b[0m' : '[PASS]';
+  const badgeFail = useColor ? '\x1b[41;97;1m FAILED \x1b[0m' : '[FAILED]';
+  const badgeSkip = useColor ? '\x1b[43;30;1m SKIPPED \x1b[0m' : '[SKIPPED]';
+  const badgeWarn = useColor ? '\x1b[43;30;1m WARNING \x1b[0m' : '[WARNING]';
+
   console.error('\n========================================================================');
-  console.error(' 🔍 EditNBLM MCP Pre-flight Diagnostic & Doctor');
+  console.error(bold(' 🔍 EditNBLM MCP Pre-flight Diagnostic & Doctor'));
   console.error('========================================================================\n');
 
-  let hasError = false;
+  const failures = [];
 
   // 1. Check Auth
   if (account && token) {
-    console.error(` [1/5] Google Cloud Authentication:`);
-    console.error(`       ✓ Authenticated: ${account}`);
+    console.error(` [1/5] Google Cloud Authentication:           ${badgePass}`);
+    console.error(`       ✓ Authenticated: ${green(account)}`);
   } else {
-    hasError = true;
-    console.error(` [1/5] Google Cloud Authentication:`);
-    console.error(`       ✗ FAILED: Not authenticated or token expired.`);
-    console.error(`       👉 Please run: gcloud auth login --enable-gdrive-access`);
+    failures.push({
+      step: 'Google Cloud Authentication',
+      fix: 'gcloud auth login --enable-gdrive-access',
+    });
+    console.error(` [1/5] Google Cloud Authentication:           ${badgeFail}`);
+    console.error(`       ${red('✗ FAILED')}: Not authenticated or token expired.`);
+    console.error(`       👉 ${bold('Required Fix')}: ${cyan('gcloud auth login --enable-gdrive-access')}`);
   }
 
   // 2. Check Google Drive Integration & Scope
   const hasDrive = await checkDriveScope(token);
-  console.error(`\n [2/5] Google Drive Integration & Scope:`);
   if (hasDrive) {
-    console.error(`       ✓ Active: Google Drive access granted.`);
-    console.error(`       ✓ Presentations will automatically convert into live Google Slides.`);
+    console.error(`\n [2/5] Google Drive Integration & Scope:        ${badgePass}`);
+    console.error(`       ✓ Active: Google Drive access granted (auto Google Slides conversion ready).`);
   } else {
-    hasError = true;
-    console.error(`       ✗ FAILED: Token lacks Google Drive access.`);
-    console.error(`       👉 To enable automatic Google Slides creation in your Drive, run:`);
-    console.error(`          gcloud auth login --enable-gdrive-access`);
+    failures.push({
+      step: 'Google Drive Integration & Scope',
+      fix: 'gcloud auth login --enable-gdrive-access',
+    });
+    console.error(`\n [2/5] Google Drive Integration & Scope:        ${badgeFail}`);
+    console.error(`       ${red('✗ FAILED')}: Token lacks Google Drive access.`);
+    console.error(`       👉 ${bold('Required Fix')}: ${cyan('gcloud auth login --enable-gdrive-access')}`);
   }
 
-  // 2. Check Project Configuration & Account Access Permissions
+  // 3. Check Project Configuration & Account Access Permissions
   let projectAccessOk = false;
   if (!project) {
-    hasError = true;
-    console.error(`\n [3/5] GEAP Billing & Quota Project:`);
-    console.error(`       ✗ FAILED: No GCP project configured.`);
-    console.error(`       👉 Please run: gcloud config set project YOUR_GCP_PROJECT_ID`);
-    console.error(`       👉 Or export:  export EDITABLE_SLIDES_PROJECT=YOUR_GCP_PROJECT_ID`);
+    failures.push({
+      step: 'GEAP Billing & Quota Project',
+      fix: 'gcloud config set project <YOUR_GCP_PROJECT_ID>',
+    });
+    console.error(`\n [3/5] Target GCP Project Accessibility:        ${badgeFail}`);
+    console.error(`       ${red('✗ FAILED')}: No GCP project configured.`);
+    console.error(`       👉 ${bold('Required Fix')}: ${cyan('gcloud config set project YOUR_GCP_PROJECT_ID')}`);
   } else {
     try {
-      // Actually verify that the logged-in account has access to this project
       const check = execSync(
         `gcloud projects describe ${project} --format="value(projectId)"`,
         { stdio: ['ignore', 'pipe', 'pipe'] },
@@ -263,48 +280,44 @@ async function runDoctor() {
         .trim();
       if (check === project) {
         projectAccessOk = true;
-        console.error(`\n [3/5] Target GCP Project Accessibility:`);
-        console.error(
-          `       ✓ Verified: Account [${account}] has active access to project [${project}].`,
-        );
+        console.error(`\n [3/5] Target GCP Project Accessibility:        ${badgePass}`);
+        console.error(`       ✓ Verified: Account [${green(account)}] has active access to [${green(project)}].`);
       }
     } catch (err) {
-      hasError = true;
       const stderr = err.stderr ? err.stderr.toString() : err.message;
-      console.error(`\n [3/5] Target GCP Project Accessibility:`);
       if (
         stderr.includes('does not have permission') ||
         stderr.includes('caller does not have permission')
       ) {
-        console.error(
-          `       ✗ ACCESS DENIED: Account [${account}] does NOT have permission to access project [${project}].`,
-        );
-        console.error(
-          `       👉 Solution 1: Log in with the account that has access to [${project}]:`,
-        );
-        console.error(`          gcloud auth login --enable-gdrive-access`);
-        console.error(
-          `       👉 Solution 2: Switch to a project that [${account}] can access:`,
-        );
-        console.error(
-          `          gcloud config set project <ACCESSIBLE_PROJECT_ID>`,
-        );
+        failures.push({
+          step: `Access to GCP Project [${project}]`,
+          fix: `Switch project: gcloud config set project <ACCESSIBLE_PROJECT_ID>\n          Or login with owner account: gcloud auth login --enable-gdrive-access`,
+        });
+        console.error(`\n [3/5] Target GCP Project Accessibility:        ${badgeFail}`);
+        console.error(`       ${red('✗ ACCESS DENIED')}: Account [${bold(account)}] does NOT have permission to access project [${bold(project)}].`);
+        console.error(`       👉 ${bold('Solution 1 (Switch project)')}: ${cyan('gcloud config set project <ACCESSIBLE_PROJECT_ID>')}`);
+        console.error(`       👉 ${bold('Solution 2 (Switch account)')}: ${cyan('gcloud auth login --enable-gdrive-access')}`);
       } else if (stderr.includes('not found') || stderr.includes('404')) {
-        console.error(
-          `       ✗ NOT FOUND: Project [${project}] does not exist or was deleted.`,
-        );
-        console.error(
-          `       👉 Please run: gcloud config set project <VALID_PROJECT_ID>`,
-        );
+        failures.push({
+          step: `GCP Project [${project}] Not Found`,
+          fix: 'gcloud config set project <VALID_PROJECT_ID>',
+        });
+        console.error(`\n [3/5] Target GCP Project Accessibility:        ${badgeFail}`);
+        console.error(`       ${red('✗ NOT FOUND')}: Project [${bold(project)}] does not exist or was deleted.`);
+        console.error(`       👉 ${bold('Required Fix')}: ${cyan('gcloud config set project <VALID_PROJECT_ID>')}`);
       } else {
-        console.error(
-          `       ✗ FAILED: Unable to verify project access (${stderr.trim()}).`,
-        );
+        failures.push({
+          step: `Verify GCP Project [${project}]`,
+          fix: `Check gcloud permissions: ${stderr.trim().split('\n')[0]}`,
+        });
+        console.error(`\n [3/5] Target GCP Project Accessibility:        ${badgeFail}`);
+        console.error(`       ${red('✗ FAILED')}: Unable to verify project access (${stderr.trim().split('\n')[0]}).`);
       }
     }
   }
 
   // 4. Verify One-Time IAM Delegation to EditNBLM Service Account
+  let iamDelegationOk = false;
   if (projectAccessOk) {
     try {
       const bindings = execSync(
@@ -315,62 +328,80 @@ async function runDoctor() {
         'serviceAccount:editnblm-mcp-runtime@editnblm-in-ge-2036.iam.gserviceaccount.com',
       );
 
-      console.error(`\n [4/5] GEAP Quota & IAM Delegation:`);
       if (hasAiPlatform) {
-        console.error(
-          `       ✓ GRANTED: Service account has roles/aiplatform.user on [${project}].`,
-        );
+        iamDelegationOk = true;
+        console.error(`\n [4/5] GEAP Quota & IAM Delegation:             ${badgePass}`);
+        console.error(`       ✓ GRANTED: Service account has roles/aiplatform.user on [${green(project)}].`);
       } else {
-        hasError = true;
-        console.error(
-          `       ✗ MISSING: editnblm-mcp-runtime has NOT been granted roles/aiplatform.user on [${project}].`,
-        );
-        console.error(`       👉 Please run the delegation commands below.`);
+        failures.push({
+          step: 'GEAP IAM Delegation',
+          fix: `Run the 2 IAM delegation commands shown below`,
+        });
+        console.error(`\n [4/5] GEAP Quota & IAM Delegation:             ${badgeFail}`);
+        console.error(`       ${red('✗ MISSING')}: editnblm-mcp-runtime has NOT been granted roles/aiplatform.user on [${bold(project)}].`);
+        console.error(`       👉 ${bold('Required Action')}: Execute the IAM delegation commands below.`);
       }
     } catch {
-      console.error(`\n [4/5] GEAP Quota & IAM Delegation:`);
-      console.error(
-        `       ⚠️  Could not read IAM policy directly. Ensure the delegation commands below were executed.`,
-      );
+      console.error(`\n [4/5] GEAP Quota & IAM Delegation:             ${badgeWarn}`);
+      console.error(`       ⚠️  Could not verify IAM policy directly. Ensure delegation commands were executed.`);
     }
   } else {
-    console.error(`\n [4/5] GEAP Quota & IAM Delegation:`);
-    console.error(`       ⏸️  Skipped until project access is resolved.`);
+    console.error(`\n [4/5] GEAP Quota & IAM Delegation:             ${badgeSkip}`);
+    console.error(`       ⏸️  Skipped until project access error [3/5] is resolved.`);
   }
 
   // 5. Check Backend Connectivity
   try {
     const res = await fetch(`${BASE_URL}/health`);
     if (res.ok) {
-      console.error(`\n [5/5] EditNBLM Cloud Backend:`);
-      console.error(`       ✓ Status: Connected (${BASE_URL})`);
+      console.error(`\n [5/5] EditNBLM Cloud Backend:                  ${badgePass}`);
+      console.error(`       ✓ Status: Connected (${green(BASE_URL)})`);
     } else {
-      console.error(`\n [5/5] EditNBLM Cloud Backend:`);
-      console.error(`       ⚠️  Status: HTTP ${res.status}`);
+      failures.push({
+        step: 'EditNBLM Cloud Backend',
+        fix: `Backend returned HTTP ${res.status}. Check service health.`,
+      });
+      console.error(`\n [5/5] EditNBLM Cloud Backend:                  ${badgeFail}`);
+      console.error(`       ${red('✗ HTTP ERROR')}: Status ${res.status}`);
     }
   } catch (err) {
-    console.error(`\n [5/5] EditNBLM Cloud Backend:`);
-    console.error(`       ✗ Status: Unreachable (${err.message})`);
+    failures.push({
+      step: 'EditNBLM Cloud Backend',
+      fix: `Backend unreachable: ${err.message}`,
+    });
+    console.error(`\n [5/5] EditNBLM Cloud Backend:                  ${badgeFail}`);
+    console.error(`       ${red('✗ UNREACHABLE')}: ${err.message}`);
   }
 
-  // 5. One-Time IAM Delegation command helper
-  console.error('\n------------------------------------------------------------------------');
-  console.error(' 📋 One-Time IAM Delegation Commands for your Project:');
-  console.error('------------------------------------------------------------------------');
-  const targetProject = project || 'YOUR_GCP_PROJECT_ID';
-  console.error(`gcloud projects add-iam-policy-binding ${targetProject} \\`);
-  console.error('  --member="serviceAccount:editnblm-mcp-runtime@editnblm-in-ge-2036.iam.gserviceaccount.com" \\');
-  console.error('  --role="roles/aiplatform.user"\n');
-  console.error(`gcloud projects add-iam-policy-binding ${targetProject} \\`);
-  console.error('  --member="serviceAccount:editnblm-mcp-runtime@editnblm-in-ge-2036.iam.gserviceaccount.com" \\');
-  console.error('  --role="roles/serviceusage.serviceUsageConsumer"');
-  console.error('========================================================================\n');
+  // IAM Delegation Commands (only shown when project is accessible)
+  if (projectAccessOk && !iamDelegationOk) {
+    console.error('\n------------------------------------------------------------------------');
+    console.error(bold(' 📋 One-Time IAM Delegation Commands for your Project:'));
+    console.error('------------------------------------------------------------------------');
+    console.error(cyan(`gcloud projects add-iam-policy-binding ${project} \\`));
+    console.error(cyan('  --member="serviceAccount:editnblm-mcp-runtime@editnblm-in-ge-2036.iam.gserviceaccount.com" \\'));
+    console.error(cyan('  --role="roles/aiplatform.user"\n'));
+    console.error(cyan(`gcloud projects add-iam-policy-binding ${project} \\`));
+    console.error(cyan('  --member="serviceAccount:editnblm-mcp-runtime@editnblm-in-ge-2036.iam.gserviceaccount.com" \\'));
+    console.error(cyan('  --role="roles/serviceusage.serviceUsageConsumer"'));
+  }
 
-  if (!hasError) {
-    console.error('🎉 All checks PASSED! Your environment is ready to use EditNBLM MCP.\n');
+  // Final Summary Banner
+  if (failures.length === 0) {
+    console.error('\n' + green('========================================================================'));
+    console.error(useColor ? '\x1b[42;97;1m  🎉 ALL CHECKS PASSED! Your environment is ready to use EditNBLM MCP.  \x1b[0m' : '🎉 ALL CHECKS PASSED! Your environment is ready to use EditNBLM MCP.');
+    console.error(green('========================================================================\n'));
     process.exit(0);
   } else {
-    console.error('⚠️  Setup incomplete. Please fix the items marked with ✗ above.\n');
+    console.error('\n' + red('========================================================================'));
+    console.error(useColor ? `\x1b[41;97;1m  ❌ PRE-FLIGHT CHECK FAILED — ${failures.length} ACTION(S) REQUIRED  \x1b[0m` : `❌ PRE-FLIGHT CHECK FAILED — ${failures.length} ACTION(S) REQUIRED`);
+    console.error(red('========================================================================'));
+    console.error(bold(`\n EditNBLM MCP cannot run until the following issue(s) are resolved:\n`));
+    failures.forEach((f, idx) => {
+      console.error(`   ${red(bold(`[!] Issue ${idx + 1}`))}: ${bold(f.step)}`);
+      console.error(`       👉 ${cyan(f.fix)}\n`);
+    });
+    console.error(red('========================================================================\n'));
     process.exit(1);
   }
 }
@@ -517,19 +548,19 @@ async function assertEnvironmentOrExit() {
   const project = getProject();
 
   if (!account || !token) {
-    console.error('[EditNBLM] ❌ Error: Not authenticated. Run: gcloud auth login --enable-gdrive-access');
+    console.error('error: Not authenticated. Please run: gcloud auth login --enable-gdrive-access');
     process.exit(1);
   }
 
   // Verify Google Drive scope
   const hasDrive = await checkDriveScope(token);
   if (!hasDrive) {
-    console.error(`[EditNBLM] ❌ Error: Google Drive scope missing. Run: gcloud auth login --enable-gdrive-access`);
+    console.error('error: Google Drive scope missing. Please run: gcloud auth login --enable-gdrive-access');
     process.exit(1);
   }
 
   if (!project) {
-    console.error('[EditNBLM] ❌ Error: No GCP project set. Run: gcloud config set project <PROJECT_ID>');
+    console.error('error: No GCP project set. Please run: gcloud config set project <PROJECT_ID>');
     process.exit(1);
   }
 
@@ -542,7 +573,7 @@ async function assertEnvironmentOrExit() {
       .toString()
       .trim();
     if (check !== project) {
-      throw new Error(`Project mismatch`);
+      throw new Error('Project mismatch');
     }
   } catch (err) {
     const stderr = err.stderr ? err.stderr.toString() : err.message;
@@ -550,11 +581,11 @@ async function assertEnvironmentOrExit() {
       stderr.includes('does not have permission') ||
       stderr.includes('caller does not have permission')
     ) {
-      console.error(`[EditNBLM] ❌ Error: Account [${account}] lacks permission for project [${project}]. Run: gcloud config set project <PROJECT_ID>`);
+      console.error(`error: Account [${account}] lacks permission for project [${project}]. Run: gcloud config set project <PROJECT_ID>`);
     } else if (stderr.includes('not found') || stderr.includes('404')) {
-      console.error(`[EditNBLM] ❌ Error: Project [${project}] not found. Run: gcloud config set project <VALID_PROJECT_ID>`);
+      console.error(`error: Project [${project}] not found. Run: gcloud config set project <VALID_PROJECT_ID>`);
     } else {
-      console.error(`[EditNBLM] ❌ Error: Cannot access project [${project}] (${stderr.trim().split('\n')[0]}).`);
+      console.error(`error: Cannot access project [${project}] (${stderr.trim().split('\n')[0]}).`);
     }
     process.exit(1);
   }
@@ -978,7 +1009,7 @@ async function startMcpServer() {
 
   const transport = new StdioServerTransport();
   server.connect(transport).catch((err) => {
-    console.error(`[EditNBLM] ❌ Fatal error: ${err.message}`);
+    console.error(`error: ${err.message}`);
     process.exit(1);
   });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jieunmarslim/server-editable-slides",
-  "version": "0.2.10",
+  "version": "0.2.12",
   "description": "Model Context Protocol (MCP) client for Editable Slides Cloud",
   "type": "module",
   "bin": {