wiki-graph-core 0.3.1 → 0.4.0

package/dist/runtime/common/tinyld-language.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/runtime/common/tinyld-language.ts"],"sourcesContent":["import { detect, validateISO2 } from \"tinyld\";\n\nimport { getLanguageCode, type Language } from \"./language.js\";\n\nexport function detectLanguageCode(text: string): string | undefined {\n  const normalizedText = text.trim();\n\n  if (normalizedText === \"\") {\n    return undefined;\n  }\n\n  try {\n    return normalizeLanguageCode(detect(normalizedText));\n  } catch {\n    return undefined;\n  }\n}\n\nexport function getLanguageDetectionCode(language: Language): string {\n  return getLanguageCode(language);\n}\n\nfunction normalizeLanguageCode(languageCode: string): string | undefined {\n  const normalizedLanguageCode = languageCode.trim().toLowerCase();\n  const directLanguageCode = validateISO2(normalizedLanguageCode);\n\n  if (directLanguageCode !== \"\") {\n    return directLanguageCode;\n  }\n\n  const baseLanguageCode = normalizedLanguageCode.split(\"-\")[0];\n\n  if (baseLanguageCode === undefined) {\n    return undefined;\n  }\n\n  const validatedBaseLanguageCode = validateISO2(baseLanguageCode);\n\n  return validatedBaseLanguageCode === \"\"\n    ? undefined\n    : validatedBaseLanguageCode;\n}\n"],"mappings":"AAAA,SAAS,QAAQ,oBAAoB;AAErC,SAAS,uBAAsC;AAExC,SAAS,mBAAmB,MAAkC;AACnE,QAAM,iBAAiB,KAAK,KAAK;AAEjC,MAAI,mBAAmB,IAAI;AACzB,WAAO;AAAA,EACT;AAEA,MAAI;AACF,WAAO,sBAAsB,OAAO,cAAc,CAAC;AAAA,EACrD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEO,SAAS,yBAAyB,UAA4B;AACnE,SAAO,gBAAgB,QAAQ;AACjC;AAEA,SAAS,sBAAsB,cAA0C;AACvE,QAAM,yBAAyB,aAAa,KAAK,EAAE,YAAY;AAC/D,QAAM,qBAAqB,aAAa,sBAAsB;AAE9D,MAAI,uBAAuB,IAAI;AAC7B,WAAO;AAAA,EACT;AAEA,QAAM,mBAAmB,uBAAuB,MAAM,GAAG,EAAE,CAAC;AAE5D,MAAI,qBAAqB,QAAW;AAClC,WAAO;AAAA,EACT;AAEA,QAAM,4BAA4B,aAAa,gBAAgB;AAE/D,SAAO,8BAA8B,KACjC,SACA;AACN;","names":[]}

package/dist/runtime/common/wiki-graph/dir.d.ts

@@ -0,0 +1,19 @@
+declare function resolveWikiGraphHomeDirectoryPath(): string;
+declare function setWikiGraphStateDirectoryPathForTesting(path: string | undefined): void;
+declare function withWikiGraphStateDirectoryPathForTesting<T>(path: string | undefined, operation: () => Promise<T> | T): Promise<T>;
+declare function withWikiGraphRuntimeStateDirectoryPath<T>(path: string | undefined, operation: () => Promise<T> | T): Promise<T>;
+/**
+ * @deprecated Runtime state overrides are no longer read from process-style
+ * environment objects. Use `withWikiGraphRuntimeStateDirectoryPath` instead.
+ */
+declare function withWikiGraphRuntimeEnvironment<T>(_environment: NodeJS.ProcessEnv, operation: () => Promise<T> | T): Promise<T>;
+declare function getWikiGraphStateDirectoryPathForTesting(): string | undefined;
+declare function resolveWikiGraphCoreDatabasePath(): string;
+declare function resolveWikiGraphCacheDirectoryPath(): string;
+declare function resolveWikiGraphCacheDatabasePath(): string;
+declare function resolveWikiGraphJobsDirectoryPath(): string;
+declare function resolveWikiGraphStagingDirectoryPath(): string;
+declare function resolveWikiGraphTempRootDirectoryPath(): string;
+declare function resolveWikiGraphLogsDirectoryPath(): string;
+
+export { getWikiGraphStateDirectoryPathForTesting, resolveWikiGraphCacheDatabasePath, resolveWikiGraphCacheDirectoryPath, resolveWikiGraphCoreDatabasePath, resolveWikiGraphHomeDirectoryPath, resolveWikiGraphJobsDirectoryPath, resolveWikiGraphLogsDirectoryPath, resolveWikiGraphStagingDirectoryPath, resolveWikiGraphTempRootDirectoryPath, setWikiGraphStateDirectoryPathForTesting, withWikiGraphRuntimeEnvironment, withWikiGraphRuntimeStateDirectoryPath, withWikiGraphStateDirectoryPathForTesting };

package/dist/runtime/common/wiki-graph/dir.js

@@ -0,0 +1,68 @@
+import { AsyncLocalStorage } from "async_hooks";
+import { homedir } from "os";
+import { join, resolve } from "path";
+const testingStateDirectoryPath = new AsyncLocalStorage();
+const runtimeStateDirectoryPath = new AsyncLocalStorage();
+function resolveWikiGraphHomeDirectoryPath() {
+  const testingStateDirPath = testingStateDirectoryPath.getStore()?.path;
+  if (testingStateDirPath !== void 0 && testingStateDirPath.trim() !== "") {
+    return resolve(testingStateDirPath);
+  }
+  const runtimeStateDirPath = runtimeStateDirectoryPath.getStore()?.path;
+  if (runtimeStateDirPath !== void 0 && runtimeStateDirPath.trim() !== "") {
+    return resolve(runtimeStateDirPath);
+  }
+  return join(homedir(), ".wikigraph");
+}
+function setWikiGraphStateDirectoryPathForTesting(path) {
+  testingStateDirectoryPath.enterWith({ path });
+}
+async function withWikiGraphStateDirectoryPathForTesting(path, operation) {
+  return await testingStateDirectoryPath.run({ path }, operation);
+}
+async function withWikiGraphRuntimeStateDirectoryPath(path, operation) {
+  return await runtimeStateDirectoryPath.run({ path }, operation);
+}
+async function withWikiGraphRuntimeEnvironment(_environment, operation) {
+  return await operation();
+}
+function getWikiGraphStateDirectoryPathForTesting() {
+  return testingStateDirectoryPath.getStore()?.path;
+}
+function resolveWikiGraphCoreDatabasePath() {
+  return join(resolveWikiGraphHomeDirectoryPath(), "core.sqlite");
+}
+function resolveWikiGraphCacheDirectoryPath() {
+  return join(resolveWikiGraphHomeDirectoryPath(), "cache");
+}
+function resolveWikiGraphCacheDatabasePath() {
+  return join(resolveWikiGraphCacheDirectoryPath(), "cache.sqlite");
+}
+function resolveWikiGraphJobsDirectoryPath() {
+  return join(resolveWikiGraphHomeDirectoryPath(), "jobs");
+}
+function resolveWikiGraphStagingDirectoryPath() {
+  return join(resolveWikiGraphHomeDirectoryPath(), "staging");
+}
+function resolveWikiGraphTempRootDirectoryPath() {
+  return join(resolveWikiGraphHomeDirectoryPath(), "tmp");
+}
+function resolveWikiGraphLogsDirectoryPath() {
+  return join(resolveWikiGraphHomeDirectoryPath(), "logs");
+}
+export {
+  getWikiGraphStateDirectoryPathForTesting,
+  resolveWikiGraphCacheDatabasePath,
+  resolveWikiGraphCacheDirectoryPath,
+  resolveWikiGraphCoreDatabasePath,
+  resolveWikiGraphHomeDirectoryPath,
+  resolveWikiGraphJobsDirectoryPath,
+  resolveWikiGraphLogsDirectoryPath,
+  resolveWikiGraphStagingDirectoryPath,
+  resolveWikiGraphTempRootDirectoryPath,
+  setWikiGraphStateDirectoryPathForTesting,
+  withWikiGraphRuntimeEnvironment,
+  withWikiGraphRuntimeStateDirectoryPath,
+  withWikiGraphStateDirectoryPathForTesting
+};
+//# sourceMappingURL=dir.js.map

