add the ability to find details for multiple vats

packages/synthetic-chain/src/lib/vat-status.js

@@ -62,6 +62,14 @@ const makeSwingstore = db => {
       if (!targetVat) throw Error(`vat not found: ${vatName}`);
       return targetVat;
     },
+    /** @param {string} string a substring to search for within the vat name. */
+    findVats: string => {
+      /** @type {string[]} */
+      const dynamicIDs = kvGetJSON('vat.dynamicIDs');
+      return dynamicIDs.filter(vatID =>
+        lookupVat(vatID).options().name.includes(string),
+      );
+    },
     lookupVat,
   });
 };
@@ -92,3 +100,24 @@ export const getIncarnation = async vatName => {
 
   return details.incarnation;
 };
+
+/** @param {string} vatName */
+export const getDetailsMatchingVats = async vatName => {
+  const fullPath = swingstorePath.replace(/^~/, NonNullish(HOME));
+
+  const db = dbOpenAmbient(fullPath, { readonly: true });
+  const kStore = makeSwingstore(db);
+
+  const vatIDs = kStore.findVats(vatName);
+  const infos = [];
+  for (const vatID of vatIDs) {
+    const vatInfo = kStore.lookupVat(vatID);
+    const name = vatInfo.options().name;
+    const source = vatInfo.source();
+    // @ts-expect-error cast
+    const { incarnation } = vatInfo.currentSpan();
+    infos.push({ vatName: name, vatID, incarnation, ...source });
+  }
+
+  return infos;
+};

packages/synthetic-chain/test/snapshots/test-exports.ts.md

@@ -60,6 +60,7 @@ Generated by [AVA](https://avajs.dev).
       generateOracleMap: Function generateOracleMap {},
       getAuctionCollateral: AsyncFunction {},
       getContractInfo: AsyncFunction {},
+      getDetailsMatchingVats: AsyncFunction {},
       getISTBalance: AsyncFunction {},
       getIncarnation: AsyncFunction {},
       getInstanceBoardId: AsyncFunction {},