wiki-graph 0.4.0 → 0.4.1

package/dist/index.cjs

@@ -2835,7 +2835,9 @@ async function createFindObject(hit, context) {
   if (hit.type === "meta") {
     return {
       ...librarySource,
+      text: hit.snippet,
       title: hit.title,
+      type: "meta",
       uri
     };
   }
@@ -4218,6 +4220,19 @@ async function runNextLibraryIndexPage(args, cursor) {
           types: cursor.types
         });
       }
+      if (isLibraryArchiveMemberCursor(cursor)) {
+        await writeFindHits(
+          createCollectionFindResult(
+            await (0, import_wiki_graph_core35.listWikiGraphLibraryArchiveMembers)(target, collectionOptions)
+          ),
+          {
+            ...createCursorOutputContext(cursor, format, limit),
+            continuationKind: "collection"
+          },
+          format
+        );
+        return;
+      }
       await writeFindHits(
         createCollectionFindResult(
           await (0, import_wiki_graph_core35.listWikiGraphLibraryObjects)(target, collectionOptions)
@@ -4246,6 +4261,18 @@ async function runNextLibraryIndexPage(args, cursor) {
           types: cursor.types
         });
       }
+      if (isLibraryArchiveMemberCursor(cursor)) {
+        await writeFindHits(
+          await (0, import_wiki_graph_core35.findWikiGraphLibraryArchiveMembers)(
+            target,
+            cursor.query ?? "",
+            findOptions
+          ),
+          createCursorOutputContext(cursor, format, limit),
+          format
+        );
+        return;
+      }
       await writeFindHits(
         await (0, import_wiki_graph_core35.findWikiGraphLibraryObjects)(
           target,
@@ -4301,6 +4328,10 @@ async function runNextLibraryIndexPage(args, cursor) {
       return;
   }
 }
+function isLibraryArchiveMemberCursor(cursor) {
+  const target = (0, import_wiki_graph_core35.parseWikiGraphLibraryUri)(cursor.archivePath);
+  return target?.kind === "scope" && target.objectUri === void 0 && cursor.archiveKey === cursor.archivePath;
+}
 function createCursorOutputContext(cursor, format, limit) {
   return {
     archiveKey: cursor.archiveKey,
@@ -4439,7 +4470,7 @@ __export(archive_command_exports, {
 });
 async function runArchiveCommand(args) {
   const libraryTarget = (0, import_wiki_graph_core38.parseWikiGraphLibraryUri)(args.archivePath);
-  if (libraryTarget?.kind === "scope" && libraryTarget.objectUri !== "wikg://index" && (libraryTarget.objectUri !== void 0 || args.action === "search" || args.action === "list")) {
+  if (libraryTarget?.kind === "scope" && libraryTarget.objectUri !== "wikg://index" && (libraryTarget.objectUri !== void 0 || args.action === "related" || args.action === "evidence" || args.action === "pack" || args.action === "search" || args.action === "list")) {
     await runLibraryIndexArchiveCommand(args, libraryTarget);
     return;
   }
@@ -4672,15 +4703,39 @@ async function runArchiveCommand(args) {
 }
 async function runLibraryIndexArchiveCommand(args, target) {
   const library = await (0, import_wiki_graph_core38.resolveWikiGraphLibrary)(target);
-  const objectUri = target.objectUri === void 0 && args.objectId === void 0 ? "wikg://" : getObjectUri(args.objectId ?? args.archivePath);
+  const isLibraryRootCollection = target.objectUri === void 0 && args.objectId === void 0;
+  const objectUri = isLibraryRootCollection ? void 0 : getObjectUri(args.objectId ?? args.archivePath);
   const context = {
     ...createArchiveOutputContext(args),
-    archiveKey: args.archivePath,
+    archiveKey: isLibraryRootCollection ? `${(0, import_wiki_graph_core38.formatWikiGraphLibraryUri)(target.publicId)}#scope` : args.archivePath,
     archivePath: args.archivePath,
     indexScope: { kind: "library-index", libraryId: library.id }
   };
   switch (args.action) {
     case "search":
+      if (objectUri === void 0) {
+        if (args.all === true) {
+          await writeAllFindHits(
+            async (cursor) => await (0, import_wiki_graph_core38.findWikiGraphLibraryObjects)(target, args.query, {
+              ...createFindOptions(args),
+              ...cursor === void 0 ? {} : { cursor }
+            }),
+            context,
+            args.format ?? "text"
+          );
+          return;
+        }
+        await writeFindHits(
+          await (0, import_wiki_graph_core38.findWikiGraphLibraryObjects)(
+            target,
+            args.query,
+            createFindOptions(args)
+          ),
+          context,
+          args.format ?? "text"
+        );
+        return;
+      }
       if (args.all === true) {
         await writeAllFindHits(
           async (cursor) => await (0, import_wiki_graph_core38.findWikiGraphLibraryObjects)(target, args.query, {
@@ -4707,6 +4762,45 @@ async function runLibraryIndexArchiveCommand(args, target) {
         ...context,
         continuationKind: "collection"
       };
+      if (objectUri === void 0) {
+        if (args.all === true) {
+          if (args.limit !== void 0) {
+            await writeAllFindHits(
+              async (cursor) => createCollectionFindResult(
+                await (0, import_wiki_graph_core38.listWikiGraphLibraryObjects)(target, {
+                  ...createCollectionOptions(args),
+                  ...cursor === void 0 ? {} : { cursor }
+                })
+              ),
+              listContext,
+              args.format ?? "text"
+            );
+            return;
+          }
+          await writeFindHitsWithoutContinuation(
+            createCollectionFindResult(
+              await (0, import_wiki_graph_core38.listWikiGraphLibraryObjects)(target, {
+                ...createCollectionOptions(args),
+                limit: ALL_COLLECTION_OUTPUT_LIMIT
+              })
+            ),
+            listContext,
+            args.format ?? "text"
+          );
+          return;
+        }
+        await writeFindHits(
+          createCollectionFindResult(
+            await (0, import_wiki_graph_core38.listWikiGraphLibraryObjects)(
+              target,
+              createCollectionOptions(args)
+            )
+          ),
+          listContext,
+          args.format ?? "text"
+        );
+        return;
+      }
       if (args.all === true) {
         if (args.limit !== void 0) {
           await writeAllFindHits(
@@ -4746,6 +4840,23 @@ async function runLibraryIndexArchiveCommand(args, target) {
       return;
     }
     case "get": {
+      if (objectUri === void 0) {
+        const getContext = {
+          ...context,
+          continuationKind: "collection"
+        };
+        await writeFindHits(
+          createCollectionFindResult(
+            await (0, import_wiki_graph_core38.listWikiGraphLibraryObjects)(
+              target,
+              createCollectionOptions(args)
+            )
+          ),
+          getContext,
+          args.format ?? "text"
+        );
+        return;
+      }
       const evidenceLimit = getSingleObjectEvidenceLimit(args, objectUri);
       await writePage(
         await (0, import_wiki_graph_core38.readWikiGraphLibraryPage)(target, objectUri, {
@@ -4760,12 +4871,13 @@ async function runLibraryIndexArchiveCommand(args, target) {
       return;
     }
     case "related": {
+      const concreteObjectUri = requireLibraryObjectUri("related", objectUri);
       const relatedContext = {
         ...context,
         continuationKind: "related",
-        targetUri: objectUri
+        targetUri: concreteObjectUri
       };
-      const readPage = async (cursor) => await (0, import_wiki_graph_core38.listRelatedWikiGraphLibraryObjects)(target, objectUri, {
+      const readPage = async (cursor) => await (0, import_wiki_graph_core38.listRelatedWikiGraphLibraryObjects)(target, concreteObjectUri, {
         ...cursor === void 0 ? {} : { cursor },
         ...createOptionalEvidenceLimit(args),
         ...args.limit === void 0 ? {} : { limit: args.limit },
@@ -4791,14 +4903,15 @@ async function runLibraryIndexArchiveCommand(args, target) {
       return;
     }
     case "evidence": {
+      const concreteObjectUri = requireLibraryObjectUri("evidence", objectUri);
       const evidenceContext = {
         ...context,
         continuationKind: "evidence",
-        targetUri: objectUri
+        targetUri: concreteObjectUri
       };
       if (args.all === true) {
         await writeAllEvidence(
-          async (cursor) => await (0, import_wiki_graph_core38.listWikiGraphLibraryEvidence)(target, objectUri, {
+          async (cursor) => await (0, import_wiki_graph_core38.listWikiGraphLibraryEvidence)(target, concreteObjectUri, {
             ...cursor === void 0 ? {} : { cursor },
             ...args.limit === void 0 ? {} : { limit: args.limit },
             ...args.reverse === true ? { order: "doc-desc" } : {},
@@ -4811,7 +4924,7 @@ async function runLibraryIndexArchiveCommand(args, target) {
         return;
       }
       await writeEvidence(
-        await (0, import_wiki_graph_core38.listWikiGraphLibraryEvidence)(target, objectUri, {
+        await (0, import_wiki_graph_core38.listWikiGraphLibraryEvidence)(target, concreteObjectUri, {
           ...args.cursor === void 0 ? {} : { cursor: args.cursor },
           ...args.limit === void 0 ? {} : { limit: args.limit },
           ...args.reverse === true ? { order: "doc-desc" } : {},
@@ -4823,17 +4936,19 @@ async function runLibraryIndexArchiveCommand(args, target) {
       );
       return;
     }
-    case "pack":
+    case "pack": {
+      const concreteObjectUri = requireLibraryObjectUri("pack", objectUri);
       await writePack(
         await (0, import_wiki_graph_core38.packWikiGraphLibraryContext)(
           target,
-          objectUri,
+          concreteObjectUri,
           args.budget ?? 5e3
         ),
         context,
         args.format ?? "text"
       );
       return;
+    }
     case "create":
     case "export":
     case "inspect":
@@ -4843,6 +4958,14 @@ async function runLibraryIndexArchiveCommand(args, target) {
       );
   }
 }
+function requireLibraryObjectUri(action, objectUri) {
+  if (objectUri === void 0) {
+    throw new Error(
+      `The library \`${action}\` predicate requires a concrete library object URI.`
+    );
+  }
+  return objectUri;
+}
 var import_wiki_graph_core38;
 var init_archive_command = __esm({
   "src/commands/archive-command/index.ts"() {
@@ -6182,13 +6305,13 @@ async function runLibraryCommand(args) {
         return;
       }
       if (args.target.kind === "archive-collection") {
-        await writeEmptyLibraryScope(args.json ?? false);
+        await writeLibraryArchives(
+          await (0, import_wiki_graph_core48.listWikiGraphLibraryArchives)(args.target),
+          args.json ?? false
+        );
         return;
       }
-      await writeLibraryArchives(
-        await (0, import_wiki_graph_core48.listWikiGraphLibraryArchives)(args.target),
-        args.json ?? false
-      );
+      await writeLibraryScopeCollection(args.target, args.json ?? false);
       return;
     }
     case "scan": {
@@ -6318,15 +6441,20 @@ async function runLibraryCommand(args) {
         return;
       }
       if (args.target.kind === "archive") {
-        await writeLibraryArchive(
+        await writeLibraryArchivePage(
           await (0, import_wiki_graph_core48.getWikiGraphLibraryArchive)(args.target),
-          args.json ?? false,
-          "Library archive"
+          args.json ?? false
+        );
+        return;
+      }
+      if (args.target.kind === "archive-collection") {
+        await writeLibraryArchives(
+          await (0, import_wiki_graph_core48.listWikiGraphLibraryArchives)(args.target),
+          args.json ?? false
         );
         return;
       }
-      await (0, import_wiki_graph_core48.resolveWikiGraphLibrary)(args.target);
-      await writeEmptyLibraryScope(args.json ?? false);
+      await writeLibraryScopeCollection(args.target, args.json ?? false);
       return;
     }
     case "set": {
@@ -6499,8 +6627,23 @@ async function writeLibraryArchives(archives, json) {
     ).join("\n") + (archives.length === 0 ? "" : "\n")
   );
 }
-async function writeEmptyLibraryScope(json) {
-  await writeTextToStdout(json ? formatCLIJSON({ items: [] }) : "");
+async function writeLibraryScopeCollection(target, json) {
+  const library = await (0, import_wiki_graph_core48.resolveWikiGraphLibrary)(target);
+  const baseUri = (0, import_wiki_graph_core48.formatWikiGraphLibraryUri)(target.publicId);
+  const context = {
+    archiveKey: `${baseUri}#scope`,
+    archivePath: baseUri,
+    continuationKind: "collection",
+    format: json ? "json" : "text",
+    indexScope: { kind: "library-index", libraryId: library.id },
+    limit: 20,
+    types: null
+  };
+  await writeFindHits(
+    createCollectionFindResult(await (0, import_wiki_graph_core48.listWikiGraphLibraryObjects)(target)),
+    context,
+    json ? "json" : "text"
+  );
 }
 async function writeLibraryArchive(archive, json, label = "Added library archive") {
   if (json) {
@@ -6513,6 +6656,27 @@ ${archive.relativePath}
 `
   );
 }
+async function writeLibraryArchivePage(archive, json) {
+  if (json) {
+    await writeTextToStdout(
+      formatCLIJSON(formatLibraryArchivePageJSON(archive))
+    );
+    return;
+  }
+  await writeTextToStdout(
+    [
+      `Library archive: ${archive.uri}`,
+      `Label: ${archive.relativePath}`,
+      `Status: ${archive.status}${archive.exists ? "" : " (missing file)"}`,
+      `Chapter: ${archive.uri}/chapter`,
+      `Entity: ${archive.uri}/entity`,
+      `Triple: ${archive.uri}/triple`,
+      `Inspect: ${archive.uri} inspect`,
+      `Metadata path: ${archive.path}`,
+      ""
+    ].join("\n")
+  );
+}
 function formatLibraryArchiveJSON(archive) {
   return {
     uri: archive.uri,
@@ -6530,6 +6694,32 @@ function formatLibraryArchiveJSON(archive) {
     updatedAt: archive.updatedAt
   };
 }
+function formatLibraryArchivePageJSON(archive) {
+  return {
+    uri: archive.uri,
+    id: archive.publicId,
+    libraryUri: archive.libraryUri,
+    label: archive.relativePath,
+    relativePath: archive.relativePath,
+    status: archive.status,
+    entries: {
+      chapter: `${archive.uri}/chapter`,
+      entity: `${archive.uri}/entity`,
+      triple: `${archive.uri}/triple`,
+      inspect: `${archive.uri} inspect`
+    },
+    metadata: {
+      path: archive.path,
+      exists: archive.exists,
+      lastSeenMutationToken: archive.lastSeenMutationToken,
+      lastSeenSize: archive.lastSeenSize,
+      lastSeenMtimeMs: archive.lastSeenMtimeMs,
+      lastScannedAt: archive.lastScannedAt,
+      createdAt: archive.createdAt,
+      updatedAt: archive.updatedAt
+    }
+  };
+}
 async function writeLibraryArchiveTree(archives, options) {
   const parent = options.parent?.replace(/\\/gu, "/").replace(/^\/+|\/+$/gu, "");
   const root = { children: /* @__PURE__ */ new Map(), name: "", path: "" };
@@ -6707,6 +6897,8 @@ var init_library = __esm({
     import_promises6 = require("fs/promises");
     import_wiki_graph_core48 = require("wiki-graph-core");
     init_support();
+    init_run();
+    init_archive_output();
     init_runtime();
     INDEX_PROGRESS_OUTPUT_INTERVAL_MS2 = 6e3;
   }
@@ -12193,7 +12385,7 @@ function parseLibraryUriFirstArguments(positionals, values) {
   if (target === void 0) {
     throw new Error(`Expected a Wiki Graph library URI: ${uri}`);
   }
-  const action = explicitAction ?? (target.kind === "scope" && (target.objectUri !== void 0 && target.objectUri !== "wikg://index" || values.query !== void 0) ? resolveImplicitLibraryQueryAction(target.objectUri, values.query) : target.kind === "scope" || target.kind === "archive-collection" || target.kind === "metadata" || target.kind === "path" || target.kind === "archive" || target.kind === "archive-path" || target.objectUri === "wikg://index" ? "get" : target.kind === "archive-tree" ? "archive-tree" : "list");
+  const action = explicitAction ?? (target.kind === "scope" && (target.objectUri !== void 0 && target.objectUri !== "wikg://index" || values.query !== void 0 || values.limit !== void 0 || values.cursor !== void 0) ? resolveImplicitLibraryQueryAction(target.objectUri, values.query) : target.kind === "scope" || target.kind === "archive-collection" || target.kind === "metadata" || target.kind === "path" || target.kind === "archive" || target.kind === "archive-path" || target.objectUri === "wikg://index" ? "get" : target.kind === "archive-tree" ? "archive-tree" : "list");
   if (action === "inspect" && target.kind !== "archive") {
     throw new Error(
       withHelpRoute(
@@ -12264,7 +12456,7 @@ function parseLibraryUriFirstArguments(positionals, values) {
       values
     );
   }
-  if (target.kind === "scope" && (target.objectUri !== void 0 || action === "search")) {
+  if (target.kind === "scope" && (target.objectUri !== void 0 || action === "related" || action === "evidence" || action === "pack" || action === "search" || action === "list" && explicitAction === void 0)) {
     return parseLibraryQueryArguments(
       uri,
       target,
@@ -12499,7 +12691,12 @@ function parseLibraryQueryArguments(uri, target, action, tail, values) {
     );
   }
   if (target.objectUri === void 0 && action !== "search" && action !== "list") {
-    throw new Error("Internal error: missing library query object URI.");
+    throw new Error(
+      withHelpRoute(
+        formatMissingLibraryQueryObjectUriMessage(action),
+        formatWikiGraphHelpCommand(uri, action)
+      )
+    );
   }
   const parsed = parseArchiveArguments(
     action,
@@ -12510,7 +12707,8 @@ function parseLibraryQueryArguments(uri, target, action, tail, values) {
     values,
     formatWikiGraphHelpCommand(uri, action),
     {
-      ...optionalDefaultKinds(getLibraryQueryDefaultKinds(target.objectUri))
+      ...optionalDefaultKinds(getLibraryQueryDefaultKinds(target.objectUri)),
+      ...optionalTriplePattern(getLibraryQueryTriplePattern(target.objectUri))
     }
   );
   if (parsed.kind !== "archive") {
@@ -12527,9 +12725,15 @@ function parseLibraryQueryArguments(uri, target, action, tail, values) {
     }
   };
 }
+function formatMissingLibraryQueryObjectUriMessage(action) {
+  return `The library \`${action}\` predicate requires a concrete library object URI.`;
+}
 function optionalDefaultKinds(defaultKinds) {
   return defaultKinds === void 0 ? {} : { defaultKinds };
 }
+function optionalTriplePattern(triplePattern) {
+  return triplePattern === void 0 ? {} : { triplePattern };
+}
 function optionalObjectId(objectId) {
   return objectId === void 0 ? {} : { objectId };
 }
@@ -12541,6 +12745,25 @@ function getLibraryQueryDefaultKinds(objectUri) {
   if (objectUri === void 0) {
     return void 0;
   }
+  const chapterTarget = parseChapterTarget(objectUri);
+  if (chapterTarget !== void 0) {
+    switch (chapterTarget.kind) {
+      case "collection":
+      case "chapter":
+        return ["chapter"];
+      case "lens":
+      case "chapter-lens":
+        return [chapterTarget.lens];
+      case "triple-pattern-lens":
+      case "chapter-triple-pattern-lens":
+        return ["triple"];
+      case "chapter-resource":
+        return chapterTarget.resource === "title" ? void 0 : [chapterTarget.resource];
+      case "chapter-state":
+      case "tree":
+        return void 0;
+    }
+  }
   const path = stripObjectUriPrefix(objectUri);
   const [head] = path.split("/");
   switch (head) {
@@ -12560,16 +12783,51 @@ function getLibraryQueryDefaultKinds(objectUri) {
       return void 0;
   }
 }
+function getLibraryQueryTriplePattern(objectUri) {
+  if (objectUri === void 0) {
+    return void 0;
+  }
+  const chapterTarget = parseChapterTarget(objectUri);
+  if (chapterTarget === void 0) {
+    return void 0;
+  }
+  switch (chapterTarget.kind) {
+    case "triple-pattern-lens":
+    case "chapter-triple-pattern-lens":
+      return chapterTarget.pattern;
+    default:
+      return void 0;
+  }
+}
 function resolveImplicitLibraryQueryAction(objectUri, query) {
   if (objectUri === void 0) {
     return query === void 0 ? "list" : "search";
   }
-  const path = stripObjectUriPrefix(objectUri);
-  if (/^(?:chapter|chunk|entity|source|summary|triple)$/u.test(path)) {
+  if (isLibraryScopeObjectUri(objectUri)) {
     return query === void 0 ? "list" : "search";
   }
   return "get";
 }
+function isLibraryScopeObjectUri(objectUri) {
+  const chapterTarget = parseChapterTarget(objectUri);
+  if (chapterTarget !== void 0) {
+    switch (chapterTarget.kind) {
+      case "collection":
+      case "chapter":
+      case "lens":
+      case "triple-pattern-lens":
+      case "chapter-lens":
+      case "chapter-triple-pattern-lens":
+        return true;
+      case "chapter-resource":
+      case "chapter-state":
+      case "tree":
+        return false;
+    }
+  }
+  const path = stripObjectUriPrefix(objectUri);
+  return /^(?:chunk|entity|source|summary|triple)$/u.test(path) ? true : isTripleScopePath(path);
+}
 function parseLibraryRegistryArguments(uri, target, action, tail, values) {
   const helpRoute = formatWikiGraphHelpCommand(uri, action);
   if (!LIBRARY_REGISTRY_ACTIONS.has(action)) {