package/dist/runtime/common/wiki-graph/dir.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/runtime/common/wiki-graph/dir.ts"],"sourcesContent":["import { AsyncLocalStorage } from \"async_hooks\";\nimport { homedir } from \"os\";\nimport { join, resolve } from \"path\";\n\nconst testingStateDirectoryPath = new AsyncLocalStorage<{\n  readonly path: string | undefined;\n}>();\nconst runtimeStateDirectoryPath = new AsyncLocalStorage<{\n  readonly path: string | undefined;\n}>();\n\nexport function resolveWikiGraphHomeDirectoryPath(): string {\n  const testingStateDirPath = testingStateDirectoryPath.getStore()?.path;\n\n  if (testingStateDirPath !== undefined && testingStateDirPath.trim() !== \"\") {\n    return resolve(testingStateDirPath);\n  }\n\n  const runtimeStateDirPath = runtimeStateDirectoryPath.getStore()?.path;\n\n  if (runtimeStateDirPath !== undefined && runtimeStateDirPath.trim() !== \"\") {\n    return resolve(runtimeStateDirPath);\n  }\n\n  return join(homedir(), \".wikigraph\");\n}\n\nexport function setWikiGraphStateDirectoryPathForTesting(\n  path: string | undefined,\n): void {\n  testingStateDirectoryPath.enterWith({ path });\n}\n\nexport async function withWikiGraphStateDirectoryPathForTesting<T>(\n  path: string | undefined,\n  operation: () => Promise<T> | T,\n): Promise<T> {\n  return await testingStateDirectoryPath.run({ path }, operation);\n}\n\nexport async function withWikiGraphRuntimeStateDirectoryPath<T>(\n  path: string | undefined,\n  operation: () => Promise<T> | T,\n): Promise<T> {\n  return await runtimeStateDirectoryPath.run({ path }, operation);\n}\n\n/**\n * @deprecated Runtime state overrides are no longer read from process-style\n * environment objects. Use `withWikiGraphRuntimeStateDirectoryPath` instead.\n */\nexport async function withWikiGraphRuntimeEnvironment<T>(\n  _environment: NodeJS.ProcessEnv,\n  operation: () => Promise<T> | T,\n): Promise<T> {\n  return await operation();\n}\n\nexport function getWikiGraphStateDirectoryPathForTesting(): string | undefined {\n  return testingStateDirectoryPath.getStore()?.path;\n}\n\nexport function resolveWikiGraphCoreDatabasePath(): string {\n  return join(resolveWikiGraphHomeDirectoryPath(), \"core.sqlite\");\n}\n\nexport function resolveWikiGraphCacheDirectoryPath(): string {\n  return join(resolveWikiGraphHomeDirectoryPath(), \"cache\");\n}\n\nexport function resolveWikiGraphCacheDatabasePath(): string {\n  return join(resolveWikiGraphCacheDirectoryPath(), \"cache.sqlite\");\n}\n\nexport function resolveWikiGraphJobsDirectoryPath(): string {\n  return join(resolveWikiGraphHomeDirectoryPath(), \"jobs\");\n}\n\nexport function resolveWikiGraphStagingDirectoryPath(): string {\n  return join(resolveWikiGraphHomeDirectoryPath(), \"staging\");\n}\n\nexport function resolveWikiGraphTempRootDirectoryPath(): string {\n  return join(resolveWikiGraphHomeDirectoryPath(), \"tmp\");\n}\n\nexport function resolveWikiGraphLogsDirectoryPath(): string {\n  return join(resolveWikiGraphHomeDirectoryPath(), \"logs\");\n}\n"],"mappings":"AAAA,SAAS,yBAAyB;AAClC,SAAS,eAAe;AACxB,SAAS,MAAM,eAAe;AAE9B,MAAM,4BAA4B,IAAI,kBAEnC;AACH,MAAM,4BAA4B,IAAI,kBAEnC;AAEI,SAAS,oCAA4C;AAC1D,QAAM,sBAAsB,0BAA0B,SAAS,GAAG;AAElE,MAAI,wBAAwB,UAAa,oBAAoB,KAAK,MAAM,IAAI;AAC1E,WAAO,QAAQ,mBAAmB;AAAA,EACpC;AAEA,QAAM,sBAAsB,0BAA0B,SAAS,GAAG;AAElE,MAAI,wBAAwB,UAAa,oBAAoB,KAAK,MAAM,IAAI;AAC1E,WAAO,QAAQ,mBAAmB;AAAA,EACpC;AAEA,SAAO,KAAK,QAAQ,GAAG,YAAY;AACrC;AAEO,SAAS,yCACd,MACM;AACN,4BAA0B,UAAU,EAAE,KAAK,CAAC;AAC9C;AAEA,eAAsB,0CACpB,MACA,WACY;AACZ,SAAO,MAAM,0BAA0B,IAAI,EAAE,KAAK,GAAG,SAAS;AAChE;AAEA,eAAsB,uCACpB,MACA,WACY;AACZ,SAAO,MAAM,0BAA0B,IAAI,EAAE,KAAK,GAAG,SAAS;AAChE;AAMA,eAAsB,gCACpB,cACA,WACY;AACZ,SAAO,MAAM,UAAU;AACzB;AAEO,SAAS,2CAA+D;AAC7E,SAAO,0BAA0B,SAAS,GAAG;AAC/C;AAEO,SAAS,mCAA2C;AACzD,SAAO,KAAK,kCAAkC,GAAG,aAAa;AAChE;AAEO,SAAS,qCAA6C;AAC3D,SAAO,KAAK,kCAAkC,GAAG,OAAO;AAC1D;AAEO,SAAS,oCAA4C;AAC1D,SAAO,KAAK,mCAAmC,GAAG,cAAc;AAClE;AAEO,SAAS,oCAA4C;AAC1D,SAAO,KAAK,kCAAkC,GAAG,MAAM;AACzD;AAEO,SAAS,uCAA+C;AAC7D,SAAO,KAAK,kCAAkC,GAAG,SAAS;AAC5D;AAEO,SAAS,wCAAgD;AAC9D,SAAO,KAAK,kCAAkC,GAAG,KAAK;AACxD;AAEO,SAAS,oCAA4C;AAC1D,SAAO,KAAK,kCAAkC,GAAG,MAAM;AACzD;","names":[]}

