simple-dynamsoft-mcp 7.2.3 → 7.2.4

package/data/metadata/data-manifest.json

@@ -28,8 +28,8 @@
       "branch": "main",
       "owner": "dynamsoft-docs",
       "repo": "barcode-reader-docs-server",
-      "commit": "80a3d89c3b8ee53e4640a87fe36cf6d96714929e",
-      "archiveUrl": "https://codeload.github.com/dynamsoft-docs/barcode-reader-docs-server/zip/80a3d89c3b8ee53e4640a87fe36cf6d96714929e"
+      "commit": "5479d530342edc40d1602addebbb8cd60ed781ce",
+      "archiveUrl": "https://codeload.github.com/dynamsoft-docs/barcode-reader-docs-server/zip/5479d530342edc40d1602addebbb8cd60ed781ce"
     },
     {
       "name": "data/documentation/capture-vision-docs",
@@ -78,8 +78,8 @@
       "branch": "main",
       "owner": "dynamsoft-docs",
       "repo": "document-viewer-docs",
-      "commit": "26ea218ada436b1bbae04a224ebe2d42a08fef5b",
-      "archiveUrl": "https://codeload.github.com/dynamsoft-docs/document-viewer-docs/zip/26ea218ada436b1bbae04a224ebe2d42a08fef5b"
+      "commit": "4a49e918d174f4efac927981b81c81024d9ba3dc",
+      "archiveUrl": "https://codeload.github.com/dynamsoft-docs/document-viewer-docs/zip/4a49e918d174f4efac927981b81c81024d9ba3dc"
     },
     {
       "name": "data/documentation/web-twain-docs",
@@ -88,8 +88,8 @@
       "branch": "master",
       "owner": "dynamsoft-docs",
       "repo": "web-twain-docs",
-      "commit": "275eefb2a97512e91cfca139ac58f8a8b6317f8a",
-      "archiveUrl": "https://codeload.github.com/dynamsoft-docs/web-twain-docs/zip/275eefb2a97512e91cfca139ac58f8a8b6317f8a"
+      "commit": "a38d73c583b8379c0d80337e92f291f6c1ab10a8",
+      "archiveUrl": "https://codeload.github.com/dynamsoft-docs/web-twain-docs/zip/a38d73c583b8379c0d80337e92f291f6c1ab10a8"
     },
     {
       "name": "data/samples/dynamic-web-twain",

package/data/metadata/dynamsoft_sdks.json

@@ -492,7 +492,7 @@
     "ddv": {
       "name": "Dynamsoft Document Viewer",
       "description": "Browser-based JavaScript SDK for viewing, editing, and annotating documents (PDFs and images).",
-      "version": "3.2",
+      "version": "3.2.1",
       "default_platform": "web",
       "snippet_path": "dynamsoft-document-viewer",
       "api_docs": "ddv-api-docs.json",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "simple-dynamsoft-mcp",
-  "version": "7.2.3",
+  "version": "7.2.4",
   "description": "MCP server for Dynamsoft SDKs - Capture Vision, Barcode Reader (Mobile/Python/Web), Dynamic Web TWAIN, and Document Viewer. Provides documentation, code snippets, and API guidance.",
   "license": "MIT",
   "repository": {
@@ -24,7 +24,7 @@
   "scripts": {
     "start": "node src/index.js",
     "test": "npm run test:lite",
-    "test:unit": "node --test test/unit/gemini-retry.test.js test/unit/profile-config.test.js test/unit/lexical-provider.test.js test/unit/hydration-mode.test.js test/unit/hydration-policy.test.js test/unit/repo-map.test.js test/unit/download-utils.test.js test/unit/logging.test.js test/unit/create-server.test.js test/unit/server-helpers.test.js",
+    "test:unit": "node --test test/unit/gemini-retry.test.js test/unit/profile-config.test.js test/unit/lexical-provider.test.js test/unit/hydration-mode.test.js test/unit/hydration-policy.test.js test/unit/repo-map.test.js test/unit/download-utils.test.js test/unit/logging.test.js test/unit/rag-signature-manifest.test.js test/unit/create-server.test.js test/unit/server-helpers.test.js",
     "test:lite": "npm run test:stdio && npm run test:http && npm run test:package",
     "test:lexical": "node --test test/integration/stdio.test.js test/integration/http.test.js",
     "test:gemini": "node scripts/run-gemini-tests.mjs",

package/src/server/resource-index/paths.js

@@ -1,5 +1,5 @@
-import { existsSync, readFileSync, statSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { DOC_DIRS, SAMPLE_DIRS } from "./config.js";
 import { getResolvedDataRoot } from "../../data/root.js";
@@ -13,6 +13,9 @@ const samplesRoot = join(dataRoot, "samples");
 const docsRoot = join(dataRoot, "documentation");
 
 const registryPath = join(metadataRoot, "dynamsoft_sdks.json");
+const dataManifestPath = join(metadataRoot, "data-manifest.json");
+
+const manifestCommitLookupCache = new Map();
 
 const SAMPLE_ROOTS = {
   dbrWeb: join(samplesRoot, SAMPLE_DIRS.dbrWeb),
@@ -60,28 +63,92 @@ function getExistingPath(...candidates) {
   return null;
 }
 
-function readSubmoduleHead(repoPath) {
+function normalizeManifestRepoPath(pathValue) {
+  return String(pathValue || "")
+    .replace(/\\/g, "/")
+    .replace(/^\.\//, "")
+    .replace(/^\/+/, "")
+    .replace(/\/+$/, "");
+}
+
+function getManifestRepoPath(repoPath, dataRootPath = dataRoot) {
+  const resolvedDataRoot = resolve(dataRootPath);
+  const resolvedRepoPath = resolve(repoPath);
+  const manifestRepoPath = normalizeManifestRepoPath(
+    relative(resolvedDataRoot, resolvedRepoPath)
+  );
+
+  if (!manifestRepoPath || manifestRepoPath === ".") {
+    throw new Error(`Unable to resolve manifest repo path for ${repoPath}`);
+  }
+
+  if (manifestRepoPath.startsWith("..")) {
+    throw new Error(
+      `Repo path ${repoPath} is outside data root ${resolvedDataRoot}`
+    );
+  }
+
+  return manifestRepoPath;
+}
+
+function buildManifestCommitLookup(manifestPath = dataManifestPath) {
+  const resolvedManifestPath = resolve(manifestPath);
+  const cachedLookup = manifestCommitLookupCache.get(resolvedManifestPath);
+  if (cachedLookup) {
+    return cachedLookup;
+  }
+
+  if (!existsSync(resolvedManifestPath)) {
+    throw new Error(`Missing data manifest at ${resolvedManifestPath}`);
+  }
+
+  let manifest = null;
   try {
-    const gitMarker = join(repoPath, ".git");
-    if (!existsSync(gitMarker)) return "";
-    let gitDir = gitMarker;
-    const markerStats = statSync(gitMarker);
-    if (!markerStats.isDirectory()) {
-      const markerText = readFileSync(gitMarker, "utf8").trim();
-      if (!markerText.toLowerCase().startsWith("gitdir:")) return "";
-      const relGitDir = markerText.slice("gitdir:".length).trim();
-      gitDir = resolve(repoPath, relGitDir);
+    manifest = JSON.parse(readFileSync(resolvedManifestPath, "utf8"));
+  } catch (error) {
+    const reason = error instanceof Error ? error.message : String(error);
+    throw new Error(
+      `Failed to parse data manifest at ${resolvedManifestPath}: ${reason}`
+    );
+  }
+
+  if (!manifest || !Array.isArray(manifest.repos)) {
+    throw new Error(
+      `Invalid data manifest at ${resolvedManifestPath}: missing repos array`
+    );
+  }
+
+  const lookup = new Map();
+  for (const repo of manifest.repos) {
+    const repoPath = normalizeManifestRepoPath(repo?.path);
+    const commit = String(repo?.commit || "").trim();
+    if (!repoPath || !commit) {
+      throw new Error(
+        `Invalid data manifest entry at ${resolvedManifestPath}: path and commit are required`
+      );
     }
-    const headPath = join(gitDir, "HEAD");
-    if (!existsSync(headPath)) return "";
-    const headText = readFileSync(headPath, "utf8").trim();
-    if (!headText.startsWith("ref:")) return headText;
-    const refPath = join(gitDir, headText.slice("ref:".length).trim());
-    if (!existsSync(refPath)) return "";
-    return readFileSync(refPath, "utf8").trim();
-  } catch {
-    return "";
+    lookup.set(repoPath, commit);
   }
+
+  manifestCommitLookupCache.set(resolvedManifestPath, lookup);
+  return lookup;
+}
+
+function readManifestRepoCommit(repoPath, options = {}) {
+  const dataRootPath = options.dataRootPath || dataRoot;
+  const manifestPath = options.manifestPath || dataManifestPath;
+  const commitLookup =
+    options.commitLookup || buildManifestCommitLookup(manifestPath);
+  const manifestRepoPath = getManifestRepoPath(repoPath, dataRootPath);
+  const commit = commitLookup.get(manifestRepoPath);
+
+  if (!commit) {
+    throw new Error(
+      `Missing commit for ${manifestRepoPath} in data manifest ${resolve(manifestPath)}`
+    );
+  }
+
+  return commit;
 }
 
 export {
@@ -91,8 +158,10 @@ export {
   samplesRoot,
   docsRoot,
   registryPath,
+  dataManifestPath,
   SAMPLE_ROOTS,
   DOC_ROOTS,
   getExistingPath,
-  readSubmoduleHead
+  buildManifestCommitLookup,
+  readManifestRepoCommit
 };

package/src/server/resource-index.js

@@ -17,7 +17,12 @@ import {
 } from "./normalizers.js";
 import { DOCS_CONFIG } from "./resource-index/config.js";
 import { loadMarkdownDocs } from "./resource-index/docs-loader.js";
-import { registryPath, DOC_ROOTS, SAMPLE_ROOTS, readSubmoduleHead } from "./resource-index/paths.js";
+import {
+  registryPath,
+  DOC_ROOTS,
+  SAMPLE_ROOTS,
+  readManifestRepoCommit
+} from "./resource-index/paths.js";
 import {
   getCodeFileExtensions,
   isCodeFile,
@@ -489,38 +494,38 @@ function getRagSignatureData() {
     ddvDocCount: ddvDocs.articles.length,
     versions: LATEST_VERSIONS,
     dataSources: {
-      dbrWebSamplesHead: readSubmoduleHead(SAMPLE_ROOTS.dbrWeb),
-      dbrMobileSamplesHead: readSubmoduleHead(SAMPLE_ROOTS.dbrMobile),
-      dbrPythonSamplesHead: readSubmoduleHead(SAMPLE_ROOTS.dbrPython),
-      dbrDotnetSamplesHead: readSubmoduleHead(SAMPLE_ROOTS.dbrDotnet),
-      dbrJavaSamplesHead: readSubmoduleHead(SAMPLE_ROOTS.dbrJava),
-      dbrCppSamplesHead: readSubmoduleHead(SAMPLE_ROOTS.dbrCpp),
-      dbrMauiSamplesHead: readSubmoduleHead(SAMPLE_ROOTS.dbrMaui),
-      dbrReactNativeSamplesHead: readSubmoduleHead(SAMPLE_ROOTS.dbrReactNative),
-      dbrFlutterSamplesHead: readSubmoduleHead(SAMPLE_ROOTS.dbrFlutter),
-      dbrNodejsSamplesHead: readSubmoduleHead(SAMPLE_ROOTS.dbrNodejs),
-      dcvWebSamplesHead: readSubmoduleHead(SAMPLE_ROOTS.dcvWeb),
-      dcvMobileSamplesHead: readSubmoduleHead(SAMPLE_ROOTS.dcvMobile),
-      dcvPythonSamplesHead: readSubmoduleHead(SAMPLE_ROOTS.dcvPython),
-      dcvDotnetSamplesHead: readSubmoduleHead(SAMPLE_ROOTS.dcvDotnet),
-      dcvJavaSamplesHead: readSubmoduleHead(SAMPLE_ROOTS.dcvJava),
-      dcvCppSamplesHead: readSubmoduleHead(SAMPLE_ROOTS.dcvCpp),
-      dcvMauiSamplesHead: readSubmoduleHead(SAMPLE_ROOTS.dcvMaui),
-      dcvReactNativeSamplesHead: readSubmoduleHead(SAMPLE_ROOTS.dcvReactNative),
-      dcvFlutterSamplesHead: readSubmoduleHead(SAMPLE_ROOTS.dcvFlutter),
-      dcvNodejsSamplesHead: readSubmoduleHead(SAMPLE_ROOTS.dcvNodejs),
-      dcvSpmSamplesHead: readSubmoduleHead(SAMPLE_ROOTS.dcvSpm),
-      dwtSamplesHead: readSubmoduleHead(SAMPLE_ROOTS.dwt),
-      ddvSamplesHead: readSubmoduleHead(SAMPLE_ROOTS.ddv),
-      dbrWebDocsHead: readSubmoduleHead(DOC_ROOTS.dbrWeb),
-      dbrMobileDocsHead: readSubmoduleHead(DOC_ROOTS.dbrMobile),
-      dbrServerDocsHead: readSubmoduleHead(DOC_ROOTS.dbrServer),
-      dcvCoreDocsHead: readSubmoduleHead(DOC_ROOTS.dcvCore),
-      dcvWebDocsHead: readSubmoduleHead(DOC_ROOTS.dcvWeb),
-      dcvMobileDocsHead: readSubmoduleHead(DOC_ROOTS.dcvMobile),
-      dcvServerDocsHead: readSubmoduleHead(DOC_ROOTS.dcvServer),
-      dwtDocsHead: readSubmoduleHead(DOC_ROOTS.dwt),
-      ddvDocsHead: readSubmoduleHead(DOC_ROOTS.ddv),
+      dbrWebSamplesHead: readManifestRepoCommit(SAMPLE_ROOTS.dbrWeb),
+      dbrMobileSamplesHead: readManifestRepoCommit(SAMPLE_ROOTS.dbrMobile),
+      dbrPythonSamplesHead: readManifestRepoCommit(SAMPLE_ROOTS.dbrPython),
+      dbrDotnetSamplesHead: readManifestRepoCommit(SAMPLE_ROOTS.dbrDotnet),
+      dbrJavaSamplesHead: readManifestRepoCommit(SAMPLE_ROOTS.dbrJava),
+      dbrCppSamplesHead: readManifestRepoCommit(SAMPLE_ROOTS.dbrCpp),
+      dbrMauiSamplesHead: readManifestRepoCommit(SAMPLE_ROOTS.dbrMaui),
+      dbrReactNativeSamplesHead: readManifestRepoCommit(SAMPLE_ROOTS.dbrReactNative),
+      dbrFlutterSamplesHead: readManifestRepoCommit(SAMPLE_ROOTS.dbrFlutter),
+      dbrNodejsSamplesHead: readManifestRepoCommit(SAMPLE_ROOTS.dbrNodejs),
+      dcvWebSamplesHead: readManifestRepoCommit(SAMPLE_ROOTS.dcvWeb),
+      dcvMobileSamplesHead: readManifestRepoCommit(SAMPLE_ROOTS.dcvMobile),
+      dcvPythonSamplesHead: readManifestRepoCommit(SAMPLE_ROOTS.dcvPython),
+      dcvDotnetSamplesHead: readManifestRepoCommit(SAMPLE_ROOTS.dcvDotnet),
+      dcvJavaSamplesHead: readManifestRepoCommit(SAMPLE_ROOTS.dcvJava),
+      dcvCppSamplesHead: readManifestRepoCommit(SAMPLE_ROOTS.dcvCpp),
+      dcvMauiSamplesHead: readManifestRepoCommit(SAMPLE_ROOTS.dcvMaui),
+      dcvReactNativeSamplesHead: readManifestRepoCommit(SAMPLE_ROOTS.dcvReactNative),
+      dcvFlutterSamplesHead: readManifestRepoCommit(SAMPLE_ROOTS.dcvFlutter),
+      dcvNodejsSamplesHead: readManifestRepoCommit(SAMPLE_ROOTS.dcvNodejs),
+      dcvSpmSamplesHead: readManifestRepoCommit(SAMPLE_ROOTS.dcvSpm),
+      dwtSamplesHead: readManifestRepoCommit(SAMPLE_ROOTS.dwt),
+      ddvSamplesHead: readManifestRepoCommit(SAMPLE_ROOTS.ddv),
+      dbrWebDocsHead: readManifestRepoCommit(DOC_ROOTS.dbrWeb),
+      dbrMobileDocsHead: readManifestRepoCommit(DOC_ROOTS.dbrMobile),
+      dbrServerDocsHead: readManifestRepoCommit(DOC_ROOTS.dbrServer),
+      dcvCoreDocsHead: readManifestRepoCommit(DOC_ROOTS.dcvCore),
+      dcvWebDocsHead: readManifestRepoCommit(DOC_ROOTS.dcvWeb),
+      dcvMobileDocsHead: readManifestRepoCommit(DOC_ROOTS.dcvMobile),
+      dcvServerDocsHead: readManifestRepoCommit(DOC_ROOTS.dcvServer),
+      dwtDocsHead: readManifestRepoCommit(DOC_ROOTS.dwt),
+      ddvDocsHead: readManifestRepoCommit(DOC_ROOTS.ddv),
       registrySha256
     }
   };