wiki-graph 0.7.1 → 0.8.0

package/dist/index.cjs

@@ -559,6 +559,29 @@ var init_version = __esm({
   }
 });
 
+// src/support/archive-target.ts
+function parseCLIArchiveTarget(locator) {
+  if (locator.startsWith("wikg://lib/")) {
+    return { kind: "library", uri: locator };
+  }
+  if (!locator.includes("://")) {
+    return { kind: "standalone", path: locator };
+  }
+  const parsed = (0, import_wiki_graph_sdk4.parseLocatedWikiGraphUri)(locator);
+  return {
+    kind: "standalone",
+    path: parsed.archivePath ?? locator,
+    ...parsed.objectUri === void 0 ? {} : { objectUri: parsed.objectUri }
+  };
+}
+var import_wiki_graph_sdk4;
+var init_archive_target = __esm({
+  "src/support/archive-target.ts"() {
+    "use strict";
+    import_wiki_graph_sdk4 = require("wiki-graph-sdk");
+  }
+});
+
 // src/support/index.ts
 var init_support = __esm({
   "src/support/index.ts"() {
@@ -572,6 +595,7 @@ var init_support = __esm({
     init_uri();
     init_version();
     init_command();
+    init_archive_target();
   }
 });
 
@@ -587,20 +611,20 @@ var init_local_config = __esm({
 // src/runtime/config.ts
 async function loadCLIConfig(options) {
   try {
-    return await (0, import_wiki_graph_sdk14.loadWikiGraphRuntimeConfig)(options);
+    return await (0, import_wiki_graph_sdk15.loadWikiGraphRuntimeConfig)(options);
   } catch (error) {
     throw withConfigHelp(error);
   }
 }
 function resolveWikispineConfig(value, envPolicy = getCLIEnvPolicy()) {
   try {
-    return (0, import_wiki_graph_sdk14.resolveWikispineConfig)(value, envPolicy);
+    return (0, import_wiki_graph_sdk15.resolveWikispineConfig)(value, envPolicy);
   } catch (error) {
     throw withConfigHelp(error);
   }
 }
 function resolveHostedProviderEndpoint(scope, envPolicy = getCLIEnvPolicy()) {
-  return (0, import_wiki_graph_sdk14.resolveHostedProviderEndpoint)(scope, envPolicy);
+  return (0, import_wiki_graph_sdk15.resolveHostedProviderEndpoint)(scope, envPolicy);
 }
 function withConfigHelp(error) {
   const message = error instanceof Error ? error.message : String(error);
@@ -608,11 +632,11 @@ function withConfigHelp(error) {
     cause: error
   });
 }
-var import_wiki_graph_sdk14;
+var import_wiki_graph_sdk15;
 var init_config = __esm({
   "src/runtime/config.ts"() {
     "use strict";
-    import_wiki_graph_sdk14 = require("wiki-graph-sdk");
+    import_wiki_graph_sdk15 = require("wiki-graph-sdk");
     init_support();
     init_context();
   }
@@ -621,7 +645,7 @@ var init_config = __esm({
 // src/runtime/llm.ts
 function buildLLMOptions(config) {
   try {
-    return (0, import_wiki_graph_sdk15.buildWikiGraphLLMOptions)(config);
+    return (0, import_wiki_graph_sdk16.buildWikiGraphLLMOptions)(config);
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     throw new Error(withHelpRoute(message, CLI_HELP_ROUTES.config), {
@@ -629,11 +653,11 @@ function buildLLMOptions(config) {
     });
   }
 }
-var import_wiki_graph_sdk15;
+var import_wiki_graph_sdk16;
 var init_llm = __esm({
   "src/runtime/llm.ts"() {
     "use strict";
-    import_wiki_graph_sdk15 = require("wiki-graph-sdk");
+    import_wiki_graph_sdk16 = require("wiki-graph-sdk");
     init_support();
   }
 });
@@ -1024,7 +1048,7 @@ var init_progress_output = __esm({
 // src/runtime/stage.ts
 async function loadRequiredStageConfig(options) {
   try {
-    return await (0, import_wiki_graph_sdk17.loadRequiredStageConfig)(options);
+    return await (0, import_wiki_graph_sdk18.loadRequiredStageConfig)(options);
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     throw new Error(withHelpRoute(message, CLI_HELP_ROUTES.config), {
@@ -1032,12 +1056,12 @@ async function loadRequiredStageConfig(options) {
     });
   }
 }
-var import_wiki_graph_sdk16, import_wiki_graph_sdk17;
+var import_wiki_graph_sdk17, import_wiki_graph_sdk18;
 var init_stage = __esm({
   "src/runtime/stage.ts"() {
     "use strict";
-    import_wiki_graph_sdk16 = require("wiki-graph-sdk");
     import_wiki_graph_sdk17 = require("wiki-graph-sdk");
+    import_wiki_graph_sdk18 = require("wiki-graph-sdk");
     init_support();
   }
 });
@@ -1054,18 +1078,18 @@ var init_wikispine = __esm({
 // src/runtime/index.ts
 var runtime_exports = {};
 __export(runtime_exports, {
-  DEFAULT_EXTRACTION_PROMPT: () => import_wiki_graph_sdk16.DEFAULT_EXTRACTION_PROMPT,
-  DEFAULT_KNOWLEDGE_GRAPH_RECALL_PROMPT: () => import_wiki_graph_sdk16.DEFAULT_KNOWLEDGE_GRAPH_RECALL_PROMPT,
+  DEFAULT_EXTRACTION_PROMPT: () => import_wiki_graph_sdk17.DEFAULT_EXTRACTION_PROMPT,
+  DEFAULT_KNOWLEDGE_GRAPH_RECALL_PROMPT: () => import_wiki_graph_sdk17.DEFAULT_KNOWLEDGE_GRAPH_RECALL_PROMPT,
   ProgressOutputWriter: () => ProgressOutputWriter,
   buildLLMOptions: () => buildLLMOptions,
   createCLIProgressRenderer: () => createCLIProgressRenderer,
-  createStageLLM: () => import_wiki_graph_sdk16.createStageLLM,
+  createStageLLM: () => import_wiki_graph_sdk17.createStageLLM,
   formatStatusText: () => formatStatusText,
   loadCLIConfig: () => loadCLIConfig,
   loadRequiredStageConfig: () => loadRequiredStageConfig,
-  resolveExtractionPrompt: () => import_wiki_graph_sdk16.resolveExtractionPrompt,
+  resolveExtractionPrompt: () => import_wiki_graph_sdk17.resolveExtractionPrompt,
   resolveHostedProviderEndpoint: () => resolveHostedProviderEndpoint,
-  resolveKnowledgeGraphRecallPrompt: () => import_wiki_graph_sdk16.resolveKnowledgeGraphRecallPrompt,
+  resolveKnowledgeGraphRecallPrompt: () => import_wiki_graph_sdk17.resolveKnowledgeGraphRecallPrompt,
   resolveWikispineConfig: () => resolveWikispineConfig,
   toCLIGenerationPerformanceHints: () => toCLIGenerationPerformanceHints
 });
@@ -1284,7 +1308,7 @@ async function createArchive(args) {
       args.json === true ? formatCLIJSON({ uri: result.locatedUri }) : "<archive>\n"
     );
   } catch (error) {
-    if (!(error instanceof import_wiki_graph_sdk18.WikiGraphArchiveExistsError)) throw error;
+    if (!(error instanceof import_wiki_graph_sdk19.WikiGraphArchiveExistsError)) throw error;
     throw new Error(formatArchiveAlreadyExistsMessage(error.path), {
       cause: error
     });
@@ -1299,11 +1323,11 @@ function formatArchiveAlreadyExistsMessage(archivePath) {
     `Use \`${formatCliCommand([uri, "inspect"])}\` to view it, or rerun with \`--replace\` to overwrite it.`
   ].join("\n");
 }
-var import_wiki_graph_sdk18;
+var import_wiki_graph_sdk19;
 var init_create = __esm({
   "src/commands/archive-command/create.ts"() {
     "use strict";
-    import_wiki_graph_sdk18 = require("wiki-graph-sdk");
+    import_wiki_graph_sdk19 = require("wiki-graph-sdk");
     init_context();
     init_runtime();
     init_support();
@@ -1312,16 +1336,306 @@ var init_create = __esm({
 
 // src/commands/archive-command/inspect.ts
 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 (0, import_wiki_graph_sdk20.loadWikiGraphRuntimeConfig)();
+  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 ?? import_wiki_graph_sdk20.DEFAULT_GENERATION_JOB_CONCURRENCY,
+    request: config.concurrent?.request ?? import_wiki_graph_sdk20.DEFAULT_GENERATION_REQUEST_CONCURRENCY
+  };
+  const improvements = createInspectImprovements({
+    concurrent,
+    contentChapters,
+    indexCacheCurrent: inspection.localIndexCache.current,
+    knowledgeGraphCovered,
+    planningModel: (0, import_wiki_graph_sdk20.formatGenerationPlanningModel)(config.llm),
+    queryBlockedChapters,
+    readingGraphCovered,
+    summaryCovered
+  });
+  const performanceHints = (0, import_wiki_graph_sdk20.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: (0, import_wiki_graph_sdk20.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 {
@@ -1477,12 +1791,15 @@ function formatInspectPerformanceHints(hints) {
     ])
   ];
 }
+var import_wiki_graph_sdk20;
 var init_inspect = __esm({
   "src/commands/archive-command/inspect.ts"() {
     "use strict";
+    import_wiki_graph_sdk20 = require("wiki-graph-sdk");
     init_runtime();
     init_context();
     init_support();
+    init_archive_target();
   }
 });
 
@@ -1568,11 +1885,11 @@ function formatEvidencePreviewContinuation(evidence, hiddenEvidenceCount) {
   }
   return hiddenEvidenceCount > 0 ? ["", `${hiddenEvidenceCount} evidence more...`] : [];
 }
-var import_wiki_graph_sdk19;
+var import_wiki_graph_sdk21;
 var init_evidence = __esm({
   "src/commands/archive-output/text/evidence.ts"() {
     "use strict";
-    import_wiki_graph_sdk19 = require("wiki-graph-sdk");
+    import_wiki_graph_sdk21 = require("wiki-graph-sdk");
     init_command();
     init_lines();
     init_source();
@@ -3021,27 +3338,15 @@ var init_types2 = __esm({
 });
 
 // src/commands/archive-command/run/uri.ts
-async function resolveArchiveRuntimeLocation(uriOrPath) {
-  return await (0, import_wiki_graph_sdk20.resolveWikiGraphArchiveLocation)(uriOrPath);
-}
-async function resolveArchiveCommandRuntimeArguments(args) {
+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 ((0, import_wiki_graph_sdk20.parseWikiGraphLibraryUri)(uri)?.kind === "scope") {
+  if (!uri.includes("://")) return uri;
+  if ((0, import_wiki_graph_sdk22.parseWikiGraphLibraryUri)(uri)?.kind === "scope") {
     return uri;
   }
   const archivePath = parseLocatedWikiGraphUri(uri).archivePath;
@@ -3051,14 +3356,14 @@ function getArchivePath(uri) {
   return archivePath;
 }
 function getArchiveIndexScope(uri) {
-  if ((0, import_wiki_graph_sdk20.parseWikiGraphLibraryUri)(uri)?.kind === "scope") {
+  if ((0, import_wiki_graph_sdk22.parseWikiGraphLibraryUri)(uri)?.kind === "scope") {
     return { kind: "library-index", libraryId: -1 };
   }
   const archivePath = getArchivePath(uri);
   return { archiveKey: archivePath, archivePath, kind: "archive-index" };
 }
 function getObjectUri(uri) {
-  const libraryTarget = (0, import_wiki_graph_sdk20.parseWikiGraphLibraryUri)(uri);
+  const libraryTarget = (0, import_wiki_graph_sdk22.parseWikiGraphLibraryUri)(uri);
   if (libraryTarget?.kind === "scope" && libraryTarget.objectUri !== void 0) {
     return libraryTarget.objectUri;
   }
@@ -3072,11 +3377,11 @@ function parseChapterScope(uri) {
   const match = /^wikg:\/\/chapter\/([1-9][0-9]*)(?:\/|$)/u.exec(uri);
   return match?.[1] === void 0 ? void 0 : Number(match[1]);
 }
-var import_wiki_graph_sdk20;
+var import_wiki_graph_sdk22;
 var init_uri3 = __esm({
   "src/commands/archive-command/run/uri.ts"() {
     "use strict";
-    import_wiki_graph_sdk20 = require("wiki-graph-sdk");
+    import_wiki_graph_sdk22 = require("wiki-graph-sdk");
     init_support();
   }
 });
@@ -3192,7 +3497,7 @@ function createScopeOptions(args) {
   if (args.chapters !== void 0) {
     return { chapters: args.chapters };
   }
-  const objectUri = (0, import_wiki_graph_sdk21.parseLocatedWikiGraphUri)(args.archivePath).objectUri;
+  const objectUri = (0, import_wiki_graph_sdk23.parseLocatedWikiGraphUri)(args.archivePath).objectUri;
   if (objectUri === void 0) {
     return {};
   }
@@ -3235,11 +3540,11 @@ function toArchiveCollectionType(kind) {
       return "triple";
   }
 }
-var import_wiki_graph_sdk21;
+var import_wiki_graph_sdk23;
 var init_options = __esm({
   "src/commands/archive-command/run/options.ts"() {
     "use strict";
-    import_wiki_graph_sdk21 = require("wiki-graph-sdk");
+    import_wiki_graph_sdk23 = require("wiki-graph-sdk");
     init_types2();
     init_uri3();
   }
@@ -3249,7 +3554,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 }
@@ -3319,6 +3624,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();
@@ -3330,17 +3636,17 @@ async function writeArchiveRoot(args) {
   const archivePath = getArchivePath(args.objectId);
   if (args.format === "json") {
     await writeTextToStdout(
-      formatCLIJSON({ uri: (0, import_wiki_graph_sdk22.formatLocatedWikiGraphUri)(archivePath) })
+      formatCLIJSON({ uri: (0, import_wiki_graph_sdk24.formatLocatedWikiGraphUri)(archivePath) })
     );
     return;
   }
   await writeTextToStdout("<archive>\n");
 }
-var import_wiki_graph_sdk22;
+var import_wiki_graph_sdk24;
 var init_root = __esm({
   "src/commands/archive-command/run/root.ts"() {
     "use strict";
-    import_wiki_graph_sdk22 = require("wiki-graph-sdk");
+    import_wiki_graph_sdk24 = require("wiki-graph-sdk");
     init_support();
     init_uri3();
   }
@@ -3364,12 +3670,12 @@ __export(archive_command_exports, {
   runArchiveCommand: () => runArchiveCommand
 });
 async function runArchiveCommand(args) {
-  const libraryTarget = (0, import_wiki_graph_sdk23.parseWikiGraphLibraryUri)(args.archivePath);
+  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")) {
     await runLibraryIndexArchiveCommand(args, libraryTarget);
     return;
   }
-  args = await resolveArchiveCommandRuntimeArguments(args);
+  args = resolveArchiveCommandRuntimeArguments(args);
   switch (args.action) {
     case "create":
       await createArchive(args);
@@ -3414,7 +3720,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"
       );
@@ -3422,9 +3730,11 @@ 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 ((0, import_wiki_graph_sdk23.isSourceLocatorScopeUri)(objectUri)) {
+  if ((0, import_wiki_graph_sdk25.isSourceLocatorScopeUri)(objectUri)) {
     const context2 = createArchiveOutputContext(args, {
       continuationKind: "source-locators",
       targetUri: objectUri
@@ -3491,7 +3801,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 }
   });
@@ -3525,7 +3837,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 },
@@ -3539,7 +3853,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 },
@@ -3571,7 +3887,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 },
@@ -3630,7 +3948,7 @@ function isArchiveQueryNotReadyError(error) {
 async function runLibraryIndexArchiveCommand(args, target) {
   const libraries = getWikiGraphSDK().libraries;
   const library = await libraries.get(
-    (0, import_wiki_graph_sdk23.formatWikiGraphLibraryUri)(target.publicId)
+    (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);
@@ -3887,11 +4205,11 @@ function requireLibraryObjectUri(action, objectUri) {
   }
   return objectUri;
 }
-var import_wiki_graph_sdk23;
+var import_wiki_graph_sdk25;
 var init_archive_command = __esm({
   "src/commands/archive-command/index.ts"() {
     "use strict";
-    import_wiki_graph_sdk23 = require("wiki-graph-sdk");
+    import_wiki_graph_sdk25 = require("wiki-graph-sdk");
     init_context();
     init_support();
     init_convert();
@@ -3899,6 +4217,7 @@ var init_archive_command = __esm({
     init_inspect();
     init_archive_output();
     init_run();
+    init_archive_target();
   }
 });
 
@@ -4225,15 +4544,6 @@ var init_estimate = __esm({
   }
 });
 
-// src/runtime/node-platform.ts
-var node_platform_exports = {};
-var init_node_platform = __esm({
-  "src/runtime/node-platform.ts"() {
-    "use strict";
-    __reExport(node_platform_exports, require("wiki-graph-sdk/node-platform"));
-  }
-});
-
 // src/commands/queue/output.ts
 async function writeJobList(jobs, options) {
   const chapters = await resolveJobChapters(jobs);
@@ -4467,7 +4777,7 @@ function createJobChapterReference(job, chapter) {
 }
 function createJobChapterReferenceFromPath(archivePath, chapter) {
   return {
-    locatedUri: (0, import_wiki_graph_sdk24.formatLocatedChapterUri)(archivePath, chapter.path),
+    locatedUri: (0, import_wiki_graph_sdk26.formatLocatedChapterUri)(archivePath, chapter.path),
     title: chapter.title,
     uri: chapter.uri
   };
@@ -4480,26 +4790,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() ?? (0, import_path7.join)(
@@ -4513,14 +4820,13 @@ function requireJobResourcePath(job, resourceKey, legacyKey) {
   if (path !== void 0) return path;
   throw new TypeError(`Build job is missing ${resourceKey}`);
 }
-var import_wiki_graph_sdk24, import_os3, import_path7;
+var import_wiki_graph_sdk26, import_os3, import_path7;
 var init_output = __esm({
   "src/commands/queue/output.ts"() {
     "use strict";
-    import_wiki_graph_sdk24 = require("wiki-graph-sdk");
+    import_wiki_graph_sdk26 = require("wiki-graph-sdk");
     init_support();
     init_estimate();
-    init_node_platform();
     init_context();
     import_os3 = require("os");
     import_path7 = require("path");
@@ -4553,6 +4859,7 @@ var init_add = __esm({
     init_internal_child();
     init_estimate();
     init_output();
+    init_archive_target();
   }
 });
 
@@ -4563,7 +4870,7 @@ __export(chapter_exports, {
 });
 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({
@@ -4593,7 +4900,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)
       });
@@ -4653,7 +4960,7 @@ async function runArchiveChapterCommand(args) {
       return;
     case "set-source": {
       const sourceText = await readRequiredSourceText(args);
-      const parsed = args.inputFormat === "jsonl" ? (0, import_wiki_graph_sdk25.parseSourceTextJsonl)(sourceText) : void 0;
+      const parsed = args.inputFormat === "jsonl" ? (0, import_wiki_graph_sdk27.parseSourceTextJsonl)(sourceText) : void 0;
       await writeChapterDetails(
         await archive.setChapterSource(
           requireChapterPath2(args.chapterPath),
@@ -4686,7 +4993,7 @@ async function runArchiveChapterCommand(args) {
       if (args.treeAction === "apply") {
         await writeChapterTreeApplyResult(
           await archive.applyChapterTree(
-            (0, import_wiki_graph_sdk25.parseChapterTreeInput)(JSON.parse(await readContentText(args))),
+            (0, import_wiki_graph_sdk27.parseChapterTreeInput)(JSON.parse(await readContentText(args))),
             { dryRun: args.dryRun ?? false }
           ),
           args.dryRun ?? false
@@ -4812,10 +5119,10 @@ function formatChapterCommandUri(archiveLocator, chapterPath) {
   if (archiveLocator.startsWith("wikg://")) {
     const parsed = parseLocatedWikiGraphUri(archiveLocator);
     if (parsed.archivePath !== void 0) {
-      return (0, import_wiki_graph_sdk25.formatLocatedChapterUri)(parsed.archivePath, chapterPath);
+      return (0, import_wiki_graph_sdk27.formatLocatedChapterUri)(parsed.archivePath, chapterPath);
     }
   }
-  return (0, import_wiki_graph_sdk25.formatLocatedChapterUri)(archiveLocator, chapterPath);
+  return (0, import_wiki_graph_sdk27.formatLocatedChapterUri)(archiveLocator, chapterPath);
 }
 async function writeChapterList(entries, json) {
   if (json) {
@@ -4902,14 +5209,15 @@ function formatStage(stage) {
       return "reading-summary";
   }
 }
-var import_promises2, import_wiki_graph_sdk25;
+var import_promises2, import_wiki_graph_sdk27;
 var init_chapter = __esm({
   "src/commands/archive-command/chapter.ts"() {
     "use strict";
     import_promises2 = require("fs/promises");
-    import_wiki_graph_sdk25 = require("wiki-graph-sdk");
+    import_wiki_graph_sdk27 = require("wiki-graph-sdk");
     init_context();
     init_support();
+    init_archive_target();
     init_support();
     init_add();
     init_output();
@@ -4935,11 +5243,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
@@ -4988,7 +5300,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) {
@@ -5057,6 +5371,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();
@@ -5075,13 +5390,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."
@@ -5094,7 +5413,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.");
@@ -5157,6 +5478,7 @@ var init_maintenance = __esm({
   "src/commands/archive-command/maintenance.ts"() {
     "use strict";
     init_support();
+    init_archive_target();
     init_support();
     init_context();
   }
@@ -5687,7 +6009,7 @@ async function runLibraryCommand(args) {
       }
       if (args.target.kind === "archive-collection") {
         await writeLibraryArchives(
-          await (await libraries.get((0, import_wiki_graph_sdk26.formatWikiGraphLibraryUri)(args.target.publicId))).archives(),
+          await (await libraries.get((0, import_wiki_graph_sdk28.formatWikiGraphLibraryUri)(args.target.publicId))).archives(),
           args.json ?? false
         );
         return;
@@ -5719,7 +6041,7 @@ async function runLibraryCommand(args) {
     }
     case "archive-tree": {
       await writeLibraryArchiveTree(
-        await (await libraries.get((0, import_wiki_graph_sdk26.formatWikiGraphLibraryUri)(args.target.publicId))).archives(),
+        await (await libraries.get((0, import_wiki_graph_sdk28.formatWikiGraphLibraryUri)(args.target.publicId))).archives(),
         {
           ...args.depth === void 0 ? {} : { depth: args.depth },
           json: args.json ?? false,
@@ -5793,10 +6115,24 @@ 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(
-          (await libraries.get((0, import_wiki_graph_sdk26.formatWikiGraphLibraryUri)(args.target.publicId))).snapshot,
+          (await libraries.get((0, import_wiki_graph_sdk28.formatWikiGraphLibraryUri)(args.target.publicId))).snapshot,
           args.json ?? false
         );
         return;
@@ -5824,7 +6160,7 @@ async function runLibraryCommand(args) {
       }
       if (args.target.kind === "archive-collection") {
         await writeLibraryArchives(
-          await (await libraries.get((0, import_wiki_graph_sdk26.formatWikiGraphLibraryUri)(args.target.publicId))).archives(),
+          await (await libraries.get((0, import_wiki_graph_sdk28.formatWikiGraphLibraryUri)(args.target.publicId))).archives(),
           args.json ?? false
         );
         return;
@@ -5890,9 +6226,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
       })
@@ -5909,7 +6244,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
         }))
       })
@@ -5921,7 +6256,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")
@@ -5932,12 +6267,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) {
@@ -6004,8 +6339,8 @@ async function writeLibraryArchives(archives, json) {
 }
 async function writeLibraryScopeCollection(target, json) {
   const manager = getWikiGraphSDK().libraries;
-  const library = await manager.get((0, import_wiki_graph_sdk26.formatWikiGraphLibraryUri)(target.publicId));
-  const baseUri = (0, import_wiki_graph_sdk26.formatWikiGraphLibraryUri)(target.publicId);
+  const library = await manager.get((0, import_wiki_graph_sdk28.formatWikiGraphLibraryUri)(target.publicId));
+  const baseUri = (0, import_wiki_graph_sdk28.formatWikiGraphLibraryUri)(target.publicId);
   const context = {
     archiveKey: baseUri,
     archivePath: baseUri,
@@ -6276,18 +6611,17 @@ 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 import_promises4, import_wiki_graph_sdk26, INDEX_PROGRESS_OUTPUT_INTERVAL_MS2;
+var import_promises4, import_wiki_graph_sdk28, INDEX_PROGRESS_OUTPUT_INTERVAL_MS2;
 var init_library = __esm({
   "src/commands/library.ts"() {
     "use strict";
     import_promises4 = require("fs/promises");
-    import_wiki_graph_sdk26 = require("wiki-graph-sdk");
+    import_wiki_graph_sdk28 = require("wiki-graph-sdk");
     init_context();
     init_support();
     init_run();
-    init_node_platform();
     init_archive_output();
     init_runtime();
     INDEX_PROGRESS_OUTPUT_INTERVAL_MS2 = 6e3;
@@ -6300,7 +6634,9 @@ __export(object_metadata_exports, {
   runObjectMetadataCommand: () => runObjectMetadataCommand
 });
 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(
@@ -6431,6 +6767,7 @@ var init_object_metadata = __esm({
     import_promises5 = require("fs/promises");
     init_context();
     init_support();
+    init_archive_target();
     init_support();
   }
 });
@@ -6564,11 +6901,11 @@ function formatProgressTokenMetrics(tokens) {
   ];
   return metrics.length === 0 ? void 0 : { metrics, name: "tokens" };
 }
-var import_wiki_graph_sdk27, PROGRESS_OUTPUT_INTERVAL_MS;
+var import_wiki_graph_sdk29, PROGRESS_OUTPUT_INTERVAL_MS;
 var init_watch = __esm({
   "src/commands/queue/watch.ts"() {
     "use strict";
-    import_wiki_graph_sdk27 = require("wiki-graph-sdk");
+    import_wiki_graph_sdk29 = require("wiki-graph-sdk");
     init_runtime();
     init_context();
     PROGRESS_OUTPUT_INTERVAL_MS = 6e3;
@@ -6582,7 +6919,7 @@ async function runQueueWorker() {
   process.once("SIGINT", stop);
   process.once("SIGTERM", stop);
   try {
-    await (0, import_wiki_graph_sdk28.runWikiGraphQueueWorker)({ signal: controller.signal });
+    await (0, import_wiki_graph_sdk30.runWikiGraphQueueWorker)({ signal: controller.signal });
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     throw new Error(withHelpRoute(message, CLI_HELP_ROUTES.config), {
@@ -6593,11 +6930,11 @@ async function runQueueWorker() {
     process.removeListener("SIGTERM", stop);
   }
 }
-var import_wiki_graph_sdk28;
+var import_wiki_graph_sdk30;
 var init_worker = __esm({
   "src/commands/queue/worker.ts"() {
     "use strict";
-    import_wiki_graph_sdk28 = require("wiki-graph-sdk");
+    import_wiki_graph_sdk30 = require("wiki-graph-sdk");
     init_support();
   }
 });
@@ -6661,7 +6998,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 }
       );
@@ -6713,7 +7050,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 },
@@ -6730,11 +7067,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();
   }
 });
@@ -6750,10 +7087,10 @@ module.exports = __toCommonJS(src_exports);
 
 // src/app/runner.ts
 var import_stream2 = require("stream");
-var import_wiki_graph_sdk30 = require("wiki-graph-sdk");
+var import_wiki_graph_sdk32 = require("wiki-graph-sdk");
 
 // src/args/help.ts
-var import_wiki_graph_sdk5 = require("wiki-graph-sdk");
+var import_wiki_graph_sdk6 = require("wiki-graph-sdk");
 var import_fs3 = require("fs");
 var import_path5 = require("path");
 init_command();
@@ -6763,7 +7100,7 @@ init_support();
 init_support();
 
 // src/args/uri/chapter/target.ts
-var import_wiki_graph_sdk4 = require("wiki-graph-sdk");
+var import_wiki_graph_sdk5 = require("wiki-graph-sdk");
 
 // src/args/uri/triple-pattern.ts
 function parseTriplePatternObjectUri(objectUri) {
@@ -6910,7 +7247,7 @@ function parseChapterPathAndSuffix(value) {
   );
   const pathParts = suffixStart === -1 ? parts : parts.slice(0, suffixStart);
   const suffixParts = suffixStart === -1 ? [] : parts.slice(suffixStart);
-  const chapterPath = (0, import_wiki_graph_sdk4.parseChapterPath)(pathParts.join("/"), "chapter URI");
+  const chapterPath = (0, import_wiki_graph_sdk5.parseChapterPath)(pathParts.join("/"), "chapter URI");
   return {
     chapterPath,
     ...suffixParts.length === 0 ? {} : { suffix: suffixParts.join("/") }
@@ -7176,7 +7513,7 @@ function formatHelpCommandUri(uri) {
   return formatShellArgument(uri);
 }
 function formatLibraryHelpUri(fallbackUri, target) {
-  const scopeUri = (0, import_wiki_graph_sdk5.formatWikiGraphLibraryUri)(target.publicId);
+  const scopeUri = (0, import_wiki_graph_sdk6.formatWikiGraphLibraryUri)(target.publicId);
   switch (target.kind) {
     case "archive":
       if (target.archivePublicId === void 0) {
@@ -7249,7 +7586,7 @@ function requireUriHelpTarget(name) {
 function getLibraryHelpContext(uri) {
   const target = (() => {
     try {
-      return (0, import_wiki_graph_sdk5.parseWikiGraphLibraryUri)(uri);
+      return (0, import_wiki_graph_sdk6.parseWikiGraphLibraryUri)(uri);
     } catch {
       return void 0;
     }
@@ -7276,7 +7613,7 @@ function getUriHelpContext(uri) {
 }
 function getHelpObjectUri(uri) {
   try {
-    const libraryTarget = (0, import_wiki_graph_sdk5.parseWikiGraphLibraryUri)(uri);
+    const libraryTarget = (0, import_wiki_graph_sdk6.parseWikiGraphLibraryUri)(uri);
     if (libraryTarget?.objectUri !== void 0) {
       return libraryTarget.objectUri;
     }
@@ -7300,7 +7637,7 @@ function renderHelpTemplate(templateName, extraContext = {}) {
   });
 }
 function getHelpTemplateEnvironment() {
-  helpTemplateEnvironment ??= (0, import_wiki_graph_sdk5.createNodeTemplateEnvironment)(
+  helpTemplateEnvironment ??= (0, import_wiki_graph_sdk6.createNodeTemplateEnvironment)(
     resolveCLIDataDirectory(),
     {
       autoescape: false
@@ -7333,7 +7670,7 @@ function resolveCLIDataDirectory() {
 
 // src/args/archive.ts
 init_support();
-var import_wiki_graph_sdk9 = require("wiki-graph-sdk");
+var import_wiki_graph_sdk10 = require("wiki-graph-sdk");
 
 // src/args/helper/actions.ts
 init_support();
@@ -7347,13 +7684,13 @@ function isArchiveMaintenanceCommand(value) {
 }
 
 // src/args/helper/chapter/ids.ts
-var import_wiki_graph_sdk7 = require("wiki-graph-sdk");
+var import_wiki_graph_sdk8 = require("wiki-graph-sdk");
 init_support();
 
 // src/args/helper/uri.ts
 init_support();
 init_local_config();
-var import_wiki_graph_sdk6 = require("wiki-graph-sdk");
+var import_wiki_graph_sdk7 = require("wiki-graph-sdk");
 function validateArchiveCommandUriInput(action, value) {
   if (action === "create" || action === "export" || action === "inspect" || action === "next") {
     return;
@@ -7523,7 +7860,7 @@ function formatMissingArchiveInputMessage(action) {
   }
 }
 function isWikiGraphUri(value) {
-  return value?.startsWith(import_wiki_graph_sdk6.WIKI_GRAPH_URI_PREFIX) === true;
+  return value?.startsWith(import_wiki_graph_sdk7.WIKI_GRAPH_URI_PREFIX) === true;
 }
 function stripObjectUriPrefix(objectUri) {
   const prefix = getWikiGraphUriPrefix(objectUri);
@@ -7586,8 +7923,8 @@ function parseWikiGraphJobTargetUri(uri) {
   return jobId;
 }
 function getWikiGraphUriPrefix(uri) {
-  if (uri.startsWith(import_wiki_graph_sdk6.WIKI_GRAPH_URI_PREFIX)) {
-    return import_wiki_graph_sdk6.WIKI_GRAPH_URI_PREFIX;
+  if (uri.startsWith(import_wiki_graph_sdk7.WIKI_GRAPH_URI_PREFIX)) {
+    return import_wiki_graph_sdk7.WIKI_GRAPH_URI_PREFIX;
   }
   return void 0;
 }
@@ -7613,7 +7950,7 @@ function parseWikiGraphPath(value) {
     return void 0;
   }
   try {
-    const parsed = (0, import_wiki_graph_sdk6.parseWikiGraphUriSyntax)(value);
+    const parsed = (0, import_wiki_graph_sdk7.parseWikiGraphUriSyntax)(value);
     return parsed.protocol === "wikg" ? parsed.path : void 0;
   } catch {
     return void 0;
@@ -7634,7 +7971,7 @@ function parseChapterPathRef(value, flag, archivePath, helpRoute) {
   const normalized = value.trim();
   try {
     if (!isWikiGraphUri(normalized)) {
-      return (0, import_wiki_graph_sdk7.parseChapterPath)(normalized, flag);
+      return (0, import_wiki_graph_sdk8.parseChapterPath)(normalized, flag);
     }
     const parsed = parseLocatedWikiGraphUri(normalized);
     if (parsed.archivePath !== void 0 && parsed.archivePath !== archivePath) {
@@ -7642,7 +7979,7 @@ function parseChapterPathRef(value, flag, archivePath, helpRoute) {
         `Invalid ${flag}: ${value}. Chapter URI belongs to a different archive.`
       );
     }
-    const path = (0, import_wiki_graph_sdk7.parseChapterUriPath)(parsed.objectUri ?? normalized);
+    const path = (0, import_wiki_graph_sdk8.parseChapterUriPath)(parsed.objectUri ?? normalized);
     if (path === void 0) {
       throw new Error(
         `Invalid ${flag}: ${value}. Expected a chapter path or URI.`
@@ -8272,7 +8609,7 @@ function parseBuildJobTarget(value) {
 
 // src/args/helper/flags.ts
 init_support();
-var import_wiki_graph_sdk8 = require("wiki-graph-sdk");
+var import_wiki_graph_sdk9 = require("wiki-graph-sdk");
 function rejectArchiveChapterFlag(name, value, helpRoute) {
   if (value !== void 0) {
     throw new Error(
@@ -8312,7 +8649,7 @@ function rejectNonCreateReplaceFlag(positionals, values) {
     return;
   }
   const [command, action] = positionals;
-  if (command?.startsWith(import_wiki_graph_sdk8.WIKI_GRAPH_URI_PREFIX) === true && action === "create") {
+  if (command?.startsWith(import_wiki_graph_sdk9.WIKI_GRAPH_URI_PREFIX) === true && action === "create") {
     return;
   }
   throw new Error(
@@ -9215,14 +9552,14 @@ function rejectNonQuerySkipUnindexedFlag(action, values, helpRoute) {
 
 // src/args/parse.ts
 var import_util = require("util");
-var import_wiki_graph_sdk13 = require("wiki-graph-sdk");
+var import_wiki_graph_sdk14 = require("wiki-graph-sdk");
 init_support();
 
 // src/args/queue.ts
 init_support();
 
 // src/args/uri/chapter/routing.ts
-var import_wiki_graph_sdk10 = require("wiki-graph-sdk");
+var import_wiki_graph_sdk11 = require("wiki-graph-sdk");
 init_support();
 function parseArchiveChapterUriArguments(uri, archivePath, target, action, tail, values) {
   const helpRoute = formatWikiGraphHelpCommand(uri, action);
@@ -9502,7 +9839,7 @@ function parseSingleChapterUriArguments(archivePath, chapterPath, action, tail,
     case "list":
       return parseArchiveArguments(
         action,
-        [(0, import_wiki_graph_sdk10.formatLocatedChapterUri)(archivePath, chapterPath), ...tail],
+        [(0, import_wiki_graph_sdk11.formatLocatedChapterUri)(archivePath, chapterPath), ...tail],
         values,
         helpRoute
       );
@@ -9598,7 +9935,7 @@ function parseChapterResourceUriArguments(uri, archivePath, chapterPath, resourc
     return parseArchiveArguments(
       action,
       [
-        resource === "source" || resource === "summary" ? formatChapterScopedArchiveUri(archivePath, chapterPath) : (0, import_wiki_graph_sdk10.formatLocatedChapterUri)(archivePath, chapterPath),
+        resource === "source" || resource === "summary" ? formatChapterScopedArchiveUri(archivePath, chapterPath) : (0, import_wiki_graph_sdk11.formatLocatedChapterUri)(archivePath, chapterPath),
         ...tail
       ],
       values,
@@ -9631,7 +9968,7 @@ function parseChapterResourceUriArguments(uri, archivePath, chapterPath, resourc
     );
   }
   if (action === "get") {
-    const objectUri = uri.includes("#") && (resource === "source" || resource === "summary") ? uri : isLibraryArchiveLocator(archivePath) ? uri : resource === "source" ? (0, import_wiki_graph_sdk10.formatLocatedChapterSourceCollectionUri)(archivePath, chapterPath) : (0, import_wiki_graph_sdk10.formatLocatedChapterResourceUri)(
+    const objectUri = uri.includes("#") && (resource === "source" || resource === "summary") ? uri : isLibraryArchiveLocator(archivePath) ? uri : resource === "source" ? (0, import_wiki_graph_sdk11.formatLocatedChapterSourceCollectionUri)(archivePath, chapterPath) : (0, import_wiki_graph_sdk11.formatLocatedChapterResourceUri)(
       archivePath,
       chapterPath,
       resource
@@ -9657,7 +9994,7 @@ function parseChapterResourceUriArguments(uri, archivePath, chapterPath, resourc
   );
 }
 function formatChapterScopedArchiveUri(archivePath, chapterPath) {
-  return isLibraryArchiveLocator(archivePath) ? `${archivePath}/chapter/${chapterPath}` : (0, import_wiki_graph_sdk10.formatLocatedChapterUri)(archivePath, chapterPath);
+  return isLibraryArchiveLocator(archivePath) ? `${archivePath}/chapter/${chapterPath}` : (0, import_wiki_graph_sdk11.formatLocatedChapterUri)(archivePath, chapterPath);
 }
 function isLibraryArchiveLocator(archivePath) {
   return archivePath.startsWith("wikg://lib/arc/") || /^wikg:\/\/lib\/[^/]+\/arc\//u.test(archivePath);
@@ -9709,7 +10046,7 @@ function parseArchiveChapterLikeArguments(action, archivePath, tail, values, hel
 }
 
 // src/args/uri/entry.ts
-var import_wiki_graph_sdk11 = require("wiki-graph-sdk");
+var import_wiki_graph_sdk12 = require("wiki-graph-sdk");
 init_support();
 
 // src/args/uri/archive-objects.ts
@@ -10305,7 +10642,7 @@ function parseArchiveUriTargetArguments(uri, action, tail, values) {
   return parseArchiveArguments(action, [uri, ...tail], values, helpRoute);
 }
 function parseLibraryArchiveObjectTarget(uri) {
-  const target = (0, import_wiki_graph_sdk11.parseWikiGraphLibraryUri)(uri);
+  const target = (0, import_wiki_graph_sdk12.parseWikiGraphLibraryUri)(uri);
   if (target?.kind === "archive" && target.objectUri !== void 0) {
     return target;
   }
@@ -11158,9 +11495,9 @@ function parseTransformArguments(positionals, values) {
 }
 
 // src/args/uri/library.ts
-var import_wiki_graph_sdk12 = require("wiki-graph-sdk");
+var import_wiki_graph_sdk13 = require("wiki-graph-sdk");
 init_support();
-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"]);
@@ -11189,7 +11526,7 @@ function parseLibraryUriFirstArguments(positionals, values) {
   if (uri === void 0) {
     throw new Error("Internal error: missing library URI.");
   }
-  const target = (0, import_wiki_graph_sdk12.parseWikiGraphLibraryUri)(uri);
+  const target = (0, import_wiki_graph_sdk13.parseWikiGraphLibraryUri)(uri);
   if (target === void 0) {
     throw new Error(`Expected a Wiki Graph library URI: ${uri}`);
   }
@@ -11867,10 +12204,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);
@@ -11967,6 +12316,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."
@@ -12034,6 +12384,7 @@ function parseLibraryMetadataArguments(uri, target, action, tail, values) {
     case "create":
     case "list":
     case "remove":
+    case "replace":
     case "add":
     case "rebind":
     case "clean-index":
@@ -12078,7 +12429,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)) {
@@ -12454,7 +12805,7 @@ function parseCLIArguments(argv = process.argv.slice(2)) {
     );
     return parseLocalConfigUriFirstArguments(positionals, values);
   }
-  if ((0, import_wiki_graph_sdk13.isWikiGraphLibraryUri)(positionals[0])) {
+  if ((0, import_wiki_graph_sdk14.isWikiGraphLibraryUri)(positionals[0])) {
     return parseLibraryUriFirstArguments(positionals, values);
   }
   if (isWikiGraphUri(positionals[0])) {
@@ -12484,7 +12835,7 @@ function rejectNonWikiGraphSkipUnindexedFlag(positionals, values) {
     return;
   }
   const command = positionals[0];
-  if (command !== void 0 && (isWikiGraphUri(command) || (0, import_wiki_graph_sdk13.isWikiGraphLibraryUri)(command))) {
+  if (command !== void 0 && (isWikiGraphUri(command) || (0, import_wiki_graph_sdk14.isWikiGraphLibraryUri)(command))) {
     return;
   }
   throw new Error(
@@ -12553,7 +12904,7 @@ async function runQueueCommand2(args) {
 init_support();
 init_support();
 init_home_target();
-var import_wiki_graph_sdk29 = require("wiki-graph-sdk");
+var import_wiki_graph_sdk31 = require("wiki-graph-sdk");
 init_context();
 async function dispatchWikiGraphCLI(input) {
   try {
@@ -12640,10 +12991,10 @@ function shouldPrintDefaultHelp(argv, stdinIsTTY) {
   return argv.length === 0 && stdinIsTTY === true;
 }
 function formatCLIError(error, argv) {
-  if (error instanceof import_wiki_graph_sdk29.LLMPaymentRequiredError) {
+  if (error instanceof import_wiki_graph_sdk31.LLMPaymentRequiredError) {
     return "LLM payment required. Check your provider billing status or account balance.";
   }
-  const message = formatTerminalRemediation(error, (0, import_wiki_graph_sdk29.formatError)(error));
+  const message = formatTerminalRemediation(error, (0, import_wiki_graph_sdk31.formatError)(error));
   const relativeResolution = hasErrorCode(error, "ENOENT") ? getRelativeArchiveUriResolution(argv[0] ?? "") : void 0;
   if (relativeResolution === void 0) {
     return message;
@@ -12656,7 +13007,7 @@ Resolved archive path:
 See: wg help uri`;
 }
 function formatTerminalRemediation(error, message) {
-  if (error instanceof import_wiki_graph_sdk29.WikiGraphError) {
+  if (error instanceof import_wiki_graph_sdk31.WikiGraphError) {
     const chapterId = error.details.chapterId;
     switch (error.code) {
       case "chapter_has_children":
@@ -12700,7 +13051,7 @@ function createCLIErrorObject(error, argv) {
   return {
     error: {
       message: formatCLIError(error, argv),
-      type: error instanceof import_wiki_graph_sdk29.LLMPaymentRequiredError ? "llm_payment_required" : "error"
+      type: error instanceof import_wiki_graph_sdk31.LLMPaymentRequiredError ? "llm_payment_required" : "error"
     }
   };
 }
@@ -12758,7 +13109,7 @@ async function runWikiGraphCLIWithEntryPolicy(input = {}, envPolicy) {
     envPolicy: entryContext.envPolicy,
     exitCode: 0,
     queueAutostart: true,
-    sdk: (0, import_wiki_graph_sdk30.createWikiGraphSDK)({
+    sdk: (0, import_wiki_graph_sdk32.createWikiGraphSDK)({
       cwd: input.cwd ?? process.cwd(),
       env: entryContext.env,
       envPolicy: entryContext.envPolicy,
@@ -12869,8 +13220,9 @@ var CaptureWritable = class extends import_stream2.Writable {
   }
 };
 
-// src/app/main.ts
-init_node_platform();
+// src/runtime/node-platform.ts
+var node_platform_exports = {};
+__reExport(node_platform_exports, require("wiki-graph-sdk/node-platform"));
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createWikiGraphCLI,