package/dist/runtime/common/wiki-graph/index.d.ts

@@ -0,0 +1,3 @@
+export { getWikiGraphStateDirectoryPathForTesting, resolveWikiGraphCacheDatabasePath, resolveWikiGraphCacheDirectoryPath, resolveWikiGraphCoreDatabasePath, resolveWikiGraphHomeDirectoryPath, resolveWikiGraphJobsDirectoryPath, resolveWikiGraphLogsDirectoryPath, resolveWikiGraphStagingDirectoryPath, resolveWikiGraphTempRootDirectoryPath, setWikiGraphStateDirectoryPathForTesting, withWikiGraphRuntimeEnvironment, withWikiGraphRuntimeStateDirectoryPath, withWikiGraphStateDirectoryPathForTesting } from './dir.js';
+export { WikiGraphTempCategory, createWikiGraphTempDirectory, resolveWikiGraphStateRootPath, resolveWikiGraphTempDirectoryPath } from './temp.js';
+export { LocatedWikiGraphUri, ParsedWikiGraphUri, WIKI_GRAPH_ARCHIVE_EXTENSION, WIKI_GRAPH_JOB_URI_PREFIX, WIKI_GRAPH_URI_PREFIX, formatLocatedChapterResourceUri, formatLocatedChapterSourceCollectionUri, formatLocatedChapterUri, formatLocatedWikiGraphUri, formatWikiGraphCommandUri, formatWikiGraphObjectUri, formatWikiGraphUriExpectedError, isWikiGraphJobUri, isWikiGraphUri, parseLocatedWikiGraphUri, parseWikiGraphUriSyntax, requireArchiveUri, requireLocatedObjectOrArchiveUri, requireLocatedObjectUri } from './uri.js';

package/dist/runtime/common/wiki-graph/index.js

@@ -0,0 +1,4 @@
+export * from "./dir.js";
+export * from "./temp.js";
+export * from "./uri.js";
+//# sourceMappingURL=index.js.map

package/dist/runtime/common/wiki-graph/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/runtime/common/wiki-graph/index.ts"],"sourcesContent":["export * from \"./dir.js\";\nexport * from \"./temp.js\";\nexport * from \"./uri.js\";\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}

package/dist/runtime/common/wiki-graph/temp.js

@@ -0,0 +1,21 @@
+import { mkdir, mkdtemp } from "fs/promises";
+import { join } from "path";
+import { resolveWikiGraphTempRootDirectoryPath } from "./dir.js";
+function resolveWikiGraphStateRootPath() {
+  return resolveWikiGraphTempRootDirectoryPath();
+}
+function resolveWikiGraphTempDirectoryPath(category) {
+  const rootPath = resolveWikiGraphStateRootPath();
+  return category === void 0 ? rootPath : join(rootPath, category);
+}
+async function createWikiGraphTempDirectory(category) {
+  const rootPath = resolveWikiGraphTempDirectoryPath(category);
+  await mkdir(rootPath, { recursive: true });
+  return await mkdtemp(join(rootPath, `${category}-`));
+}
+export {
+  createWikiGraphTempDirectory,
+  resolveWikiGraphStateRootPath,
+  resolveWikiGraphTempDirectoryPath
+};
+//# sourceMappingURL=temp.js.map

package/dist/runtime/common/wiki-graph/temp.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/runtime/common/wiki-graph/temp.ts"],"sourcesContent":["import { mkdir, mkdtemp } from \"fs/promises\";\nimport { join } from \"path\";\n\nimport { resolveWikiGraphTempRootDirectoryPath } from \"./dir.js\";\n\nexport type WikiGraphTempCategory =\n  | \"archive-open\"\n  | \"archive-write\"\n  | \"cli-output\"\n  | \"sdpub-upgrade\"\n  | \"stdin-create\"\n  | \"url-create\";\n\nexport function resolveWikiGraphStateRootPath(): string {\n  return resolveWikiGraphTempRootDirectoryPath();\n}\n\nexport function resolveWikiGraphTempDirectoryPath(\n  category?: WikiGraphTempCategory,\n): string {\n  const rootPath = resolveWikiGraphStateRootPath();\n\n  return category === undefined ? rootPath : join(rootPath, category);\n}\n\nexport async function createWikiGraphTempDirectory(\n  category: WikiGraphTempCategory,\n): Promise<string> {\n  const rootPath = resolveWikiGraphTempDirectoryPath(category);\n\n  await mkdir(rootPath, { recursive: true });\n  return await mkdtemp(join(rootPath, `${category}-`));\n}\n"],"mappings":"AAAA,SAAS,OAAO,eAAe;AAC/B,SAAS,YAAY;AAErB,SAAS,6CAA6C;AAU/C,SAAS,gCAAwC;AACtD,SAAO,sCAAsC;AAC/C;AAEO,SAAS,kCACd,UACQ;AACR,QAAM,WAAW,8BAA8B;AAE/C,SAAO,aAAa,SAAY,WAAW,KAAK,UAAU,QAAQ;AACpE;AAEA,eAAsB,6BACpB,UACiB;AACjB,QAAM,WAAW,kCAAkC,QAAQ;AAE3D,QAAM,MAAM,UAAU,EAAE,WAAW,KAAK,CAAC;AACzC,SAAO,MAAM,QAAQ,KAAK,UAAU,GAAG,QAAQ,GAAG,CAAC;AACrD;","names":[]}

package/dist/runtime/common/wiki-graph/uri.d.ts

