@momo-kits/native-kits 0.157.1-beta.9 → 0.157.1-com.1-debug

package/src/doctor/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@momo-kits/doctor",
+  "version": "0.1.27-beta.1",
+  "description": "Momo-kits doctor tool",
+  "main": "dist/index.js",
+  "bin": {
+    "momo-kits": "dist/index.js"
+  },
+  "scripts": {
+    "build": "node ./node_modules/.bin/tsc",
+    "dev": "node ./node_modules/.bin/ts-node src/index.ts",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build",
+    "test": "echo \"No tests configured yet\" && exit 0"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "cli",
+    "doctor",
+    "development",
+    "momo-kits"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@yarnpkg/lockfile": "^1.1.0",
+    "chalk": "^4.1.2",
+    "commander": "^13.1.0",
+    "inquirer": "^8.2.5",
+    "react-scanner": "^1.2.0",
+    "semver": "^7.7.1",
+    "yaml": "^2.7.1"
+  },
+  "devDependencies": {
+    "@types/inquirer": "^8.2.5",
+    "@types/node": "^22.15.3",
+    "@types/semver": "^7.7.0",
+    "@types/yarnpkg__lockfile": "^1.1.9",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.8.3"
+  }
+}

package/src/doctor/publish.sh

@@ -0,0 +1,27 @@
+#!/bin/bash
+
+# Prepare dist files
+rm -rf dist
+mkdir dist
+rsync -r --exclude=/dist ./* dist
+cd dist
+
+
+if [ "$1" == "stable" ]; then
+  npm version $(npm view @momo-kits/foundation@stable version)
+  npm version patch
+  npm publish --tag stable --access=public
+elif [ "$1" == "latest" ]; then
+  npm version $(npm view @momo-kits/foundation@latest version)
+  npm publish --tag latest --access=public
+else
+  npm version $(npm view @momo-kits/title@beta version)
+  npm publish --tag beta --access=public
+fi
+
+PACKAGE_NAME=$(npm pkg get name)
+NEW_PACKAGE_VERSION=$(npm pkg get version)
+
+# Clean up
+cd ..
+rm -rf dist

package/src/doctor/src/Users.json

@@ -0,0 +1,112 @@
+{
+  "vn.momo.addressbook": "users/106279817887758076140",
+  "vn.momo.agent": "users/106628491269004268394",
+  "vn.momo.ahamove": "users/107190697037501170364",
+  "vn.momo.ar": "users/107521286127966359664",
+  "vn.momo.authentication": "users/107888482176648859974",
+  "vn.momo.autodebit": "users/105366138186365879004",
+  "vn.momo.bnpl": "users/116481528213656200740",
+  "vn.momo.butta": "users/100079072934789639578",
+  "vn.momo.chatbot": "users/107521286127966359664",
+  "vn.momo.coinhoarding": "users/118351315569818729535",
+  "vn.momo.collaborators": "users/108669803684152254594",
+  "vn.momo.devtool": "users/117350096144600649875",
+  "vn.momo.edu": "users/103058152793362725873",
+  "vn.momo.gamihub": "users/118351315569818729535",
+  "vn.momo.healthcenter": "users/103058152793362725873",
+  "vn.momo.hlc": "users/107190697037501170364",
+  "vn.momo.intro": "users/118174864419592894302",
+  "vn.momo.lending_marketplace": "users/106628491269004268394",
+  "vn.momo.luckywheel": "users/100079072934789639578",
+  "vn.momo.mega2022client": "users/100079072934789639578",
+  "vn.momo.merchantsolutions": "users/106628491269004268394",
+  "vn.momo.merchanttemplate": "users/103541070063349578162",
+  "vn.momo.my_paylater": "users/116481528213656200740",
+  "vn.momo.oauthorize": "users/107190697037501170364",
+  "vn.momo.openplatform": "users/105787665677771730192",
+  "vn.momo.platinummembership": "users/108669803684152254594",
+  "vn.momo.progressionhoarding": "users/118351315569818729535",
+  "vn.momo.promotion": "users/100079072934789639578",
+  "vn.momo.referralcampaign": "users/100079072934789639578",
+  "vn.momo.referraltelco": "users/105366138186365879004",
+  "vn.momo.school": "users/100079072934789639578",
+  "vn.momo.soundbox": "users/107190697037501170364",
+  "vn.momo.tigger": "users/103541070063349578162",
+  "vn.momo.transfer": "users/111719399439871502655",
+  "vn.momo.transport": "users/105007322106342197859",
+  "vn.momo.utilities": "users/103058152793362725873",
+  "vn.momo.webapp": "users/107190697037501170364",
+  "vn.momo.webpaymentsdk": "users/107190697037501170364",
+  "vn.momo.bank": "users/101637889640502392681",
+  "vn.momo.coopbank": "users/101637889640502392681",
+  "vn.momo.ekyc": "users/101637889640502392681",
+  "vn.momo.medicarehub": "users/103830993282116768799",
+  "vn.momo.studentpass": "users/100079072934789639578",
+  "vn.momo.uikits": "users/106969299012781134893",
+  "vn.momo.airline": "users/107050213009971342413",
+  "vn.momo.appx": "users/102072943552797596818",
+  "vn.momo.billpay": "users/103826907742095830390",
+  "vn.momo.bookingplatform": "users/105007322106342197859",
+  "vn.momo.bus": "users/108790536799198663846",
+  "vn.momo.businesspage": "users/107190697037501170364",
+  "vn.momo.charitywallet": "users/100079072934789639578",
+  "vn.momo.cinema": "users/107050213009971342413",
+  "vn.momo.cornerstone": "users/100079072934789639578",
+  "vn.momo.expense": "users/102462794947249241785",
+  "vn.momo.experiences": "users/105007322106342197859",
+  "vn.momo.flight": "users/105007322106342197859",
+  "vn.momo.giftselection": "users/100079072934789639578",
+  "vn.momo.helpcenter": "users/102072943552797596818",
+  "vn.momo.heodat": "users/100079072934789639578",
+  "vn.momo.hotel": "users/107268811571346968186",
+  "vn.momo.iris": "users/116481528213656200740",
+  "vn.momo.mobilecenter": "users/105366138186365879004",
+  "vn.momo.momoreward": "users/100079072934789639578",
+  "vn.momo.mypocket": "users/100079072934789639578",
+  "vn.momo.nikepromotion": "users/100079072934789639578",
+  "vn.momo.oa": "users/107190697037501170364",
+  "vn.momo.oaportal": "users/107190697037501170364",
+  "vn.momo.paymentoffline": "users/106279817887758076140",
+  "vn.momo.paymentsdk": "users/106279817887758076140",
+  "vn.momo.pigwalking": "users/100079072934789639578",
+  "vn.momo.platinum": "users/107190697037501170364",
+  "vn.momo.promotionhub": "users/100079072934789639578",
+  "vn.momo.publicservice": "users/103058152793362725873",
+  "vn.momo.referral": "users/100079072934789639578",
+  "vn.momo.securitycenter": "users/102072943552797596818",
+  "vn.momo.shakenearby": "users/100079072934789639578",
+  "vn.momo.stock": "users/112479860052989960404",
+  "vn.momo.train": "users/107268811571346968186",
+  "vn.momo.transactionhistory": "users/102462794947249241785",
+  "vn.momo.transportcenter": "users/103058152793362725873",
+  "vn.momo.travel": "users/105007322106342197859",
+  "vn.momo.vietlottsms": "users/103541070063349578162",
+  "vn.momo.monorepo": "users/106955297172340348357",
+  "vn.momo.credit_newton": "users/108810883556893760938",
+  "vn.momo.creditcardmarketplace": "users/106628491269004268394",
+  "vn.momo.finance": "users/106628491269004268394",
+  "vn.momo.finance_remittance": "users/116481528213656200740",
+  "vn.momo.ins_car_damage": "users/106628491269004268394",
+  "vn.momo.ins_collection": "users/101833565227113239870",
+  "vn.momo.ins_marketplace": "users/116481528213656200740",
+  "vn.momo.ins_medical_social": "users/106628491269004268394",
+  "vn.momo.investment": "users/116481528213656200740",
+  "vn.momo.investmentplatform": "users/106628491269004268394",
+  "vn.momo.kratos": "users/106303658937136180468",
+  "vn.momo.lending_platform": "users/116481528213656200740",
+  "vn.momo.loan_fastmoney": "users/116481528213656200740",
+  "vn.momo.paylaterverse": "users/116481528213656200740",
+  "vn.momo.user_investment": "users/116481528213656200740",
+  "vn.momo.user_score": "users/116481528213656200740",
+  "vn.momo.vaynhanh": "users/101520379279578068463",
+  "vn.momo.chat": "users/104660424091381270425",
+  "vn.momo.profile": "users/100978890687314684768",
+  "vn.momo.newsfeed": "users/117721701937816754788",
+  "vn.momo.reviewplatform": "users/117721701937816754788",
+  "vn.momo.reels": "users/117721701937816754788",
+  "vn.momo.receivemoney": "users/111719399439871502655",
+  "vn.momo.requestmoney": "users/111719399439871502655",
+  "vn.momo.groupfund": "users/111719399439871502655",
+  "vn.momo.p2p": "users/111719399439871502655",
+  "vn.momo.p2m": "users/111719399439871502655"
+}

package/src/doctor/src/Whitelist.json

@@ -0,0 +1,6 @@
+[
+  "vn.momo.securitycenter",
+  "vn.momo.helpcenter",
+  "vn.momo.bank",
+  "vn.momo.ekyc"
+]

package/src/doctor/src/commands/check.ts

@@ -0,0 +1,81 @@
+import inquirer from 'inquirer';
+import {checkCoreDependencies} from '../utils/checkCoreDependencies';
+import {checkNativeModuleUsage} from '../task/native';
+import {getLogger, logger} from '../logger';
+import {scanMaxApiUsage} from '../utils/scanMaxApiUsage';
+import scanComponentUsage from '../utils/scanComponentUsage';
+import { checkDeprecatedPackages } from '../utils/checkDeprecatedPackages';
+import { checkDeprecatedVersion } from '../utils/checkDeprecatedVersion';
+import {scanFoundationImports} from '../utils/scanFoundationImports';
+
+// Contextual loggers for tasks
+const coreLog = getLogger('CORE_DEP');
+const nativeLog = getLogger('NATIVE_MOD');
+const maxApiLog = getLogger('MAX_API');
+const adoptionLog = getLogger('ADOPTION_RATE');
+const deprecatedPkgLog = getLogger('DEPRECATED_PKG');
+const deprecatedVerLog = getLogger('DEPRECATED_VER');
+const foundationLog = getLogger('FOUNDATION_IMPORTS');
+
+export async function checkCommand() {
+  const {task} = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'task',
+      message: 'What would you like to check?',
+      choices: [
+        'Check Mini App using @momo-kits/core or package contain dependency @momo-kits/core',
+        'Check Mini App using NativeModule',
+        'Calculate miniapp adoption rate',
+        'Check Mini App using MaxApi functions will be removed or deprecated',
+        'Check Mini App for deprecated @momo-kits packages',
+        'Check Mini App for deprecated 0.x.x dependency versions (<0.80.x)',
+        'Check Mini App using invalid @momo-kits/foundation imports',
+      ],
+    },
+  ]);
+
+  switch (task) {
+    case 'Check Mini App using @momo-kits/core or package contain dependency @momo-kits/core':
+      coreLog.info('Running core dependency check');
+      checkCoreDependencies();
+      break;
+    case 'Check Mini App using NativeModule':
+      nativeLog.info('Scanning for native module usage');
+      await checkNativeModuleUsage();
+      break;
+    case 'Calculate miniapp adoption rate':
+      adoptionLog.info('Calculating component adoption rate');
+      await scanComponentUsage();
+      break;
+    case 'Check Mini App using MaxApi functions will be removed or deprecated':
+      maxApiLog.info('Scanning for deprecated MaxAPI usage');
+      await scanMaxApiUsage();
+      break;
+    case 'Check Mini App for deprecated @momo-kits packages':
+      deprecatedPkgLog.info('Scanning for deprecated @momo-kits packages');
+      checkDeprecatedPackages();
+      break;
+    case 'Check Mini App for deprecated 0.x.x dependency versions (<0.80.x)':
+      deprecatedVerLog.info('Scanning for deprecated 0.x.x dependency versions (<0.80.x)');
+      checkDeprecatedVersion();
+      break;
+    case 'Check Mini App using invalid @momo-kits/foundation imports':
+      foundationLog.info('Scanning for invalid foundation imports');
+      const results = scanFoundationImports();
+      const files = Object.keys(results);
+      if (files.length === 0) {
+        foundationLog.success('✅ No invalid foundation imports found.');
+      } else {
+        foundationLog.error(`⚠️ Found invalid foundation imports in ${files.length} file(s):`);
+        for (const file of files) {
+          foundationLog.info(`  ${file}: ${results[file].join(', ')}`);
+        }
+        foundationLog.info('Only imports from @momo-kits/foundation are allowed, not from internal paths.');
+      }
+      break;
+    default:
+      logger.error('Invalid task');
+      break;
+  }
+}

package/src/doctor/src/commands/doctor.ts

@@ -0,0 +1,193 @@
+import {logger} from '../logger';
+import {
+  checkCoreDependencies,
+  scanCoreNodeModule,
+} from '../utils/checkCoreDependencies';
+import {checkNativeModuleUsage} from '../task/native';
+import scanComponentUsage from '../utils/scanComponentUsage';
+import {scanNativeModulesUsage} from '../utils/scanNativeModulesUsage';
+import {scanMaxApiUsage} from '../utils/scanMaxApiUsage';
+import {checkDeprecatedPackages} from '../utils/checkDeprecatedPackages';
+import {checkDeprecatedVersion} from '../utils/checkDeprecatedVersion';
+import {sendMessage} from '../utils/sendMessage';
+import {getErrorMessage} from '../utils/getErrorMessage';
+import {checkWrongVersionCommunityPackage} from '../utils/checkWrongVersionCommunityPackage';
+import {
+  scanFoundationImports,
+  scanInternalImportsBuckets,
+} from '../utils/scanFoundationImports';
+import {checkDeletedPackages} from '../utils/checkDeletedPackage';
+import checkShareDependencies from '../utils/checkShareDependencies';
+
+/**
+ * Runs all health checks: core dependencies, native modules, deprecated MaxAPI usage, and foundation imports.
+ * Logs results and outputs a final app health summary.
+ */
+export async function doctorCommand(appIdArg?: string): Promise<void> {
+  logger.info('🧰 Running doctor: performing all checks...');
+
+  const BranchOwners: {[key: string]: string} = await fetch(
+    'https://static.momocdn.net/app/json/component-kits/Users.json'
+  )
+    .then(res => res.json())
+    .catch(e => {
+      console.log(e);
+      return;
+    });
+
+  const WhiteListAppId: string[] = await fetch(
+    'https://static.momocdn.net/app/json/component-kits/Whitelist.json'
+  )
+    .then(res => res.json())
+    .catch(e => {
+      console.log(e);
+      return;
+    });
+
+  const isWhitelist = WhiteListAppId.includes(appIdArg || 'vn.momo');
+
+  let allHealthy = true;
+
+  // Core dependency check
+  const coreHealthy = checkCoreDependencies();
+  const nodeModuleHaveCore = scanCoreNodeModule();
+  if (!coreHealthy || !nodeModuleHaveCore) {
+    if (isWhitelist) {
+      allHealthy = false;
+    } else {
+      throw new Error(
+        'Core dependencies check failed. Please ensure all required dependencies are installed and up-to-date.'
+      );
+    }
+  }
+
+  // Native modules usage check
+  const nativeResults = scanNativeModulesUsage();
+  const nativeHealthy = await checkNativeModuleUsage();
+  const nativeUsageCount = Object.keys(nativeResults).length;
+  if (!nativeHealthy) {
+    if (isWhitelist) {
+      allHealthy = false;
+    } else {
+      throw new Error(
+        'Native module usage check failed. Please ensure all native modules are correctly implemented.'
+      );
+    }
+  }
+
+  const deletedPackages = checkDeletedPackages();
+  if (deletedPackages.found.length > 0) {
+    if (isWhitelist) {
+      allHealthy = false;
+    } else {
+      throw new Error(
+        `Deleted packages found: ${deletedPackages.found.join(
+          ', '
+        )}. Please remove them from your package.json.`
+      );
+    }
+  }
+
+  // Component usage scan
+  logger.info('🔍 Scanning component usage...');
+  let componentRate: number = 0;
+  try {
+    const {rate = 0} = await scanComponentUsage();
+    componentRate = rate;
+    if (rate < 0.5) {
+      allHealthy = false;
+    }
+  } catch (error) {
+    logger.error(`Component scan failed: ${error}`);
+    allHealthy = false;
+  }
+
+  // Deprecated MaxAPI usage check
+  const maxApiResults = scanMaxApiUsage();
+  const maxApiHealthy = Object.keys(maxApiResults).length === 0;
+  if (maxApiHealthy) {
+    logger.success('✅ No deprecated MaxAPI usage found.');
+  } else {
+    allHealthy = false;
+  }
+
+  // Deprecated packages check
+  const {healthy: deprecatedPkgHealthy, found: deprecatedPkgList} =
+    checkDeprecatedPackages();
+  if (!deprecatedPkgHealthy) {
+    allHealthy = false;
+  }
+
+  // Deprecated version check
+  const {healthy: deprecatedVerHealthy, found: deprecatedVerList} =
+    checkDeprecatedVersion();
+  if (!deprecatedVerHealthy) {
+    allHealthy = false;
+  }
+
+  // Wrong version check
+  const {healthy: wrongVersionHealthy, found: wrongVersionList} =
+    checkWrongVersionCommunityPackage();
+  if (!wrongVersionHealthy) {
+    allHealthy = false;
+  }
+
+  const sharedDependenciesResult = checkShareDependencies();
+  if (!sharedDependenciesResult.healthy) {
+    allHealthy = false;
+  }
+
+  // Foundation imports check
+  logger.info('🔍 Scanning foundation imports...');
+  const foundationResults = scanFoundationImports();
+  const {foundations: foundationInternalImports, momoKitsOthers} =
+    scanInternalImportsBuckets();
+  const foundationHealthy =
+    foundationInternalImports.length === 0 && momoKitsOthers.length === 0;
+  if (foundationHealthy) {
+    logger.success('✅ No invalid foundation imports found.');
+  } else {
+    logger.error(
+      `⚠️ Found invalid foundation imports in ${
+        Object.keys(foundationResults).length
+      } file(s). Only imports from @momo-kits/foundation are allowed, not from internal paths.`
+    );
+    throw new Error(
+      'Invalid nested imports found. Please import from entry only'
+    );
+  }
+
+  // Final app health summary
+  if (allHealthy) {
+    logger.success('🎉 App health is good! All checks passed.');
+  } else {
+    logger.error(
+      '⚠️ App health issues detected. Please review the above errors.'
+    );
+  }
+
+  const appId = appIdArg || 'vn.momo';
+  const url =
+    'https://chat.googleapis.com/v1/spaces/AAAAbP8987c/messages?key=AIzaSyDdI0hCZtE6vySjMm-WEfRq3CPzqKqqsHI&token=UGSFRvk_oYb9uGsAgs31bVvMm6jDkmD8zihGm3eyaQA';
+
+  const messageTest = getErrorMessage(
+    coreHealthy,
+    nativeHealthy,
+    nativeUsageCount,
+    componentRate,
+    maxApiHealthy,
+    maxApiResults,
+    deprecatedPkgList,
+    deprecatedVerList,
+    wrongVersionList,
+    sharedDependenciesResult.issues,
+    foundationResults
+  );
+  const userId = BranchOwners[appId];
+
+  console.log('Doctor check output:\n', appId, messageTest);
+
+  if (appId && userId && messageTest) {
+    sendMessage(url, messageTest, userId, appId);
+  }
+}

