wiki-graph 0.8.0 → 0.8.1

package/dist/index.cjs

@@ -45,6 +45,7 @@ async function withWikiGraphCLIRuntimeContext(context, operation) {
         cwd: context.cwd,
         env: context.env,
         envPolicy: context.envPolicy,
+        providers: {},
         ...context.stateDir === void 0 ? {} : { stateDir: context.stateDir }
       },
       operation
@@ -1953,7 +1954,7 @@ function toWikiGraphUri(id) {
     case "fragment":
       return `wikg://chapter/${first ?? ""}/source/${second ?? "0"}`;
     case "meta":
-      return "wikg://";
+      return "wikg://meta";
     case "node":
       return `wikg://chunk/${first ?? ""}`;
     case "summary":
@@ -2247,6 +2248,14 @@ function createObjectResultPage(objects, nextCursor, limit, warnings = []) {
 async function createFindObject(hit, context) {
   const uri = toWikiGraphUri(hit.id);
   const librarySource = createLibrarySourceObject(hit);
+  if (hit.type === "archive-title") {
+    return {
+      ...librarySource,
+      title: hit.title,
+      type: "archive-title",
+      uri
+    };
+  }
   if (hit.type === "chapter") {
     return {
       ...librarySource,
@@ -2394,6 +2403,13 @@ async function createPageObject(page, context) {
         uri: toWikiGraphUri(page.id)
       };
     }
+    case "archive-title":
+      return {
+        ...librarySource,
+        title: page.title,
+        type: "archive-title",
+        uri: toWikiGraphUri(page.id)
+      };
     case "chapter-title":
       return {
         ...librarySource,
@@ -2583,6 +2599,7 @@ async function formatPackAnchor(anchor, context) {
   switch (anchor.type) {
     case "artifact":
       return formatPlainObject(await createPageObject(anchor, context));
+    case "archive-title":
     case "chapter-title":
     case "chapter":
       return formatPlainObject(await createPageObject(anchor, context));
@@ -3117,6 +3134,7 @@ async function writePage(page, context, format) {
 `
       );
       return;
+    case "archive-title":
     case "chapter-title":
       await writeTextToStdout(
         `${formatPlainObject(await createPageObject(page, context))}
@@ -3346,7 +3364,8 @@ function resolveArchiveCommandRuntimeArguments(args) {
 }
 function getArchivePath(uri) {
   if (!uri.includes("://")) return uri;
-  if ((0, import_wiki_graph_sdk22.parseWikiGraphLibraryUri)(uri)?.kind === "scope") {
+  const libraryTarget = (0, import_wiki_graph_sdk22.parseWikiGraphLibraryUri)(uri);
+  if (libraryTarget?.kind === "scope" || libraryTarget?.kind === "archive-collection") {
     return uri;
   }
   const archivePath = parseLocatedWikiGraphUri(uri).archivePath;
@@ -3356,7 +3375,8 @@ function getArchivePath(uri) {
   return archivePath;
 }
 function getArchiveIndexScope(uri) {
-  if ((0, import_wiki_graph_sdk22.parseWikiGraphLibraryUri)(uri)?.kind === "scope") {
+  const libraryTarget = (0, import_wiki_graph_sdk22.parseWikiGraphLibraryUri)(uri);
+  if (libraryTarget?.kind === "scope" || libraryTarget?.kind === "archive-collection") {
     return { kind: "library-index", libraryId: -1 };
   }
   const archivePath = getArchivePath(uri);
@@ -3403,6 +3423,7 @@ function createFindOptions(args) {
     ...createOptionalEvidenceLimit(args),
     ...args.limit === void 0 ? {} : { limit: args.limit },
     ...args.reverse === true ? { order: "doc-desc" } : {},
+    ...args.queryMode === void 0 ? {} : { queryMode: args.queryMode },
     ...args.skipUnindexed === true ? { skipUnindexed: true } : {},
     ...createOptionalSourceContext(args),
     ...args.triplePattern === void 0 ? {} : { triplePattern: args.triplePattern },
@@ -3424,6 +3445,7 @@ function createArchiveOutputContext(args, options = {}) {
     ...args.reverse === true ? { order: "doc-desc" } : {},
     ...args.action !== "evidence" && args.action !== "related" && args.action !== "search" ? {} : args.query === void 0 ? {} : { query: args.query },
     ...args.role === void 0 ? {} : { role: args.role },
+    ...args.queryMode === void 0 ? {} : { queryMode: args.queryMode },
     ...args.skipUnindexed === true ? { skipUnindexed: true } : {},
     ...options.continuationKind === "collection" ? createScopeOptions(args) : {},
     ...args.triplePattern === void 0 ? {} : { triplePattern: args.triplePattern },
@@ -3616,6 +3638,7 @@ function createCursorOutputContext(cursor, format, limit) {
       targetUri: cursor.targetUri
     } : {},
     ...cursor.kind === "related" && cursor.role !== void 0 ? { role: cursor.role } : {},
+    ...(cursor.kind === "search" || cursor.kind === "evidence" || cursor.kind === "related") && cursor.queryMode !== void 0 ? { queryMode: cursor.queryMode } : {},
     ...cursor.kind === "source-locators" ? { targetUri: cursor.targetUri } : {},
     ..."evidenceLimit" in cursor && cursor.evidenceLimit !== void 0 ? { evidenceLimit: cursor.evidenceLimit } : {},
     ..."sourceContext" in cursor && cursor.sourceContext !== void 0 ? { sourceContext: cursor.sourceContext } : {}
@@ -3671,7 +3694,7 @@ __export(archive_command_exports, {
 });
 async function runArchiveCommand(args) {
   const libraryTarget = (0, import_wiki_graph_sdk25.parseWikiGraphLibraryUri)(args.archivePath);
-  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")) {
+  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") || libraryTarget?.kind === "archive-collection" && args.action === "search") {
     await runLibraryIndexArchiveCommand(args, libraryTarget);
     return;
   }
@@ -3870,6 +3893,7 @@ async function runArchiveRelated(args) {
     ...args.limit === void 0 ? {} : { limit: args.limit },
     ...args.reverse === true ? { order: "doc-desc" } : {},
     ...args.query === void 0 ? {} : { query: args.query },
+    ...args.queryMode === void 0 ? {} : { queryMode: args.queryMode },
     ...args.role === void 0 ? {} : { role: args.role },
     ...args.skipUnindexed === true ? { skipUnindexed: true } : {},
     ...createOptionalSourceContext(args)
@@ -3903,6 +3927,7 @@ async function runArchiveEvidence(args) {
     ...args.limit === void 0 ? {} : { limit: args.limit },
     ...args.reverse === true ? { order: "doc-desc" } : {},
     ...args.query === void 0 ? {} : { query: args.query },
+    ...args.queryMode === void 0 ? {} : { queryMode: args.queryMode },
     ...args.skipUnindexed === true ? { skipUnindexed: true } : {},
     ...createOptionalSourceContext(args)
   });
@@ -3950,8 +3975,9 @@ async function runLibraryIndexArchiveCommand(args, target) {
   const library = await libraries.get(
     (0, import_wiki_graph_sdk25.formatWikiGraphLibraryUri)(target.publicId)
   );
-  const isLibraryRootCollection = target.objectUri === void 0 && args.objectId === void 0;
-  const objectUri = isLibraryRootCollection ? void 0 : getObjectUri(args.objectId ?? args.archivePath);
+  const isArchiveMemberCollection = target.kind === "archive-collection";
+  const isLibraryRootCollection = !isArchiveMemberCollection && target.objectUri === void 0 && args.objectId === void 0;
+  const objectUri = isLibraryRootCollection ? void 0 : isArchiveMemberCollection ? void 0 : getObjectUri(args.objectId ?? args.archivePath);
   const context = {
     ...createArchiveOutputContext(args),
     archiveKey: args.archivePath,
@@ -3960,25 +3986,25 @@ async function runLibraryIndexArchiveCommand(args, target) {
       kind: "library-index",
       libraryId: library.snapshot.id
     },
-    libraryQuery: "objects"
+    libraryQuery: isArchiveMemberCollection ? "archive-members" : "objects"
   };
   switch (args.action) {
     case "search": {
       const findOptions = createSearchFindOptions(args);
       if (objectUri === void 0) {
+        const search = async (cursor) => await (isArchiveMemberCollection ? libraries.searchArchiveMembers(target, args.query, {
+          ...findOptions,
+          ...cursor === void 0 ? {} : { cursor }
+        }) : libraries.search(target, args.query, {
+          ...findOptions,
+          ...cursor === void 0 ? {} : { cursor }
+        }));
         if (args.all === true) {
-          await writeAllFindHits(
-            async (cursor) => await libraries.search(target, args.query, {
-              ...findOptions,
-              ...cursor === void 0 ? {} : { cursor }
-            }),
-            context,
-            args.format ?? "text"
-          );
+          await writeAllFindHits(search, context, args.format ?? "text");
           return;
         }
         await writeFindHits(
-          await libraries.search(target, args.query, findOptions),
+          await search(args.cursor),
           context,
           args.format ?? "text"
         );
@@ -4119,6 +4145,7 @@ async function runLibraryIndexArchiveCommand(args, target) {
         ...args.limit === void 0 ? {} : { limit: args.limit },
         ...args.reverse === true ? { order: "doc-desc" } : {},
         ...args.query === void 0 ? {} : { query: args.query },
+        ...args.queryMode === void 0 ? {} : { queryMode: args.queryMode },
         ...args.role === void 0 ? {} : { role: args.role },
         ...args.skipUnindexed === true ? { skipUnindexed: true } : {},
         ...createOptionalSourceContext(args)
@@ -4153,6 +4180,7 @@ async function runLibraryIndexArchiveCommand(args, target) {
             ...args.limit === void 0 ? {} : { limit: args.limit },
             ...args.reverse === true ? { order: "doc-desc" } : {},
             ...args.query === void 0 ? {} : { query: args.query },
+            ...args.queryMode === void 0 ? {} : { queryMode: args.queryMode },
             ...args.skipUnindexed === true ? { skipUnindexed: true } : {},
             ...createOptionalSourceContext(args)
           }),
@@ -4168,6 +4196,7 @@ async function runLibraryIndexArchiveCommand(args, target) {
           ...args.limit === void 0 ? {} : { limit: args.limit },
           ...args.reverse === true ? { order: "doc-desc" } : {},
           ...args.query === void 0 ? {} : { query: args.query },
+          ...args.queryMode === void 0 ? {} : { queryMode: args.queryMode },
           ...args.skipUnindexed === true ? { skipUnindexed: true } : {},
           ...createOptionalSourceContext(args)
         }),
@@ -4221,6 +4250,37 @@ var init_archive_command = __esm({
   }
 });
 
+// src/commands/archive-title.ts
+var archive_title_exports = {};
+__export(archive_title_exports, {
+  runArchiveTitleCommand: () => runArchiveTitleCommand
+});
+async function runArchiveTitleCommand(args) {
+  const archive = await getWikiGraphSDK().archives.open(
+    parseCLIArchiveTarget(args.archivePath)
+  );
+  if (args.action === "clear") {
+    await archive.setArchiveTitle(null);
+    await writeTextToStdout("Cleared archive title.\n");
+    return;
+  }
+  const title = args.title;
+  if (title === void 0) {
+    throw new Error("Missing archive title.");
+  }
+  const stored = await archive.setArchiveTitle(title);
+  await writeTextToStdout(`${stored}
+`);
+}
+var init_archive_title = __esm({
+  "src/commands/archive-title.ts"() {
+    "use strict";
+    init_context();
+    init_archive_target();
+    init_support();
+  }
+});
+
 // src/runtime/entry-context.ts
 var entry_context_exports = {};
 var init_entry_context = __esm({
@@ -7315,6 +7375,7 @@ var URI_HELP_TARGETS = [
     name: "archive-scope",
     predicates: ["create", "export", "inspect"]
   },
+  { name: "archive-title-object", predicates: ["clear", "set"] },
   { name: "artifact-object", predicates: [] },
   {
     name: "chapter-collection-scope",
@@ -9110,6 +9171,7 @@ function parseArchiveArguments(action, positionals, values, helpRoute = `wg ${ac
     );
   }
   rejectNonQuerySkipUnindexedFlag(action, values, helpRoute);
+  const queryMode = parseQueryModeFlag(values, helpRoute);
   switch (action) {
     case "create": {
       rejectArchiveExtraPositionals(action, positionals, 1, helpRoute);
@@ -9287,6 +9349,7 @@ function parseArchiveArguments(action, positionals, values, helpRoute = `wg ${ac
             )
           },
           query,
+          ...queryMode,
           ...values["skip-unindexed"] === true ? { skipUnindexed: true } : {},
           ...options.defaultKinds === void 0 ? {} : { kinds: options.defaultKinds },
           ...options.triplePattern === void 0 ? {} : { triplePattern: options.triplePattern }
@@ -9407,6 +9470,7 @@ function parseArchiveArguments(action, positionals, values, helpRoute = `wg ${ac
           },
           objectId: archivePath,
           ...values.query === void 0 ? {} : { query: values.query },
+          ...queryMode,
           ...values.reverse === true ? { reverse: true } : {},
           ...values["skip-unindexed"] === true ? { skipUnindexed: true } : {},
           ...relatedTarget === "entity" ? parseRelatedRoleFlag(values.role, helpRoute) : {}
@@ -9451,6 +9515,7 @@ function parseArchiveArguments(action, positionals, values, helpRoute = `wg ${ac
           },
           objectId: archivePath,
           ...values.query === void 0 ? {} : { query: values.query },
+          ...queryMode,
           ...values.reverse === true ? { reverse: true } : {},
           ...values["skip-unindexed"] === true ? { skipUnindexed: true } : {}
         },
@@ -9549,6 +9614,24 @@ function rejectNonQuerySkipUnindexedFlag(action, values, helpRoute) {
     helpRoute
   );
 }
+function parseQueryModeFlag(values, helpRoute) {
+  const value = values["query-mode"];
+  if (value === void 0) return {};
+  if (values.query === void 0) {
+    throw new Error(
+      withHelpRoute("`--query-mode` requires `--query`.", helpRoute)
+    );
+  }
+  if (value !== "hybrid" && value !== "fts" && value !== "embedding") {
+    throw new Error(
+      withHelpRoute(
+        "--query-mode must be one of: hybrid, fts, embedding.",
+        helpRoute
+      )
+    );
+  }
+  return { queryMode: value };
+}
 
 // src/args/parse.ts
 var import_util = require("util");
@@ -10436,6 +10519,9 @@ function classifyArchiveUriHelpTarget(uri) {
   if (path === "index") {
     return "index-object";
   }
+  if (path === "title") {
+    return "archive-title-object";
+  }
   if (/^artifact\/[0-9a-f]{12,64}(?:#.+)?$/iu.test(path)) {
     return "artifact-object";
   }
@@ -10602,6 +10688,48 @@ function parseArchiveUriTargetArguments(uri, action, tail, values) {
   if (objectUri === "wikg://index") {
     return parseArchiveIndexUriArguments(archivePath, action, tail, values);
   }
+  if (objectUri === "wikg://title") {
+    if (action === "get") {
+      return parseArchiveArguments("get", [uri, ...tail], values, helpRoute);
+    }
+    if (action !== "set" && action !== "clear") {
+      throw new Error(
+        withHelpRoute(
+          `The archive title resource does not support \`${action}\`. Read it directly, or use set or clear.`,
+          "wg <archive-uri>/title --help"
+        )
+      );
+    }
+    const expected = action === "set" ? 1 : 0;
+    if (tail.length !== expected) {
+      throw new Error(
+        withHelpRoute(
+          action === "set" ? "Archive title set requires exactly one title value." : "Archive title clear does not accept a value.",
+          helpRoute
+        )
+      );
+    }
+    const unsupported = Object.entries(values).find(
+      ([key, value]) => key !== "help" && value !== void 0 && value !== false
+    );
+    if (unsupported !== void 0) {
+      throw new Error(
+        withHelpRoute(
+          `Archive title ${action} does not support --${unsupported[0]}.`,
+          helpRoute
+        )
+      );
+    }
+    return {
+      args: {
+        action,
+        archivePath,
+        ...tail[0] === void 0 ? {} : { title: tail[0] }
+      },
+      help: false,
+      kind: "archive-title"
+    };
+  }
   const chapterTarget = parseChapterTarget(objectUri);
   if (chapterTarget !== void 0) {
     return parseArchiveChapterUriArguments(
@@ -11530,7 +11658,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 || 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");
+  const action = explicitAction ?? ((target.kind === "scope" || target.kind === "archive-collection") && (target.kind === "scope" && target.objectUri !== void 0 && target.objectUri !== "wikg://index" || values.query !== void 0 || target.kind === "scope" && values.limit !== void 0 || target.kind === "scope" && 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(
@@ -11583,6 +11711,15 @@ function parseLibraryUriFirstArguments(positionals, values) {
       values
     );
   }
+  if (target.kind === "archive-collection" && (action === "search" || values.query !== void 0)) {
+    return parseLibraryQueryArguments(
+      uri,
+      target,
+      action,
+      explicitAction === void 0 ? [] : positionals.slice(2),
+      values
+    );
+  }
   if (target.kind === "archive-collection") {
     return parseLibraryArchiveCollectionArguments(
       uri,
@@ -12664,6 +12801,9 @@ function parseCLIArguments(argv = process.argv.slice(2)) {
       query: {
         type: "string"
       },
+      "query-mode": {
+        type: "string"
+      },
       replace: {
         type: "boolean"
       },
@@ -12851,6 +12991,10 @@ async function runArchiveCommand2(args) {
   const command = await Promise.resolve().then(() => (init_archive_command(), archive_command_exports));
   return command.runArchiveCommand(args);
 }
+async function runArchiveTitleCommand2(args) {
+  const command = await Promise.resolve().then(() => (init_archive_title(), archive_title_exports));
+  return command.runArchiveTitleCommand(args);
+}
 async function runArchiveChapterCommand2(args) {
   const command = await Promise.resolve().then(() => (init_chapter(), chapter_exports));
   return command.runArchiveChapterCommand(args);
@@ -12950,6 +13094,9 @@ async function dispatchWikiGraphCLI(input) {
       case "archive":
         await runArchiveCommand2(parsed.args);
         return { exitCode: 0 };
+      case "archive-title":
+        await runArchiveTitleCommand2(parsed.args);
+        return { exitCode: 0 };
       case "archive-index":
         await runArchiveIndexCommand2(parsed.args);
         return { exitCode: 0 };