@@ -0,0 +1,37 @@
+declare const WIKI_GRAPH_URI_PREFIX = "wikg://";
+declare const WIKI_GRAPH_JOB_URI_PREFIX = "wikg://local/job";
+declare const WIKI_GRAPH_ARCHIVE_EXTENSION = ".wikg";
+interface ParsedWikiGraphUri {
+    readonly protocol: string;
+    readonly path: readonly string[];
+    readonly fragment?: number | {
+        readonly begin: number;
+        readonly end: number;
+    };
+}
+interface LocatedWikiGraphUri {
+    readonly archivePath?: string;
+    readonly objectUri?: string;
+}
+declare function isWikiGraphUri(value: string | undefined): value is string;
+declare function isWikiGraphJobUri(value: string | undefined): value is string;
+declare function parseLocatedWikiGraphUri(uri: string): LocatedWikiGraphUri;
+declare function parseWikiGraphUriSyntax(uri: string): ParsedWikiGraphUri;
+declare function formatLocatedWikiGraphUri(archivePath: string, objectUri?: string): string;
+declare function formatWikiGraphCommandUri(archivePath: string, objectUri?: string, cwd?: string): string;
+declare function formatLocatedChapterUri(archivePath: string, chapterPath: string): string;
+declare function formatLocatedChapterResourceUri(archivePath: string, chapterPath: string, resource: "source" | "summary" | "title"): string;
+declare function formatLocatedChapterSourceCollectionUri(archivePath: string, chapterPath: string): string;
+declare function formatWikiGraphObjectUri(path: string, hash?: string): string;
+declare function requireArchiveUri(uri: string): string;
+declare function requireLocatedObjectUri(uri: string): {
+    readonly archivePath: string;
+    readonly objectUri: string;
+};
+declare function requireLocatedObjectOrArchiveUri(uri: string): {
+    readonly archivePath: string;
+    readonly objectUri?: string;
+};
+declare function formatWikiGraphUriExpectedError(value: string): string;
+
+export { type LocatedWikiGraphUri, type ParsedWikiGraphUri, WIKI_GRAPH_ARCHIVE_EXTENSION, WIKI_GRAPH_JOB_URI_PREFIX, WIKI_GRAPH_URI_PREFIX, formatLocatedChapterResourceUri, formatLocatedChapterSourceCollectionUri, formatLocatedChapterUri, formatLocatedWikiGraphUri, formatWikiGraphCommandUri, formatWikiGraphObjectUri, formatWikiGraphUriExpectedError, isWikiGraphJobUri, isWikiGraphUri, parseLocatedWikiGraphUri, parseWikiGraphUriSyntax, requireArchiveUri, requireLocatedObjectOrArchiveUri, requireLocatedObjectUri };

package/dist/runtime/common/wiki-graph/uri.js

