wiki-graph 0.7.1 → 0.8.1

package/dist/index.js

@@ -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
@@ -556,6 +557,30 @@ var init_version = __esm({
   }
 });
 
+// src/support/archive-target.ts
+import {
+  parseLocatedWikiGraphUri as parseLocatedWikiGraphUri2
+} from "wiki-graph-sdk";
+function parseCLIArchiveTarget(locator) {
+  if (locator.startsWith("wikg://lib/")) {
+    return { kind: "library", uri: locator };
+  }
+  if (!locator.includes("://")) {
+    return { kind: "standalone", path: locator };
+  }
+  const parsed = parseLocatedWikiGraphUri2(locator);
+  return {
+    kind: "standalone",
+    path: parsed.archivePath ?? locator,
+    ...parsed.objectUri === void 0 ? {} : { objectUri: parsed.objectUri }
+  };
+}
+var init_archive_target = __esm({
+  "src/support/archive-target.ts"() {
+    "use strict";
+  }
+});
+
 // src/support/index.ts
 var init_support = __esm({
   "src/support/index.ts"() {
@@ -569,6 +594,7 @@ var init_support = __esm({
     init_uri();
     init_version();
     init_command();
+    init_archive_target();
   }
 });
 
@@ -1321,17 +1347,315 @@ var init_create = __esm({
 });
 
 // src/commands/archive-command/inspect.ts
+import {
+  createGenerationPerformanceHints,
+  DEFAULT_GENERATION_JOB_CONCURRENCY,
+  DEFAULT_GENERATION_REQUEST_CONCURRENCY,
+  formatGenerationPlanningModel,
+  loadWikiGraphRuntimeConfig as loadWikiGraphRuntimeConfig2,
+  planGenerationTask
+} from "wiki-graph-sdk";
 async function writeArchiveInspectReport(args) {
-  const archive = await getWikiGraphSDK().archives.open(args.archivePath);
+  const archive = await getWikiGraphSDK().archives.open(
+    parseCLIArchiveTarget(args.archivePath)
+  );
   const report = toCLIInspectReport(
-    await archive.inspect({
-      ...args.chapterId === void 0 ? {} : { chapterId: args.chapterId }
-    })
+    await createInspectReport(
+      await archive.inspect({
+        ...args.chapterId === void 0 ? {} : { chapterId: args.chapterId }
+      })
+    )
   );
   await writeTextToStdout(
     args.json === true ? formatCLIJSON(report) : formatArchiveInspectText(report)
   );
 }
+async function createInspectReport(inspection) {
+  const config = await loadWikiGraphRuntimeConfig2();
+  const chapters = inspection.chapters;
+  const contentChapters = chapters.filter(
+    ({ chapter }) => chapter.stage !== "planned"
+  );
+  const readingGraphCovered = contentChapters.filter(
+    ({ capabilities }) => capabilities.readingGraph.completed
+  );
+  const knowledgeGraphCovered = contentChapters.filter(
+    ({ capabilities }) => capabilities.knowledgeGraph.completed
+  );
+  const summaryCovered = contentChapters.filter(
+    ({ capabilities }) => capabilities.readingSummary.completed
+  );
+  const ftsArtifactCovered = contentChapters.filter(
+    ({ indexes }) => indexes.fts.current
+  );
+  const sourceEmbeddingArtifactCovered = contentChapters.filter(
+    ({ indexes }) => indexes.sourceEmbedding.current
+  );
+  const summaryEmbeddingArtifactCovered = contentChapters.filter(
+    ({ indexes }) => indexes.summaryEmbedding.current
+  );
+  const queryBlockedChapters = contentChapters.filter(
+    (chapter) => !ftsArtifactCovered.includes(chapter) && !sourceEmbeddingArtifactCovered.includes(chapter)
+  );
+  const queryReady = queryBlockedChapters.length === 0;
+  const concurrent = {
+    job: config.concurrent?.job ?? DEFAULT_GENERATION_JOB_CONCURRENCY,
+    request: config.concurrent?.request ?? DEFAULT_GENERATION_REQUEST_CONCURRENCY
+  };
+  const improvements = createInspectImprovements({
+    concurrent,
+    contentChapters,
+    indexCacheCurrent: inspection.localIndexCache.current,
+    knowledgeGraphCovered,
+    planningModel: formatGenerationPlanningModel(config.llm),
+    queryBlockedChapters,
+    readingGraphCovered,
+    summaryCovered
+  });
+  const performanceHints = createGenerationPerformanceHints({
+    chapters: Math.max(
+      0,
+      ...improvements.map((improvement) => improvement.missingChapters ?? 0)
+    ),
+    concurrent,
+    hasJobWork: improvements.some(
+      (improvement) => improvement.planning !== void 0
+    ),
+    hasRequestWork: improvements.some(
+      (improvement) => improvement.planning !== void 0
+    )
+  });
+  const sourceWords = sumWords(contentChapters);
+  const indexCacheCurrent = inspection.localIndexCache.current;
+  return {
+    archiveUri: inspection.archiveUri,
+    content: {
+      chapters: {
+        content: contentChapters.length,
+        planned: chapters.length - contentChapters.length,
+        total: chapters.length
+      },
+      sourceWords,
+      summaryWords: chapters.reduce(
+        (total, chapter) => total + chapter.summaryWords,
+        0
+      )
+    },
+    coverage: {
+      ftsIndexArtifact: createInspectCoverage(
+        ftsArtifactCovered,
+        contentChapters
+      ),
+      knowledgeGraph: createInspectCoverage(
+        knowledgeGraphCovered,
+        contentChapters
+      ),
+      readingGraph: createInspectCoverage(readingGraphCovered, contentChapters),
+      sourceEmbeddingIndexArtifact: createInspectCoverage(
+        sourceEmbeddingArtifactCovered,
+        contentChapters
+      ),
+      summary: createInspectCoverage(summaryCovered, contentChapters),
+      summaryEmbeddingIndexArtifact: createInspectCoverage(
+        summaryEmbeddingArtifactCovered,
+        contentChapters
+      )
+    },
+    improvements,
+    localIndexCache: {
+      current: indexCacheCurrent,
+      ...!queryReady ? {
+        blockedBy: "missing-search-artifacts",
+        impact: "The cache cannot be built until every content chapter has a current FTS or source embedding artifact."
+      } : indexCacheCurrent ? {} : {
+        impact: "The next archive query may need to sync index cache first.",
+        resource: "local CPU/disk time only; no provider calls."
+      },
+      status: !queryReady ? "blocked" : indexCacheCurrent ? "current" : "missing-or-outdated",
+      syncAvailable: queryReady && !indexCacheCurrent
+    },
+    performanceHints,
+    query: { ready: queryReady },
+    retrievalGuidance: formatRetrievalGuidance({
+      contentChapters,
+      indexCacheCurrent,
+      knowledgeGraphCovered,
+      queryReady,
+      readingGraphCovered,
+      sourceWords
+    }),
+    scope: inspection.scope,
+    searchArtifacts: {
+      blockedChapters: queryBlockedChapters.map(
+        (item) => createInspectChapterReference(inspection.archiveUri, item)
+      ),
+      ...!queryReady ? { resource: "local CPU/disk time only; no provider calls." } : {},
+      ready: queryReady,
+      status: queryReady ? "ready" : "incomplete"
+    },
+    summaryCoverageNote: "Summary coverage means a current summary artifact exists for the chapter; it does not guarantee that every source topic is represented in the summary text.",
+    uri: inspection.uri
+  };
+}
+function createInspectChapterReference(archiveUri, inspection) {
+  return {
+    chapterId: inspection.chapter.chapterId,
+    locatedUri: `${archiveUri.replace(/\/+$/u, "")}/${inspection.chapter.uri.replace(/^wikg:\/\//u, "")}`,
+    title: inspection.chapter.title,
+    uri: inspection.chapter.uri
+  };
+}
+function createInspectCoverage(covered, total) {
+  const coveredWords = sumWords(covered);
+  const totalWords = sumWords(total);
+  return {
+    coveredChapters: covered.length,
+    coveredWords,
+    percent: formatPercent(coveredWords, totalWords),
+    totalChapters: total.length,
+    totalWords
+  };
+}
+function createInspectImprovements(input) {
+  if (input.contentChapters.length === 0) {
+    return [
+      {
+        kind: "add-source",
+        recommendation: "No source content is available yet; add or import source text before graph or summary generation.",
+        title: "Add source content"
+      }
+    ];
+  }
+  const improvements = [];
+  if (input.queryBlockedChapters.length > 0) {
+    improvements.push({
+      kind: "build",
+      missingChapters: input.queryBlockedChapters.length,
+      missingWords: sumWords(input.queryBlockedChapters),
+      recommendation: "Build local FTS artifacts to make this scope queryable. This does not call a provider.",
+      task: "index-fts",
+      title: "Enable query with local FTS"
+    });
+  } else if (!input.indexCacheCurrent) {
+    improvements.push({
+      kind: "sync-index",
+      recommendation: "Sync the index cache from chapter index artifacts so query starts without a lazy cache rebuild.",
+      title: "Sync index cache"
+    });
+  }
+  improvements.push(
+    ...createGraphImprovement({
+      concurrent: input.concurrent,
+      covered: input.readingGraphCovered,
+      planningModel: input.planningModel,
+      task: "reading-graph",
+      title: "Complete Reading Graph coverage",
+      total: input.contentChapters
+    }),
+    ...createGraphImprovement({
+      concurrent: input.concurrent,
+      covered: input.knowledgeGraphCovered,
+      planningModel: input.planningModel,
+      task: "knowledge-graph",
+      title: "Complete Knowledge Graph coverage",
+      total: input.contentChapters
+    }),
+    ...createGraphImprovement({
+      concurrent: input.concurrent,
+      covered: input.summaryCovered,
+      planningModel: input.planningModel,
+      task: "reading-summary",
+      title: "Complete Summary coverage",
+      total: input.contentChapters
+    })
+  );
+  return improvements;
+}
+function createGraphImprovement(input) {
+  const coveredIds = new Set(
+    input.covered.map(({ chapter }) => chapter.chapterId)
+  );
+  const missing = input.total.filter(
+    ({ chapter }) => !coveredIds.has(chapter.chapterId)
+  );
+  if (missing.length === 0) return [];
+  const missingWords = sumWords(missing);
+  return [
+    {
+      kind: "build",
+      missingChapters: missing.length,
+      missingWords,
+      planning: planGenerationTask(
+        input.task,
+        missingWords,
+        missing.length,
+        input.concurrent,
+        input.planningModel
+      ),
+      recommendation: formatImprovementRecommendation(
+        input.covered,
+        input.total,
+        missingWords
+      ),
+      task: input.task,
+      title: input.title
+    }
+  ];
+}
+function formatImprovementRecommendation(covered, total, missingWords) {
+  const totalWords = sumWords(total);
+  const coveredWords = sumWords(covered);
+  if (totalWords === 0) return "No source content is available.";
+  if (total.length === 1 || coveredWords / totalWords >= 0.9 || missingWords <= 1e3) {
+    return "Queue the full scope to finish the remaining gap.";
+  }
+  return "Queue selected chapters first if only part of the scope matters.";
+}
+function formatRetrievalGuidance(input) {
+  if (input.sourceWords === 0 || input.contentChapters.length === 0) {
+    return [
+      "Source content: empty.",
+      "Add source text before using query coverage or graph-based retrieval."
+    ];
+  }
+  return [
+    input.queryReady ? `Query: available; local index cache is ${input.indexCacheCurrent ? "current" : "missing or outdated and can be synced from artifacts"}.` : "Query: unavailable until every content chapter has a current FTS or source embedding artifact.",
+    formatObjectSearchGuidance(
+      "Reading Graph object retrieval",
+      input.readingGraphCovered,
+      input.contentChapters
+    ),
+    formatObjectSearchGuidance(
+      "Entity/triple retrieval",
+      input.knowledgeGraphCovered,
+      input.contentChapters
+    )
+  ];
+}
+function formatObjectSearchGuidance(label, covered, total) {
+  const coveredWords = sumWords(covered);
+  const totalWords = sumWords(total);
+  const ratio = totalWords === 0 ? 0 : coveredWords / totalWords;
+  const coverage = formatPercent(coveredWords, totalWords);
+  if (ratio >= 1) {
+    return `${label}: covers all source content; it can represent the full scope for object retrieval.`;
+  }
+  if (ratio >= 0.9) {
+    return `${label}: covers ${coverage}; use it as the main path, but source --query is needed for uncovered content.`;
+  }
+  if (ratio >= 0.5) {
+    return `${label}: covers ${coverage}; use it as leads, not as a full-scope substitute for source --query.`;
+  }
+  return `${label}: covers ${coverage}; build missing graph coverage before relying on object retrieval.`;
+}
+function sumWords(chapters) {
+  return chapters.reduce((total, { chapter }) => total + chapter.words, 0);
+}
+function formatPercent(numerator, denominator) {
+  if (denominator === 0) return "n/a";
+  const percent = numerator / denominator * 100;
+  return `${Number.isInteger(percent) ? percent.toFixed(0) : percent.toFixed(1)}%`;
+}
 function toCLIInspectReport(report) {
   const { archiveUri, summaryCoverageNote, ...base } = report;
   return {
@@ -1493,6 +1817,7 @@ var init_inspect = __esm({
     init_runtime();
     init_context();
     init_support();
+    init_archive_target();
   }
 });
 
@@ -1645,7 +1970,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":
@@ -1939,6 +2264,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,
@@ -2086,6 +2419,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,
@@ -2275,6 +2615,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));
@@ -2809,6 +3150,7 @@ async function writePage(page, context, format) {
 `
       );
       return;
+    case "archive-title":
     case "chapter-title":
       await writeTextToStdout(
         `${formatPlainObject(await createPageObject(page, context))}
@@ -3030,31 +3372,17 @@ var init_types2 = __esm({
 });
 
 // src/commands/archive-command/run/uri.ts
-import {
-  parseWikiGraphLibraryUri as parseWikiGraphLibraryUri4,
-  resolveWikiGraphArchiveLocation
-} from "wiki-graph-sdk";
-async function resolveArchiveRuntimeLocation(uriOrPath) {
-  return await resolveWikiGraphArchiveLocation(uriOrPath);
-}
-async function resolveArchiveCommandRuntimeArguments(args) {
+import { parseWikiGraphLibraryUri as parseWikiGraphLibraryUri4 } from "wiki-graph-sdk";
+function resolveArchiveCommandRuntimeArguments(args) {
   if (args.action === "create" || args.action === "export") {
-    const location2 = await resolveArchiveRuntimeLocation(args.archivePath);
-    return { ...args, archivePath: location2.archivePath };
+    return { ...args, archivePath: getArchivePath(args.archivePath) };
   }
-  if (args.action === "inspect" || args.action === "next") return args;
-  if (!args.archivePath.startsWith("wikg://lib/")) {
-    return args;
-  }
-  const location = await resolveArchiveRuntimeLocation(args.archivePath);
-  return {
-    ...args,
-    archivePath: location.locatedUri,
-    ...args.objectId === args.archivePath ? { objectId: location.locatedUri } : {}
-  };
+  return args;
 }
 function getArchivePath(uri) {
-  if (parseWikiGraphLibraryUri4(uri)?.kind === "scope") {
+  if (!uri.includes("://")) return uri;
+  const libraryTarget = parseWikiGraphLibraryUri4(uri);
+  if (libraryTarget?.kind === "scope" || libraryTarget?.kind === "archive-collection") {
     return uri;
   }
   const archivePath = parseLocatedWikiGraphUri(uri).archivePath;
@@ -3064,7 +3392,8 @@ function getArchivePath(uri) {
   return archivePath;
 }
 function getArchiveIndexScope(uri) {
-  if (parseWikiGraphLibraryUri4(uri)?.kind === "scope") {
+  const libraryTarget = parseWikiGraphLibraryUri4(uri);
+  if (libraryTarget?.kind === "scope" || libraryTarget?.kind === "archive-collection") {
     return { kind: "library-index", libraryId: -1 };
   }
   const archivePath = getArchivePath(uri);
@@ -3094,7 +3423,7 @@ var init_uri3 = __esm({
 
 // src/commands/archive-command/run/options.ts
 import {
-  parseLocatedWikiGraphUri as parseLocatedWikiGraphUri2
+  parseLocatedWikiGraphUri as parseLocatedWikiGraphUri3
 } from "wiki-graph-sdk";
 function createFindOptions(args) {
   const types = args.kinds?.map((kind) => {
@@ -3112,6 +3441,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 },
@@ -3133,6 +3463,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 },
@@ -3206,7 +3537,7 @@ function createScopeOptions(args) {
   if (args.chapters !== void 0) {
     return { chapters: args.chapters };
   }
-  const objectUri = parseLocatedWikiGraphUri2(args.archivePath).objectUri;
+  const objectUri = parseLocatedWikiGraphUri3(args.archivePath).objectUri;
   if (objectUri === void 0) {
     return {};
   }
@@ -3261,7 +3592,7 @@ var init_options = __esm({
 async function runNextArchivePage(args) {
   const cursorId = args.cursor ?? args.archivePath;
   const page = await getWikiGraphSDK().continuations.next({
-    ...args.cursor === void 0 ? {} : { archive: args.archivePath },
+    ...args.cursor === void 0 ? {} : { archive: parseCLIArchiveTarget(args.archivePath) },
     cursor: cursorId,
     ...args.format === void 0 ? {} : { format: args.format },
     ...args.limit === void 0 ? {} : { limit: args.limit }
@@ -3323,6 +3654,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 } : {}
@@ -3331,6 +3663,7 @@ function createCursorOutputContext(cursor, format, limit) {
 var init_next = __esm({
   "src/commands/archive-command/run/next.ts"() {
     "use strict";
+    init_archive_target();
     init_context();
     init_archive_output();
     init_options();
@@ -3381,11 +3714,11 @@ import {
 } from "wiki-graph-sdk";
 async function runArchiveCommand(args) {
   const libraryTarget = parseWikiGraphLibraryUri5(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;
   }
-  args = await resolveArchiveCommandRuntimeArguments(args);
+  args = resolveArchiveCommandRuntimeArguments(args);
   switch (args.action) {
     case "create":
       await createArchive(args);
@@ -3430,7 +3763,9 @@ async function runArchiveCommand(args) {
       return;
     case "pack":
       await writePack(
-        await (await getWikiGraphSDK().archives.open(args.archivePath)).pack(getObjectUri(args.objectId), args.budget ?? 5e3),
+        await (await getWikiGraphSDK().archives.open(
+          parseCLIArchiveTarget(args.archivePath)
+        )).pack(getObjectUri(args.objectId), args.budget ?? 5e3),
         createArchiveOutputContext(args),
         args.format ?? "text"
       );
@@ -3438,7 +3773,9 @@ async function runArchiveCommand(args) {
   }
 }
 async function runArchiveList(args) {
-  const archive = await getWikiGraphSDK().archives.open(args.archivePath);
+  const archive = await getWikiGraphSDK().archives.open(
+    parseCLIArchiveTarget(args.archivePath)
+  );
   const objectUri = getObjectUri(args.archivePath);
   if (isSourceLocatorScopeUri(objectUri)) {
     const context2 = createArchiveOutputContext(args, {
@@ -3507,7 +3844,9 @@ async function runArchiveList(args) {
   );
 }
 async function runArchiveSearch(args) {
-  const archive = await getWikiGraphSDK().archives.open(args.archivePath);
+  const archive = await getWikiGraphSDK().archives.open(
+    parseCLIArchiveTarget(args.archivePath)
+  );
   const scope = await archive.resolveScope({
     ...args.depth === void 0 ? {} : { depth: args.depth }
   });
@@ -3541,7 +3880,9 @@ async function runArchiveGet(args) {
   const objectUri = getObjectUri(args.objectId);
   const evidenceLimit = getSingleObjectEvidenceLimit(args, objectUri);
   const context = evidenceLimit === void 0 ? createArchiveOutputContext(args) : createArchiveOutputContext({ ...args, evidenceLimit });
-  const archive = await getWikiGraphSDK().archives.open(args.archivePath);
+  const archive = await getWikiGraphSDK().archives.open(
+    parseCLIArchiveTarget(args.archivePath)
+  );
   await writePage(
     await archive.page(objectUri, {
       ...args.backlinks === void 0 ? {} : { backlinks: args.backlinks },
@@ -3555,7 +3896,9 @@ async function runArchiveGet(args) {
 }
 async function runArchiveRelated(args) {
   const objectUri = getObjectUri(args.objectId);
-  const archive = await getWikiGraphSDK().archives.open(args.archivePath);
+  const archive = await getWikiGraphSDK().archives.open(
+    parseCLIArchiveTarget(args.archivePath)
+  );
   const scope = await archive.resolveScope();
   const context = createArchiveOutputContext(
     scope === void 0 ? args : { ...args, chapters: scope.chapterIds },
@@ -3570,6 +3913,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)
@@ -3587,7 +3931,9 @@ async function runArchiveRelated(args) {
 }
 async function runArchiveEvidence(args) {
   const objectUri = getObjectUri(args.objectId);
-  const archive = await getWikiGraphSDK().archives.open(args.archivePath);
+  const archive = await getWikiGraphSDK().archives.open(
+    parseCLIArchiveTarget(args.archivePath)
+  );
   const scope = await archive.resolveScope();
   const context = createArchiveOutputContext(
     scope === void 0 ? args : { ...args, chapters: scope.chapterIds },
@@ -3601,6 +3947,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)
   });
@@ -3648,8 +3995,9 @@ async function runLibraryIndexArchiveCommand(args, target) {
   const library = await libraries.get(
     formatWikiGraphLibraryUri2(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,
@@ -3658,25 +4006,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"
         );
@@ -3817,6 +4165,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)
@@ -3851,6 +4200,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)
           }),
@@ -3866,6 +4216,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)
         }),
@@ -3913,6 +4264,38 @@ var init_archive_command = __esm({
     init_inspect();
     init_archive_output();
     init_run();
+    init_archive_target();
+  }
+});
+
+// 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();
   }
 });
 
@@ -4239,16 +4622,6 @@ var init_estimate = __esm({
   }
 });
 
-// src/runtime/node-platform.ts
-var node_platform_exports = {};
-import * as node_platform_star from "wiki-graph-sdk/node-platform";
-var init_node_platform = __esm({
-  "src/runtime/node-platform.ts"() {
-    "use strict";
-    __reExport(node_platform_exports, node_platform_star);
-  }
-});
-
 // src/commands/queue/output.ts
 import {
   formatLocatedChapterUri as formatLocatedChapterUri2
@@ -4500,26 +4873,23 @@ async function resolveJobChapter(job) {
 }
 function getJobResourcePath(job, resourceKey, legacyKey) {
   const record = job;
-  const resource = record[resourceKey];
-  if (resource !== void 0) {
-    const managedPath = getManagedJobResourcePath(resource);
-    if (managedPath !== void 0) return managedPath;
-    return (0, node_platform_exports.getNodeResourcePath)(resource);
+  if (resourceKey === "archive") {
+    return job.archive.kind === "library" ? job.archive.uri : job.archive.path;
   }
   const legacyPath = record[legacyKey];
-  if (typeof legacyPath === "string") return legacyPath;
+  if (typeof legacyPath === "string") {
+    return resolveManagedJobResourcePath(legacyPath) ?? legacyPath;
+  }
   return void 0;
 }
-function getManagedJobResourcePath(resource) {
-  if (typeof resource !== "object" || resource === null || !("identity" in resource) || typeof resource.identity !== "string" || !resource.identity.startsWith("managed:library:")) {
-    return void 0;
-  }
-  const relativePath = resource.identity.slice("managed:library:".length);
+function resolveManagedJobResourcePath(identity) {
+  if (!identity.startsWith("managed:library:")) return void 0;
+  const relativePath = identity.slice("managed:library:".length);
   const segments = relativePath.split("/");
   if (relativePath === "" || segments.some(
     (segment) => segment === "" || segment === "." || segment === ".." || segment.includes("\\")
   )) {
-    throw new TypeError(`Invalid managed job resource: ${resource.identity}`);
+    throw new TypeError(`Invalid managed job resource: ${identity}`);
   }
   const environmentHome = getCLIEnvValue("HOME")?.trim();
   const stateDirectory = getCLIStateDir() ?? join5(
@@ -4538,7 +4908,6 @@ var init_output = __esm({
     "use strict";
     init_support();
     init_estimate();
-    init_node_platform();
     init_context();
   }
 });
@@ -4569,6 +4938,7 @@ var init_add = __esm({
     init_internal_child();
     init_estimate();
     init_output();
+    init_archive_target();
   }
 });
 
@@ -4585,7 +4955,7 @@ import {
 } from "wiki-graph-sdk";
 async function runArchiveChapterCommand(args) {
   const sdk = getWikiGraphSDK();
-  const archive = await sdk.archives.open(args.path);
+  const archive = await sdk.archives.open(parseCLIArchiveTarget(args.path));
   switch (args.action) {
     case "add": {
       const details = await archive.addChapter({
@@ -4615,7 +4985,7 @@ async function runArchiveChapterCommand(args) {
         requireChapterPath2(args.chapterPath)
       );
       const job = await sdk.jobs.create({
-        archive: archive.path,
+        archive: archive.target,
         chapterId: chapter.chapterId,
         target: requireIndexArtifactTarget(args.indexArtifactTarget)
       });
@@ -4929,6 +5299,7 @@ var init_chapter = __esm({
     "use strict";
     init_context();
     init_support();
+    init_archive_target();
     init_support();
     init_add();
     init_output();
@@ -4954,11 +5325,15 @@ async function runArchiveIndexCommand(args) {
   }
 }
 async function readIndexCache(args) {
-  const archive = await getWikiGraphSDK().archives.open(args.archivePath);
+  const archive = await getWikiGraphSDK().archives.open(
+    parseCLIArchiveTarget(args.archivePath)
+  );
   await writeIndexOutput(args, await archive.getSearchIndexStatus());
 }
 async function syncIndexCache(args) {
-  const archive = await getWikiGraphSDK().archives.open(args.archivePath);
+  const archive = await getWikiGraphSDK().archives.open(
+    parseCLIArchiveTarget(args.archivePath)
+  );
   const writer = new ProgressOutputWriter({
     jsonl: args.jsonl ?? false,
     throttleMs: INDEX_PROGRESS_OUTPUT_INTERVAL_MS
@@ -5007,7 +5382,9 @@ async function syncIndexCache(args) {
   });
 }
 async function cleanIndexCache(args) {
-  const archive = await getWikiGraphSDK().archives.open(args.archivePath);
+  const archive = await getWikiGraphSDK().archives.open(
+    parseCLIArchiveTarget(args.archivePath)
+  );
   await writeIndexOutput(args, await archive.cleanSearchIndex());
 }
 function formatIndexCounter(input) {
@@ -5076,6 +5453,7 @@ var init_search_index = __esm({
   "src/commands/archive-command/search-index.ts"() {
     "use strict";
     init_support();
+    init_archive_target();
     init_support();
     init_runtime();
     init_context();
@@ -5094,13 +5472,17 @@ async function runArchiveMetaCommand(args) {
     await updateArchiveMeta(args.inputPath, args.metaPatch);
     return;
   }
-  const archive = await getWikiGraphSDK().archives.open(args.inputPath);
+  const archive = await getWikiGraphSDK().archives.open(
+    parseCLIArchiveTarget(args.inputPath)
+  );
   await writeArchiveMeta(await archive.readBookMeta(), {
     json: args.json ?? false
   });
 }
 async function runArchiveCoverCommand(args) {
-  const archive = await getWikiGraphSDK().archives.open(args.inputPath);
+  const archive = await getWikiGraphSDK().archives.open(
+    parseCLIArchiveTarget(args.inputPath)
+  );
   if (process.stdout.isTTY === true) {
     throw new Error(
       "Refusing to write binary cover data to an interactive terminal. Redirect stdout or pipe it."
@@ -5113,7 +5495,9 @@ async function runArchiveCoverCommand(args) {
   await writeBinaryToStdout(cover.data);
 }
 async function updateArchiveMeta(path, patch) {
-  const archive = await getWikiGraphSDK().archives.open(path);
+  const archive = await getWikiGraphSDK().archives.open(
+    parseCLIArchiveTarget(path)
+  );
   const meta = await archive.readBookMeta();
   if (meta === void 0) {
     throw new Error("Archive metadata is missing.");
@@ -5176,6 +5560,7 @@ var init_maintenance = __esm({
   "src/commands/archive-command/maintenance.ts"() {
     "use strict";
     init_support();
+    init_archive_target();
     init_support();
     init_context();
   }
@@ -5814,6 +6199,20 @@ async function runLibraryCommand(args) {
       );
       return;
     }
+    case "replace": {
+      if (args.inputPath === void 0) {
+        throw new Error("Missing --input <path> for library archive replace.");
+      }
+      await writeLibraryArchive(
+        await libraries.replaceArchive({
+          inputPath: args.inputPath,
+          target: args.target
+        }),
+        args.json ?? false,
+        "Replaced library archive"
+      );
+      return;
+    }
     case "get": {
       if (args.target.kind === "path") {
         await writeLibraryPath(
@@ -5911,9 +6310,8 @@ async function writeLibrary(library, json) {
       formatCLIJSON({
         uri: library.uri,
         id: library.publicId,
-        folderPath: (0, node_platform_exports.getNodeResourcePath)(library.folder),
+        folderPath: library.folderPath,
         isDefault: library.isDefault,
-        stagingPath: (0, node_platform_exports.getNodeResourcePath)(library.staging),
         createdAt: library.createdAt,
         updatedAt: library.updatedAt
       })
@@ -5930,7 +6328,7 @@ async function writeLibraries(libraries, json) {
         items: libraries.map((library) => ({
           uri: library.uri,
           id: library.publicId,
-          path: (0, node_platform_exports.getNodeResourcePath)(library.folder),
+          path: library.folderPath,
           isDefault: library.isDefault
         }))
       })
@@ -5942,7 +6340,7 @@ async function writeLibraries(libraries, json) {
       (library) => [
         library.uri,
         library.publicId,
-        (0, node_platform_exports.getNodeResourcePath)(library.folder),
+        library.folderPath,
         library.isDefault ? "default" : ""
       ].join("	")
     ).join("\n") + (libraries.length === 0 ? "" : "\n")
@@ -5953,12 +6351,12 @@ async function writeLibraryPath(library, json) {
     await writeTextToStdout(
       formatCLIJSON({
         uri: `${library.uri}/path`,
-        path: (0, node_platform_exports.getNodeResourcePath)(library.folder)
+        path: library.folderPath
       })
     );
     return;
   }
-  await writeTextToStdout(`${(0, node_platform_exports.getNodeResourcePath)(library.folder)}
+  await writeTextToStdout(`${library.folderPath}
 `);
 }
 async function writeLibraryArchivePath(archive, json) {
@@ -6297,7 +6695,7 @@ function formatMetadataTextValue(value) {
   return String(value);
 }
 function formatArchiveHostPath(archive) {
-  return archive.file === void 0 ? archive.relativePath : (0, node_platform_exports.getNodeResourcePath)(archive.file);
+  return archive.relativePath;
 }
 var INDEX_PROGRESS_OUTPUT_INTERVAL_MS2;
 var init_library = __esm({
@@ -6306,7 +6704,6 @@ var init_library = __esm({
     init_context();
     init_support();
     init_run();
-    init_node_platform();
     init_archive_output();
     init_runtime();
     INDEX_PROGRESS_OUTPUT_INTERVAL_MS2 = 6e3;
@@ -6320,7 +6717,9 @@ __export(object_metadata_exports, {
 });
 import { readFile as readFile3 } from "fs/promises";
 async function runObjectMetadataCommand(args) {
-  const archive = await getWikiGraphSDK().archives.open(args.archivePath);
+  const archive = await getWikiGraphSDK().archives.open(
+    parseCLIArchiveTarget(args.archivePath)
+  );
   switch (args.action) {
     case "get": {
       await writeMetadataMap2(
@@ -6449,6 +6848,7 @@ var init_object_metadata = __esm({
     "use strict";
     init_context();
     init_support();
+    init_archive_target();
     init_support();
   }
 });
@@ -6681,7 +7081,7 @@ async function runQueueCommand(args) {
         (await getWikiGraphSDK().jobs.list({
           ...args.activeOnly === void 0 ? {} : { activeOnly: args.activeOnly },
           ...args.all === void 0 ? {} : { all: args.all },
-          ...args.archivePath === void 0 ? {} : { archive: new node_platform_exports.NodeFile(args.archivePath) }
+          ...args.archivePath === void 0 ? {} : { archive: parseCLIArchiveTarget(args.archivePath) }
         })).map((job) => job.snapshot),
         { json: args.json ?? false }
       );
@@ -6733,7 +7133,7 @@ async function getQueueJob(args) {
 }
 function createEnqueueOptions(args) {
   return {
-    archive: args.archivePath,
+    archive: parseCLIArchiveTarget(args.archivePath),
     ...args.boost === void 0 ? {} : { boost: args.boost },
     ...args.chapterId === void 0 ? {} : { chapterId: args.chapterId },
     ...args.chapterIds === void 0 ? {} : { chapterIds: args.chapterIds },
@@ -6750,11 +7150,11 @@ var init_queue = __esm({
     init_config();
     init_context();
     init_support();
+    init_archive_target();
     init_add();
     init_estimate();
     init_output();
     init_watch();
-    init_node_platform();
     init_worker();
   }
 });
@@ -6995,6 +7395,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",
@@ -8790,6 +9191,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);
@@ -8967,6 +9369,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 }
@@ -9087,6 +9490,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) : {}
@@ -9131,6 +9535,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 } : {}
         },
@@ -9229,6 +9634,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
 import { parseArgs } from "util";
@@ -10122,6 +10545,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";
   }
@@ -10288,6 +10714,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(
@@ -11185,7 +11653,7 @@ init_support();
 import {
   parseWikiGraphLibraryUri as parseWikiGraphLibraryUri3
 } from "wiki-graph-sdk";
-var LIBRARY_ARCHIVE_ACTIONS = /* @__PURE__ */ new Set(["get", "remove"]);
+var LIBRARY_ARCHIVE_ACTIONS = /* @__PURE__ */ new Set(["get", "remove", "replace"]);
 var LIBRARY_ARCHIVE_COLLECTION_ACTIONS = /* @__PURE__ */ new Set(["add", "get", "scan"]);
 var LIBRARY_ARCHIVE_PATH_ACTIONS = /* @__PURE__ */ new Set(["get", "set"]);
 var LIBRARY_ARCHIVE_TREE_ACTIONS = /* @__PURE__ */ new Set(["archive-tree"]);
@@ -11218,7 +11686,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(
@@ -11271,6 +11739,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,
@@ -11892,10 +12369,22 @@ function parseLibraryArchiveArguments(uri, target, action, tail, values) {
     allowConfirm: action === "remove"
   });
   rejectArchiveFlag(action, "--path", values.path, helpRoute);
-  rejectArchiveFlag(action, "--input", values.input, helpRoute);
   rejectArchiveFlag(action, "--json-input", values["json-input"], helpRoute);
   rejectArchiveBooleanFlag(action, "--jsonl", values.jsonl, helpRoute);
   rejectExtraPositionals(action, tail, 0, helpRoute);
+  if (action === "replace") {
+    if (values.input === void 0) {
+      throw new Error(withHelpRoute("Missing --input <path>.", helpRoute));
+    }
+    rejectArchiveFlag(action, "--to", values.to, helpRoute);
+    rejectArchiveBooleanFlag(action, "--confirm", values.confirm, helpRoute);
+    return {
+      args: { action, inputPath: values.input, json: values.json, target },
+      help: false,
+      kind: "library"
+    };
+  }
+  rejectArchiveFlag(action, "--input", values.input, helpRoute);
   if (action === "get") {
     rejectArchiveFlag(action, "--to", values.to, helpRoute);
     rejectArchiveBooleanFlag(action, "--confirm", values.confirm, helpRoute);
@@ -11992,6 +12481,7 @@ function parseLibraryScopeArguments(uri, target, action, tail, values) {
     case "add":
     case "create":
     case "rebind":
+    case "replace":
     case "scan":
       throw new Error(
         "Internal error: unsupported action routed to library scope."
@@ -12059,6 +12549,7 @@ function parseLibraryMetadataArguments(uri, target, action, tail, values) {
     case "create":
     case "list":
     case "remove":
+    case "replace":
     case "add":
     case "rebind":
     case "clean-index":
@@ -12103,7 +12594,7 @@ function rejectExtraPositionals(action, positionals, expected, helpRoute) {
   }
 }
 function isLibraryAction(action) {
-  return action === "add" || action === "archive-tree" || action === "clear" || action === "clean-index" || action === "create" || action === "delete" || action === "get" || action === "get-index" || action === "list" || action === "put" || action === "rebind" || action === "remove" || action === "scan" || action === "set" || action === "sync-index";
+  return action === "add" || action === "archive-tree" || action === "clear" || action === "clean-index" || action === "create" || action === "delete" || action === "get" || action === "get-index" || action === "list" || action === "put" || action === "rebind" || action === "replace" || action === "remove" || action === "scan" || action === "set" || action === "sync-index";
 }
 function validateTargetAction(uri, label, actions, action) {
   if (!actions.has(action)) {
@@ -12338,6 +12829,9 @@ function parseCLIArguments(argv = process.argv.slice(2)) {
       query: {
         type: "string"
       },
+      "query-mode": {
+        type: "string"
+      },
       replace: {
         type: "boolean"
       },
@@ -12525,6 +13019,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);
@@ -12628,6 +13126,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 };
@@ -12898,8 +13399,10 @@ var CaptureWritable = class extends Writable2 {
   }
 };
 
-// src/app/main.ts
-init_node_platform();
+// src/runtime/node-platform.ts
+var node_platform_exports = {};
+__reExport(node_platform_exports, node_platform_star);
+import * as node_platform_star from "wiki-graph-sdk/node-platform";
 export {
   createWikiGraphCLI,
   runWikiGraphCLI,