package/src/doctor/src/index.ts

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+
+import {program} from 'commander';
+import {logger} from './logger';
+
+// Import commands
+import {checkCommand} from './commands/check';
+import {doctorCommand} from './commands/doctor';
+
+// Set up CLI
+program.name('momo-kits').description('MoMo Kits doctor CLI').version('0.1.0');
+
+// Add check command
+program
+  .command('check')
+  .description(
+    'Run check mini app with common rule and compatible with MoMo Platform App'
+  )
+  .action(checkCommand);
+
+// Add doctor command to run all checks
+program
+  .command('doctor [appId]')
+  .description('Run all checks and log app health summary')
+  .action((appId?: string) => doctorCommand(appId));
+
+// Handle when no command is specified
+if (process.argv.length <= 2) {
+  logger.info('🧰 Welcome to Momo-kits doctor CLI!');
+  logger.info('Run `momo-kits --help` to see available commands');
+  program.help();
+}
+
+// Parse args
+program.parse();

package/src/doctor/src/logger.ts

@@ -0,0 +1,84 @@
+import chalk from 'chalk';
+
+// Define log levels
+export enum LogLevel {
+  DEBUG = 0,
+  INFO = 1,
+  WARN = 2,
+  ERROR = 3,
+}
+
+// String identifiers for log levels, used for environment variable lookup and tagging
+const LOG_LEVELS = ['debug', 'info', 'warn', 'error'] as const;
+type LogLevelName = typeof LOG_LEVELS[number];
+
+// Determine current log level from environment (default to INFO)
+const envLevel = (process.env.LOG_LEVEL || 'info').toLowerCase() as LogLevelName;
+const currentLevel: LogLevel =
+  LOG_LEVELS.includes(envLevel)
+    ? (LOG_LEVELS.indexOf(envLevel) as LogLevel)
+    : LogLevel.INFO;
+
+// Check if a message at the given level should be logged
+function shouldLog(level: LogLevel): boolean {
+  return level >= currentLevel;
+}
+
+// Format the message with a level tag and color
+function formatMessage(level: LogLevel, message: string): string {
+  const tag = `[${LOG_LEVELS[level].toUpperCase()}]`;
+  switch (level) {
+    case LogLevel.DEBUG:
+      return chalk.gray(`${tag} ${message}`);
+    case LogLevel.INFO:
+      return chalk.blue(`${tag} ${message}`);
+    case LogLevel.WARN:
+      return chalk.yellow(`${tag} ${message}`);
+    case LogLevel.ERROR:
+      return chalk.red(`${tag} ${message}`);
+    default:
+      return message;
+  }
+}
+
+// Common logger with methods for each level
+export const logger = {
+  debug: (message: string) => {
+    if (shouldLog(LogLevel.DEBUG)) {
+      console.log(formatMessage(LogLevel.DEBUG, message));
+    }
+  },
+  info: (message: string) => {
+    if (shouldLog(LogLevel.INFO)) {
+      console.log(formatMessage(LogLevel.INFO, message));
+    }
+  },
+  warn: (message: string) => {
+    if (shouldLog(LogLevel.WARN)) {
+      console.warn(formatMessage(LogLevel.WARN, message));
+    }
+  },
+  error: (message: string) => {
+    if (shouldLog(LogLevel.ERROR)) {
+      console.error(formatMessage(LogLevel.ERROR, message));
+    }
+  },
+  // Shortcut for success messages (green)
+  success: (message: string) => {
+    if (shouldLog(LogLevel.INFO)) {
+      console.log(chalk.green(`[SUCCESS] ${message}`));
+    }
+  },
+};
+
+// Factory to create a logger with a context tag prefix
+export function getLogger(context: string) {
+  const prefix = `[${context}] `;
+  return {
+    debug: (message: string) => logger.debug(prefix + message),
+    info: (message: string) => logger.info(prefix + message),
+    warn: (message: string) => logger.warn(prefix + message),
+    error: (message: string) => logger.error(prefix + message),
+    success: (message: string) => logger.success(prefix + message),
+  };
+} 