@@ -0,0 +1,288 @@
+import { isAbsolute, relative, resolve } from "path";
+import { homedir } from "os";
+import { RESERVED_LIBRARY_URI_SEGMENTS } from "../../../library/segments.js";
+const WIKI_GRAPH_URI_PREFIX = "wikg://";
+const WIKI_GRAPH_JOB_URI_PREFIX = "wikg://local/job";
+const WIKI_GRAPH_ARCHIVE_EXTENSION = ".wikg";
+function isWikiGraphUri(value) {
+  return isWikiGraphUriPrefix(value);
+}
+function isWikiGraphJobUri(value) {
+  return isWikiGraphLocalJobUri(value);
+}
+function parseLocatedWikiGraphUri(uri) {
+  const parsed = parseWikiGraphUriSyntax(uri);
+  if (parsed.protocol !== "wikg") {
+    throw new Error(formatWikiGraphUriExpectedError(uri));
+  }
+  const libraryArchive = parseLibraryArchiveLocatorPath(
+    parsed.path,
+    parsed.fragment
+  );
+  if (libraryArchive !== void 0) {
+    return libraryArchive;
+  }
+  const parts = parsed.path;
+  const archiveIndex = parts.findIndex(
+    (part) => part.endsWith(WIKI_GRAPH_ARCHIVE_EXTENSION)
+  );
+  if (archiveIndex < 0) {
+    return {
+      objectUri: formatWikiGraphObjectUri(
+        parts.join("/"),
+        formatWikiGraphUriFragment(parsed.fragment)
+      )
+    };
+  }
+  const archivePath = formatArchivePathFromUriSegments(
+    parts.slice(0, archiveIndex + 1)
+  );
+  const objectPath = parts.slice(archiveIndex + 1).join("/");
+  if (archivePath === "") {
+    throw new Error(`Invalid Wiki Graph archive URI: ${uri}`);
+  }
+  return {
+    archivePath: resolveArchivePath(archivePath),
+    ...objectPath === "" ? {} : {
+      objectUri: formatWikiGraphObjectUri(
+        objectPath,
+        formatWikiGraphUriFragment(parsed.fragment)
+      )
+    }
+  };
+}
+function parseWikiGraphUriSyntax(uri) {
+  const separatorIndex = uri.indexOf("://");
+  if (separatorIndex <= 0) {
+    throw new Error(formatWikiGraphUriExpectedError(uri));
+  }
+  const protocol = uri.slice(0, separatorIndex);
+  const body = uri.slice(separatorIndex + "://".length);
+  const hashIndex = body.indexOf("#");
+  const rawPath = hashIndex < 0 ? body : body.slice(0, hashIndex);
+  const rawFragment = hashIndex < 0 ? void 0 : body.slice(hashIndex + 1);
+  if (rawFragment?.includes("#") === true) {
+    throw new Error(`Invalid Wiki Graph URI fragment: ${uri}`);
+  }
+  return {
+    protocol,
+    path: parseWikiGraphUriPath(rawPath, uri),
+    ...optionalWikiGraphUriFragment(rawFragment, uri)
+  };
+}
+function parseWikiGraphUriPath(path, uri) {
+  const trimmed = path.replace(/\/+$/u, "");
+  if (trimmed === "") {
+    return [];
+  }
+  if (trimmed.startsWith("/")) {
+    const absoluteTail = trimmed.slice(1);
+    if (absoluteTail === "") {
+      return ["/"];
+    }
+    const segments2 = absoluteTail.split("/");
+    rejectEmptyUriSegments(segments2, uri);
+    return ["/", ...segments2];
+  }
+  const segments = trimmed.split("/");
+  rejectEmptyUriSegments(segments, uri);
+  return segments;
+}
+function rejectEmptyUriSegments(segments, uri) {
+  if (segments.includes("")) {
+    throw new Error(
+      `Invalid Wiki Graph URI path: empty path segment in ${uri}`
+    );
+  }
+}
+function optionalWikiGraphUriFragment(fragment, uri) {
+  if (fragment === void 0) {
+    return {};
+  }
+  if (fragment === "") {
+    throw new Error(`Invalid Wiki Graph URI fragment: ${uri}`);
+  }
+  const range = /^(?<begin>[0-9]+)\.\.(?<end>[0-9]+)$/u.exec(fragment);
+  if (range?.groups !== void 0) {
+    const begin = Number(range.groups.begin);
+    const end = Number(range.groups.end);
+    return { fragment: { begin, end } };
+  }
+  if (/^[0-9]+$/u.test(fragment)) {
+    return { fragment: Number(fragment) };
+  }
+  throw new Error(`Invalid Wiki Graph URI fragment: ${uri}`);
+}
+function parseLibraryArchiveLocatorPath(path, fragment) {
+  if (path[0] !== "lib") {
+    return void 0;
+  }
+  const arcIndex = path[1] === "arc" ? 1 : path[2] === "arc" ? 2 : -1;
+  if (arcIndex < 0) {
+    return void 0;
+  }
+  const library = arcIndex === 2 ? path[1] : void 0;
+  const archive = path[arcIndex + 1];
+  if (archive === void 0 || archive.endsWith(WIKI_GRAPH_ARCHIVE_EXTENSION) || isLibraryScopeSegment(archive)) {
+    return void 0;
+  }
+  const archivePath = `${WIKI_GRAPH_URI_PREFIX}lib/${library === void 0 ? "" : `${library}/`}arc/${archive}`;
+  const objectPath = path.slice(arcIndex + 2).join("/");
+  return {
+    archivePath,
+    ...objectPath === "" ? {} : {
+      objectUri: formatWikiGraphObjectUri(
+        objectPath,
+        formatWikiGraphUriFragment(fragment)
+      )
+    }
+  };
+}
+function formatArchivePathFromUriSegments(segments) {
+  if (segments[0] === "/") {
+    return `/${segments.slice(1).join("/")}`;
+  }
+  return segments.join("/");
+}
+function formatWikiGraphUriFragment(fragment) {
+  if (fragment === void 0) {
+    return void 0;
+  }
+  if (typeof fragment === "number") {
+    return String(fragment);
+  }
+  return `${fragment.begin}..${fragment.end}`;
+}
+function isLibraryScopeSegment(segment) {
+  return RESERVED_LIBRARY_URI_SEGMENTS.has(segment);
+}
+function resolveArchivePath(archivePath) {
+  if (archivePath.startsWith("~/")) {
+    return resolve(homedir(), archivePath.slice(2));
+  }
+  return resolve(archivePath);
+}
+function formatLocatedWikiGraphUri(archivePath, objectUri) {
+  const uriArchivePath = archivePath.replace(/\\/gu, "/");
+  if (objectUri === void 0 || objectUri === WIKI_GRAPH_URI_PREFIX) {
+    return `${WIKI_GRAPH_URI_PREFIX}${uriArchivePath}`;
+  }
+  return `${WIKI_GRAPH_URI_PREFIX}${uriArchivePath}/${stripWikiGraphUriPrefix(
+    objectUri
+  )}`;
+}
+function formatWikiGraphCommandUri(archivePath, objectUri, cwd = process.cwd()) {
+  return formatLocatedWikiGraphUri(
+    formatCommandArchivePath(archivePath, cwd),
+    objectUri
+  );
+}
+function formatCommandArchivePath(archivePath, cwd) {
+  const resolvedCwd = resolve(cwd);
+  const resolvedArchivePath = isAbsolute(archivePath) ? resolve(archivePath) : resolve(resolvedCwd, archivePath);
+  const relativeArchivePath = relative(resolvedCwd, resolvedArchivePath);
+  if (relativeArchivePath !== "" && !relativeArchivePath.startsWith("..") && !isAbsolute(relativeArchivePath)) {
+    return relativeArchivePath;
+  }
+  return resolvedArchivePath;
+}
+function formatLocatedChapterUri(archivePath, chapterPath) {
+  return formatLocatedWikiGraphUri(
+    archivePath,
+    formatWikiGraphObjectUri(`chapter/${chapterPath}`)
+  );
+}
+function formatLocatedChapterResourceUri(archivePath, chapterPath, resource) {
+  return formatLocatedWikiGraphUri(
+    archivePath,
+    formatWikiGraphObjectUri(`chapter/${chapterPath}/${resource}`)
+  );
+}
+function formatLocatedChapterSourceCollectionUri(archivePath, chapterPath) {
+  return formatLocatedWikiGraphUri(
+    archivePath,
+    formatWikiGraphObjectUri(`chapter/${chapterPath}/source`)
+  );
+}
+function formatWikiGraphObjectUri(path, hash) {
+  const normalizedPath = path.replace(/^\/+/u, "").replace(/\/+$/u, "");
+  return `${WIKI_GRAPH_URI_PREFIX}${normalizedPath}${hash === void 0 ? "" : `#${hash}`}`;
+}
+function requireArchiveUri(uri) {
+  const parsed = parseLocatedWikiGraphUri(uri);
+  if (parsed.archivePath === void 0 || parsed.objectUri !== void 0) {
+    throw new Error(
+      `${formatWikiGraphUriExpectedError(uri)} Expected a .wikg archive locator.`
+    );
+  }
+  return parsed.archivePath;
+}
+function requireLocatedObjectUri(uri) {
+  const parsed = parseLocatedWikiGraphUri(uri);
+  if (parsed.archivePath === void 0 || parsed.objectUri === void 0) {
+    throw new Error(
+      `${formatWikiGraphUriExpectedError(uri)} Expected an object URI with a .wikg archive locator.`
+    );
+  }
+  return {
+    archivePath: parsed.archivePath,
+    objectUri: parsed.objectUri
+  };
+}
+function requireLocatedObjectOrArchiveUri(uri) {
+  const parsed = parseLocatedWikiGraphUri(uri);
+  if (parsed.archivePath === void 0) {
+    throw new Error(formatWikiGraphUriExpectedError(uri));
+  }
+  return {
+    archivePath: parsed.archivePath,
+    ...parsed.objectUri === void 0 ? {} : { objectUri: parsed.objectUri }
+  };
+}
+function formatWikiGraphUriExpectedError(value) {
+  const example = value.endsWith(WIKI_GRAPH_ARCHIVE_EXTENSION) && value.startsWith("/") ? `${WIKI_GRAPH_URI_PREFIX}${value}` : "wikg:///absolute/path/book.wikg";
+  return [
+    `Expected a Wiki Graph URI with a .wikg archive locator: ${value}`,
+    `Example: ${example}`,
+    "See: wg help uri"
+  ].join("\n");
+}
+function stripWikiGraphUriPrefix(uri) {
+  const prefix = getWikiGraphUriPrefix(uri);
+  if (prefix === void 0) {
+    throw new Error(`Expected a Wiki Graph object URI: ${uri}`);
+  }
+  return uri.slice(prefix.length).replace(/^\/+/u, "");
+}
+function getWikiGraphUriPrefix(uri) {
+  if (uri.startsWith(WIKI_GRAPH_URI_PREFIX)) {
+    return WIKI_GRAPH_URI_PREFIX;
+  }
+  return void 0;
+}
+function isWikiGraphUriPrefix(value) {
+  return value?.startsWith(WIKI_GRAPH_URI_PREFIX) === true;
+}
+function isWikiGraphLocalJobUri(value) {
+  return value === WIKI_GRAPH_JOB_URI_PREFIX || value?.startsWith(`${WIKI_GRAPH_JOB_URI_PREFIX}/`) === true;
+}
+export {
+  WIKI_GRAPH_ARCHIVE_EXTENSION,
+  WIKI_GRAPH_JOB_URI_PREFIX,
+  WIKI_GRAPH_URI_PREFIX,
+  formatLocatedChapterResourceUri,
+  formatLocatedChapterSourceCollectionUri,
+  formatLocatedChapterUri,
+  formatLocatedWikiGraphUri,
+  formatWikiGraphCommandUri,
+  formatWikiGraphObjectUri,
+  formatWikiGraphUriExpectedError,
+  isWikiGraphJobUri,
+  isWikiGraphUri,
+  parseLocatedWikiGraphUri,
+  parseWikiGraphUriSyntax,
+  requireArchiveUri,
+  requireLocatedObjectOrArchiveUri,
+  requireLocatedObjectUri
+};
+//# sourceMappingURL=uri.js.map

