wiki-graph 0.7.1 → 0.8.0

package/dist/index.js

@@ -556,6 +556,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 +593,7 @@ var init_support = __esm({
     init_uri();
     init_version();
     init_command();
+    init_archive_target();
   }
 });
 
@@ -1321,17 +1346,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 +1816,7 @@ var init_inspect = __esm({
     init_runtime();
     init_context();
     init_support();
+    init_archive_target();
   }
 });
 
@@ -3030,30 +3354,15 @@ 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 };
-  }
-  if (args.action === "inspect" || args.action === "next") return args;
-  if (!args.archivePath.startsWith("wikg://lib/")) {
-    return args;
+    return { ...args, archivePath: getArchivePath(args.archivePath) };
   }
-  const location = await resolveArchiveRuntimeLocation(args.archivePath);
-  return {
-    ...args,
-    archivePath: location.locatedUri,
-    ...args.objectId === args.archivePath ? { objectId: location.locatedUri } : {}
-  };
+  return args;
 }
 function getArchivePath(uri) {
+  if (!uri.includes("://")) return uri;
   if (parseWikiGraphLibraryUri4(uri)?.kind === "scope") {
     return uri;
   }
@@ -3094,7 +3403,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) => {
@@ -3206,7 +3515,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 +3570,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 }
@@ -3331,6 +3640,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();
@@ -3385,7 +3695,7 @@ async function runArchiveCommand(args) {
     await runLibraryIndexArchiveCommand(args, libraryTarget);
     return;
   }
-  args = await resolveArchiveCommandRuntimeArguments(args);
+  args = resolveArchiveCommandRuntimeArguments(args);
   switch (args.action) {
     case "create":
       await createArchive(args);
@@ -3430,7 +3740,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 +3750,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 +3821,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 +3857,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 +3873,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 },
@@ -3587,7 +3907,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 },
@@ -3913,6 +4235,7 @@ var init_archive_command = __esm({
     init_inspect();
     init_archive_output();
     init_run();
+    init_archive_target();
   }
 });
 
@@ -4239,16 +4562,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 +4813,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 +4848,6 @@ var init_output = __esm({
     "use strict";
     init_support();
     init_estimate();
-    init_node_platform();
     init_context();
   }
 });
@@ -4569,6 +4878,7 @@ var init_add = __esm({
     init_internal_child();
     init_estimate();
     init_output();
+    init_archive_target();
   }
 });
 
@@ -4585,7 +4895,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 +4925,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 +5239,7 @@ var init_chapter = __esm({
     "use strict";
     init_context();
     init_support();
+    init_archive_target();
     init_support();
     init_add();
     init_output();
@@ -4954,11 +5265,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 +5322,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 +5393,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 +5412,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 +5435,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 +5500,7 @@ var init_maintenance = __esm({
   "src/commands/archive-command/maintenance.ts"() {
     "use strict";
     init_support();
+    init_archive_target();
     init_support();
     init_context();
   }
@@ -5814,6 +6139,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 +6250,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 +6268,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 +6280,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 +6291,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 +6635,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 +6644,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 +6657,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 +6788,7 @@ var init_object_metadata = __esm({
     "use strict";
     init_context();
     init_support();
+    init_archive_target();
     init_support();
   }
 });
@@ -6681,7 +7021,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 +7073,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 +7090,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();
   }
 });
@@ -11185,7 +11525,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"]);
@@ -11892,10 +12232,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 +12344,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 +12412,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 +12457,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)) {
@@ -12898,8 +13252,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,