feat: add MCP package validation script and integrate into npm publish workflow

Author: dkalinovInfra

.github/workflows/npm-publish.yml

@@ -29,10 +29,18 @@ jobs:
           npm run build-pack
           node scripts/build-task.js
 
+      - name: Validate MCP package contents
+        run: npm run validate:package --workspace=@igniteui/mcp-server -- --expected-version "$VERSION"
+
       - name: Define npm tag
         run: |
-          if [[ ${VERSION} == *"alpha"* || ${VERSION} == *"beta"* || ${VERSION} == *"rc"* ]]; then echo "NPM_TAG=next"; else echo "NPM_TAG=latest"; fi >> $GITHUB_ENV
-          echo ${NPM_TAG}
+          if [[ ${VERSION} == *"alpha"* || ${VERSION} == *"beta"* || ${VERSION} == *"rc"* ]]; then
+            NPM_TAG=next
+          else
+            NPM_TAG=latest
+          fi
+          echo "NPM_TAG=$NPM_TAG" >> $GITHUB_ENV
+          echo "$NPM_TAG"
 
       - name: Publish packages
         # use npm run as yarn run changes the registry and publishes to https://registry.yarnpkg.com

packages/igniteui-mcp/igniteui-doc-mcp/package.json

@@ -38,6 +38,7 @@
     "test:watch": "vitest",
     "coverage": "vitest run --coverage",
     "build:db": "npx tsx scripts/build-db.ts",
+    "validate:package": "npx tsx scripts/validate-package.ts",
     "inspector": "npx @modelcontextprotocol/inspector dist/index.js",
     "clear": "npx tsx -e \"import{rmSync}from'fs';rmSync('dist',{recursive:true,force:true})\"",
     "clear:angular": "npx tsx -e \"import{rmSync}from'fs';['docs_processing','docs_prepeared','docs_final'].forEach(d=>{rmSync('dist/'+d+'/angular',{recursive:true,force:true})})\"",

packages/igniteui-mcp/igniteui-doc-mcp/scripts/validate-package.ts

@@ -0,0 +1,110 @@
+import { readdirSync, readFileSync, statSync, existsSync } from "fs";
+import { join, resolve } from "path";
+import { fileURLToPath } from "url";
+
+const PKG_ROOT = resolve(fileURLToPath(new URL("..", import.meta.url)));
+const DB_PATH = join(PKG_ROOT, "dist", "igniteui-docs.db");
+const DB_MIN_BYTES = 20 * 1024 * 1024; // 20 MB minimum for the SQLite DB
+const DOCS_ROOT = join(PKG_ROOT, "docs");
+const FRAMEWORK_DIRS = ["angular-api", "react-api", "webcomponents-api", "blazor-api"];
+const PACKAGE_MIN_BYTES = 300 * 1024; // 300 KB minimum for each package
+
+const errors: string[] = [];
+
+function getExpectedVersion(): string | null {
+  const idx = process.argv.indexOf("--expected-version");
+  if (idx >= 0 && process.argv[idx + 1]) return process.argv[idx + 1].replace(/^v/, "");
+  if (process.env.EXPECTED_VERSION) return process.env.EXPECTED_VERSION.replace(/^v/, "");
+  return null;
+}
+
+const expectedVersion = getExpectedVersion();
+if (expectedVersion) {
+  const pkgJsonPath = join(PKG_ROOT, "package.json");
+  const pkgJson = JSON.parse(readFileSync(pkgJsonPath, "utf8"));
+  if (pkgJson.version !== expectedVersion) {
+    errors.push(`package.json version mismatch: got ${pkgJson.version}, expected ${expectedVersion}`);
+  } else {
+    console.log(`OK  ver package.json           ${pkgJson.version}`);
+  }
+
+  const serverJsonPath = join(PKG_ROOT, "server.json");
+  if (!existsSync(serverJsonPath)) {
+    errors.push(`server.json missing: ${serverJsonPath}`);
+  } else {
+    const serverJson = JSON.parse(readFileSync(serverJsonPath, "utf8"));
+    if (serverJson.version !== expectedVersion) {
+      errors.push(`server.json version mismatch: got ${serverJson.version}, expected ${expectedVersion}`);
+    } else {
+      console.log(`OK  ver server.json          ${serverJson.version}`);
+    }
+    const pkgs: Array<{ identifier?: string; version?: string }> = serverJson.packages ?? [];
+    if (pkgs.length === 0) {
+      errors.push(`server.json has no entries in "packages"`);
+    }
+    pkgs.forEach((p, i) => {
+      const label = p.identifier ?? `packages[${i}]`;
+      if (p.version !== expectedVersion) {
+        errors.push(`server.json ${label} version mismatch: got ${p.version}, expected ${expectedVersion}`);
+      } else {
+        console.log(`OK  ver server.json ${label.padEnd(20)} ${p.version}`);
+      }
+    });
+  }
+}
+
+function formatSize(bytes: number): string {
+  if (bytes >= 1024 * 1024) return `${(bytes / 1024 / 1024).toFixed(2)} MB`;
+  if (bytes >= 1024) return `${(bytes / 1024).toFixed(2)} KB`;
+  return `${bytes} B`;
+}
+
+function dirSize(dir: string): number {
+  let total = 0;
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    const full = join(dir, entry.name);
+    if (entry.isDirectory()) total += dirSize(full);
+    else if (entry.isFile()) total += statSync(full).size;
+  }
+  return total;
+}
+
+if (!existsSync(DB_PATH)) {
+  errors.push(`DB missing: ${DB_PATH}`);
+} else {
+  const size = statSync(DB_PATH).size;
+  if (size < DB_MIN_BYTES) {
+    errors.push(`DB too small: ${formatSize(size)} < ${formatSize(DB_MIN_BYTES)} (${DB_PATH})`);
+  } else {
+    console.log(`OK  db  ${formatSize(size)}  ${DB_PATH}`);
+  }
+}
+
+for (const framework of FRAMEWORK_DIRS) {
+  const frameworkDir = join(DOCS_ROOT, framework);
+  if (!existsSync(frameworkDir)) {
+    errors.push(`Docs framework dir missing: ${frameworkDir}`);
+    continue;
+  }
+  const packages = readdirSync(frameworkDir, { withFileTypes: true }).filter(e => e.isDirectory());
+  if (packages.length === 0) {
+    errors.push(`No package subfolders in ${frameworkDir}`);
+    continue;
+  }
+  for (const pkg of packages) {
+    const pkgDir = join(frameworkDir, pkg.name);
+    const size = dirSize(pkgDir);
+    if (size < PACKAGE_MIN_BYTES) {
+      errors.push(`Package too small: ${framework}/${pkg.name} = ${formatSize(size)} < ${formatSize(PACKAGE_MIN_BYTES)}`);
+    } else {
+      console.log(`OK  pkg ${formatSize(size).padStart(10)}  ${framework}/${pkg.name}`);
+    }
+  }
+}
+
+if (errors.length > 0) {
+  console.error(`\nValidation failed with ${errors.length} error(s):`);
+  for (const e of errors) console.error(`  - ${e}`);
+  process.exit(1);
+}
+console.log("\nAll checks passed.");