package/dist/runtime/common/wiki-graph/uri.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/runtime/common/wiki-graph/uri.ts"],"sourcesContent":["import { isAbsolute, relative, resolve } from \"path\";\nimport { homedir } from \"os\";\n\nimport { RESERVED_LIBRARY_URI_SEGMENTS } from \"../../../library/segments.js\";\n\nexport const WIKI_GRAPH_URI_PREFIX = \"wikg://\";\nexport const WIKI_GRAPH_JOB_URI_PREFIX = \"wikg://local/job\";\nexport const WIKI_GRAPH_ARCHIVE_EXTENSION = \".wikg\";\n\nexport interface ParsedWikiGraphUri {\n  readonly protocol: string;\n  readonly path: readonly string[];\n  readonly fragment?: number | { readonly begin: number; readonly end: number };\n}\n\nexport interface LocatedWikiGraphUri {\n  readonly archivePath?: string;\n  readonly objectUri?: string;\n}\n\nexport function isWikiGraphUri(value: string | undefined): value is string {\n  return isWikiGraphUriPrefix(value);\n}\n\nexport function isWikiGraphJobUri(value: string | undefined): value is string {\n  return isWikiGraphLocalJobUri(value);\n}\n\nexport function parseLocatedWikiGraphUri(uri: string): LocatedWikiGraphUri {\n  const parsed = parseWikiGraphUriSyntax(uri);\n\n  if (parsed.protocol !== \"wikg\") {\n    throw new Error(formatWikiGraphUriExpectedError(uri));\n  }\n\n  const libraryArchive = parseLibraryArchiveLocatorPath(\n    parsed.path,\n    parsed.fragment,\n  );\n  if (libraryArchive !== undefined) {\n    return libraryArchive;\n  }\n  const parts = parsed.path;\n  const archiveIndex = parts.findIndex((part) =>\n    part.endsWith(WIKI_GRAPH_ARCHIVE_EXTENSION),\n  );\n\n  if (archiveIndex < 0) {\n    return {\n      objectUri: formatWikiGraphObjectUri(\n        parts.join(\"/\"),\n        formatWikiGraphUriFragment(parsed.fragment),\n      ),\n    };\n  }\n\n  const archivePath = formatArchivePathFromUriSegments(\n    parts.slice(0, archiveIndex + 1),\n  );\n  const objectPath = parts.slice(archiveIndex + 1).join(\"/\");\n\n  if (archivePath === \"\") {\n    throw new Error(`Invalid Wiki Graph archive URI: ${uri}`);\n  }\n\n  return {\n    archivePath: resolveArchivePath(archivePath),\n    ...(objectPath === \"\"\n      ? {}\n      : {\n          objectUri: formatWikiGraphObjectUri(\n            objectPath,\n            formatWikiGraphUriFragment(parsed.fragment),\n          ),\n        }),\n  };\n}\n\nexport function parseWikiGraphUriSyntax(uri: string): ParsedWikiGraphUri {\n  const separatorIndex = uri.indexOf(\"://\");\n  if (separatorIndex <= 0) {\n    throw new Error(formatWikiGraphUriExpectedError(uri));\n  }\n\n  const protocol = uri.slice(0, separatorIndex);\n  const body = uri.slice(separatorIndex + \"://\".length);\n  const hashIndex = body.indexOf(\"#\");\n  const rawPath = hashIndex < 0 ? body : body.slice(0, hashIndex);\n  const rawFragment = hashIndex < 0 ? undefined : body.slice(hashIndex + 1);\n\n  if (rawFragment?.includes(\"#\") === true) {\n    throw new Error(`Invalid Wiki Graph URI fragment: ${uri}`);\n  }\n\n  return {\n    protocol,\n    path: parseWikiGraphUriPath(rawPath, uri),\n    ...optionalWikiGraphUriFragment(rawFragment, uri),\n  };\n}\n\nfunction parseWikiGraphUriPath(path: string, uri: string): readonly string[] {\n  const trimmed = path.replace(/\\/+$/u, \"\");\n  if (trimmed === \"\") {\n    return [];\n  }\n\n  if (trimmed.startsWith(\"/\")) {\n    const absoluteTail = trimmed.slice(1);\n    if (absoluteTail === \"\") {\n      return [\"/\"];\n    }\n    const segments = absoluteTail.split(\"/\");\n    rejectEmptyUriSegments(segments, uri);\n    return [\"/\", ...segments];\n  }\n\n  const segments = trimmed.split(\"/\");\n  rejectEmptyUriSegments(segments, uri);\n  return segments;\n}\n\nfunction rejectEmptyUriSegments(\n  segments: readonly string[],\n  uri: string,\n): void {\n  if (segments.includes(\"\")) {\n    throw new Error(\n      `Invalid Wiki Graph URI path: empty path segment in ${uri}`,\n    );\n  }\n}\n\nfunction optionalWikiGraphUriFragment(\n  fragment: string | undefined,\n  uri: string,\n): {\n  readonly fragment?: number | { readonly begin: number; readonly end: number };\n} {\n  if (fragment === undefined) {\n    return {};\n  }\n  if (fragment === \"\") {\n    throw new Error(`Invalid Wiki Graph URI fragment: ${uri}`);\n  }\n\n  const range = /^(?<begin>[0-9]+)\\.\\.(?<end>[0-9]+)$/u.exec(fragment);\n  if (range?.groups !== undefined) {\n    const begin = Number(range.groups.begin);\n    const end = Number(range.groups.end);\n    return { fragment: { begin, end } };\n  }\n\n  if (/^[0-9]+$/u.test(fragment)) {\n    return { fragment: Number(fragment) };\n  }\n\n  throw new Error(`Invalid Wiki Graph URI fragment: ${uri}`);\n}\n\nfunction parseLibraryArchiveLocatorPath(\n  path: readonly string[],\n  fragment: ParsedWikiGraphUri[\"fragment\"],\n): LocatedWikiGraphUri | undefined {\n  if (path[0] !== \"lib\") {\n    return undefined;\n  }\n\n  const arcIndex = path[1] === \"arc\" ? 1 : path[2] === \"arc\" ? 2 : -1;\n  if (arcIndex < 0) {\n    return undefined;\n  }\n\n  const library = arcIndex === 2 ? path[1] : undefined;\n  const archive = path[arcIndex + 1];\n  if (\n    archive === undefined ||\n    archive.endsWith(WIKI_GRAPH_ARCHIVE_EXTENSION) ||\n    isLibraryScopeSegment(archive)\n  ) {\n    return undefined;\n  }\n  const archivePath = `${WIKI_GRAPH_URI_PREFIX}lib/${\n    library === undefined ? \"\" : `${library}/`\n  }arc/${archive}`;\n  const objectPath = path.slice(arcIndex + 2).join(\"/\");\n\n  return {\n    archivePath,\n    ...(objectPath === \"\"\n      ? {}\n      : {\n          objectUri: formatWikiGraphObjectUri(\n            objectPath,\n            formatWikiGraphUriFragment(fragment),\n          ),\n        }),\n  };\n}\n\nfunction formatArchivePathFromUriSegments(segments: readonly string[]): string {\n  if (segments[0] === \"/\") {\n    return `/${segments.slice(1).join(\"/\")}`;\n  }\n\n  return segments.join(\"/\");\n}\n\nfunction formatWikiGraphUriFragment(\n  fragment: ParsedWikiGraphUri[\"fragment\"],\n): string | undefined {\n  if (fragment === undefined) {\n    return undefined;\n  }\n  if (typeof fragment === \"number\") {\n    return String(fragment);\n  }\n\n  return `${fragment.begin}..${fragment.end}`;\n}\n\nfunction isLibraryScopeSegment(segment: string): boolean {\n  return RESERVED_LIBRARY_URI_SEGMENTS.has(segment);\n}\n\nfunction resolveArchivePath(archivePath: string): string {\n  if (archivePath.startsWith(\"~/\")) {\n    return resolve(homedir(), archivePath.slice(2));\n  }\n\n  return resolve(archivePath);\n}\n\nexport function formatLocatedWikiGraphUri(\n  archivePath: string,\n  objectUri?: string,\n): string {\n  const uriArchivePath = archivePath.replace(/\\\\/gu, \"/\");\n\n  if (objectUri === undefined || objectUri === WIKI_GRAPH_URI_PREFIX) {\n    return `${WIKI_GRAPH_URI_PREFIX}${uriArchivePath}`;\n  }\n\n  return `${WIKI_GRAPH_URI_PREFIX}${uriArchivePath}/${stripWikiGraphUriPrefix(\n    objectUri,\n  )}`;\n}\n\nexport function formatWikiGraphCommandUri(\n  archivePath: string,\n  objectUri?: string,\n  cwd = process.cwd(),\n): string {\n  return formatLocatedWikiGraphUri(\n    formatCommandArchivePath(archivePath, cwd),\n    objectUri,\n  );\n}\n\nfunction formatCommandArchivePath(archivePath: string, cwd: string): string {\n  const resolvedCwd = resolve(cwd);\n  const resolvedArchivePath = isAbsolute(archivePath)\n    ? resolve(archivePath)\n    : resolve(resolvedCwd, archivePath);\n  const relativeArchivePath = relative(resolvedCwd, resolvedArchivePath);\n\n  if (\n    relativeArchivePath !== \"\" &&\n    !relativeArchivePath.startsWith(\"..\") &&\n    !isAbsolute(relativeArchivePath)\n  ) {\n    return relativeArchivePath;\n  }\n\n  return resolvedArchivePath;\n}\n\nexport function formatLocatedChapterUri(\n  archivePath: string,\n  chapterPath: string,\n): string {\n  return formatLocatedWikiGraphUri(\n    archivePath,\n    formatWikiGraphObjectUri(`chapter/${chapterPath}`),\n  );\n}\n\nexport function formatLocatedChapterResourceUri(\n  archivePath: string,\n  chapterPath: string,\n  resource: \"source\" | \"summary\" | \"title\",\n): string {\n  return formatLocatedWikiGraphUri(\n    archivePath,\n    formatWikiGraphObjectUri(`chapter/${chapterPath}/${resource}`),\n  );\n}\n\nexport function formatLocatedChapterSourceCollectionUri(\n  archivePath: string,\n  chapterPath: string,\n): string {\n  return formatLocatedWikiGraphUri(\n    archivePath,\n    formatWikiGraphObjectUri(`chapter/${chapterPath}/source`),\n  );\n}\n\nexport function formatWikiGraphObjectUri(path: string, hash?: string): string {\n  const normalizedPath = path.replace(/^\\/+/u, \"\").replace(/\\/+$/u, \"\");\n\n  return `${WIKI_GRAPH_URI_PREFIX}${normalizedPath}${\n    hash === undefined ? \"\" : `#${hash}`\n  }`;\n}\n\nexport function requireArchiveUri(uri: string): string {\n  const parsed = parseLocatedWikiGraphUri(uri);\n\n  if (parsed.archivePath === undefined || parsed.objectUri !== undefined) {\n    throw new Error(\n      `${formatWikiGraphUriExpectedError(uri)} Expected a .wikg archive locator.`,\n    );\n  }\n\n  return parsed.archivePath;\n}\n\nexport function requireLocatedObjectUri(uri: string): {\n  readonly archivePath: string;\n  readonly objectUri: string;\n} {\n  const parsed = parseLocatedWikiGraphUri(uri);\n\n  if (parsed.archivePath === undefined || parsed.objectUri === undefined) {\n    throw new Error(\n      `${formatWikiGraphUriExpectedError(uri)} Expected an object URI with a .wikg archive locator.`,\n    );\n  }\n\n  return {\n    archivePath: parsed.archivePath,\n    objectUri: parsed.objectUri,\n  };\n}\n\nexport function requireLocatedObjectOrArchiveUri(uri: string): {\n  readonly archivePath: string;\n  readonly objectUri?: string;\n} {\n  const parsed = parseLocatedWikiGraphUri(uri);\n\n  if (parsed.archivePath === undefined) {\n    throw new Error(formatWikiGraphUriExpectedError(uri));\n  }\n\n  return {\n    archivePath: parsed.archivePath,\n    ...(parsed.objectUri === undefined ? {} : { objectUri: parsed.objectUri }),\n  };\n}\n\nexport function formatWikiGraphUriExpectedError(value: string): string {\n  const example =\n    value.endsWith(WIKI_GRAPH_ARCHIVE_EXTENSION) && value.startsWith(\"/\")\n      ? `${WIKI_GRAPH_URI_PREFIX}${value}`\n      : \"wikg:///absolute/path/book.wikg\";\n\n  return [\n    `Expected a Wiki Graph URI with a .wikg archive locator: ${value}`,\n    `Example: ${example}`,\n    \"See: wg help uri\",\n  ].join(\"\\n\");\n}\n\nfunction stripWikiGraphUriPrefix(uri: string): string {\n  const prefix = getWikiGraphUriPrefix(uri);\n\n  if (prefix === undefined) {\n    throw new Error(`Expected a Wiki Graph object URI: ${uri}`);\n  }\n\n  return uri.slice(prefix.length).replace(/^\\/+/u, \"\");\n}\n\nfunction getWikiGraphUriPrefix(uri: string): string | undefined {\n  if (uri.startsWith(WIKI_GRAPH_URI_PREFIX)) {\n    return WIKI_GRAPH_URI_PREFIX;\n  }\n\n  return undefined;\n}\n\nfunction isWikiGraphUriPrefix(value: string | undefined): value is string {\n  return value?.startsWith(WIKI_GRAPH_URI_PREFIX) === true;\n}\n\nfunction isWikiGraphLocalJobUri(value: string | undefined): boolean {\n  return (\n    value === WIKI_GRAPH_JOB_URI_PREFIX ||\n    value?.startsWith(`${WIKI_GRAPH_JOB_URI_PREFIX}/`) === true\n  );\n}\n"],"mappings":"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","names":["segments"]}