package/src/doctor/src/task/native.ts

@@ -0,0 +1,21 @@
+import { logger } from '../logger';
+import {scanNativeModulesUsage, ScanResult} from '../utils/scanNativeModulesUsage';
+
+/**
+ * Checks for Native Modules usage in code directories and logs results.
+ */
+export async function checkNativeModuleUsage(): Promise<boolean> {
+  logger.info('Scanning for Native modules usage...');
+  const results: ScanResult = scanNativeModulesUsage();
+  const files = Object.keys(results);
+  if (files.length === 0) {
+    logger.success('✅ No native modules usage found.');
+    return true;
+  } else {
+    logger.error(`⚠️ Found native modules usage in ${files.length} file(s):`);
+    for (const file of files) {
+      logger.info(`  ${file}: ${results[file].join(', ')}`);
+    }
+    return false;
+  }
+} 

package/src/doctor/src/task/utils.ts

@@ -0,0 +1,20 @@
+import {clearInterval} from 'node:timers';
+
+/**
+ * Displays an animated loading indicator
+ * @returns Promise that resolves when loading completes
+ */
+export function simulateLoading() {
+  const frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+  let i = 0;
+
+  process.stdout.write('\r');
+  const interval = setInterval(() => {
+    process.stdout.write(`\r${frames[i]} Processing...`);
+    i = (i + 1) % frames.length;
+  }, 80);
+
+  return () => {
+    clearInterval(interval);
+  };
+}