package/dist/runtime/context/index.d.ts

@@ -0,0 +1 @@
+export { WIKI_GRAPH_CONTEXT_VERSION, WikiGraphTask, WikiGraphTaskContext, WikiGraphTaskContextOptions, WikiGraphTaskIdentity, WikiGraphTaskType, createWikiGraphTaskId } from './task.js';

package/dist/runtime/context/index.js

@@ -0,0 +1,13 @@
+import {
+  createWikiGraphTaskId,
+  WikiGraphTask,
+  WikiGraphTaskContext,
+  WIKI_GRAPH_CONTEXT_VERSION
+} from "./task.js";
+export {
+  WIKI_GRAPH_CONTEXT_VERSION,
+  WikiGraphTask,
+  WikiGraphTaskContext,
+  createWikiGraphTaskId
+};
+//# sourceMappingURL=index.js.map

package/dist/runtime/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/runtime/context/index.ts"],"sourcesContent":["export {\n  createWikiGraphTaskId,\n  WikiGraphTask,\n  WikiGraphTaskContext,\n  WIKI_GRAPH_CONTEXT_VERSION,\n} from \"./task.js\";\nexport type {\n  WikiGraphTaskContextOptions,\n  WikiGraphTaskIdentity,\n  WikiGraphTaskType,\n} from \"./task.js\";\n"],"mappings":"AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}

package/dist/runtime/context/task.js

@@ -0,0 +1,111 @@
+import { mkdir, readFile, rm, writeFile } from "fs/promises";
+import { join, resolve } from "path";
+import { z } from "zod";
+import { createHash } from "../../utils/hash.js";
+import { isNodeError } from "../../utils/node-error.js";
+const WIKI_GRAPH_CONTEXT_VERSION = 1;
+const TASK_STATUS_VERSION = 1;
+const taskStatusSchema = z.object({
+  completedAt: z.string().optional(),
+  startedAt: z.string(),
+  status: z.enum(["running", "succeeded"]),
+  version: z.literal(TASK_STATUS_VERSION)
+});
+class WikiGraphTaskContext {
+  #rootDirPath;
+  constructor(options) {
+    this.#rootDirPath = resolve(options.rootDirPath);
+  }
+  createTask(identity) {
+    const taskId = createWikiGraphTaskId(identity);
+    return new WikiGraphTask(taskId, join(this.#rootDirPath, taskId));
+  }
+  async runTask(identity, operation) {
+    const task = this.createTask(identity);
+    return await task.run(operation);
+  }
+}
+class WikiGraphTask {
+  #id;
+  #path;
+  constructor(id, path) {
+    this.#id = id;
+    this.#path = resolve(path);
+  }
+  get artifactDirPath() {
+    return join(this.#path, "artifacts");
+  }
+  get id() {
+    return this.#id;
+  }
+  get path() {
+    return this.#path;
+  }
+  async readStatus() {
+    try {
+      const status = JSON.parse(
+        await readFile(this.#getStatusPath(), "utf8")
+      );
+      return taskStatusSchema.parse(status);
+    } catch (error) {
+      if (isNodeError(error) && error.code === "ENOENT") {
+        return void 0;
+      }
+      throw error;
+    }
+  }
+  async run(operation) {
+    await this.#begin();
+    const result = await operation(this);
+    await this.#complete();
+    await this.remove();
+    return result;
+  }
+  async remove() {
+    await rm(this.#path, { force: true, recursive: true });
+  }
+  async #begin() {
+    await mkdir(this.artifactDirPath, { recursive: true });
+    await this.#writeStatus({
+      startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      status: "running",
+      version: TASK_STATUS_VERSION
+    });
+  }
+  async #complete() {
+    const existingStatus = await this.readStatus();
+    await this.#writeStatus({
+      completedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      startedAt: existingStatus?.startedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+      status: "succeeded",
+      version: TASK_STATUS_VERSION
+    });
+  }
+  async #writeStatus(status) {
+    await mkdir(this.#path, { recursive: true });
+    await writeFile(
+      this.#getStatusPath(),
+      `${JSON.stringify(status, null, 2)}
+`,
+      "utf8"
+    );
+  }
+  #getStatusPath() {
+    return join(this.#path, "status.json");
+  }
+}
+function createWikiGraphTaskId(identity) {
+  return createHash({
+    normalizedSource: identity.normalizedSource,
+    parameters: identity.parameters,
+    taskType: identity.taskType,
+    version: identity.version ?? WIKI_GRAPH_CONTEXT_VERSION
+  });
+}
+export {
+  WIKI_GRAPH_CONTEXT_VERSION,
+  WikiGraphTask,
+  WikiGraphTaskContext,
+  createWikiGraphTaskId
+};
+//# sourceMappingURL=task.js.map