wiki-graph-core 0.3.1

package/dist/common/llm-scope.js

@@ -0,0 +1,31 @@
+var WikiGraphScope = /* @__PURE__ */ ((WikiGraphScope2) => {
+  WikiGraphScope2["EditorCompress"] = "serial-generation/editor-compress";
+  WikiGraphScope2["EditorReview"] = "serial-generation/editor-review";
+  WikiGraphScope2["EditorReviewGuide"] = "serial-generation/editor-review-guide";
+  WikiGraphScope2["ReaderChoice"] = "serial-generation/reader-choice";
+  WikiGraphScope2["ReaderExtraction"] = "serial-generation/reader-extraction";
+  return WikiGraphScope2;
+})(WikiGraphScope || {});
+const WIKI_GRAPH_SCOPES = Object.freeze([
+  "serial-generation/editor-compress" /* EditorCompress */,
+  "serial-generation/editor-review" /* EditorReview */,
+  "serial-generation/editor-review-guide" /* EditorReviewGuide */,
+  "serial-generation/reader-choice" /* ReaderChoice */,
+  "serial-generation/reader-extraction" /* ReaderExtraction */
+]);
+const WIKI_GRAPH_EDITOR_SCOPES = Object.freeze({
+  compress: "serial-generation/editor-compress" /* EditorCompress */,
+  review: "serial-generation/editor-review" /* EditorReview */,
+  reviewGuide: "serial-generation/editor-review-guide" /* EditorReviewGuide */
+});
+const WIKI_GRAPH_READER_SCOPES = Object.freeze({
+  choice: "serial-generation/reader-choice" /* ReaderChoice */,
+  extraction: "serial-generation/reader-extraction" /* ReaderExtraction */
+});
+export {
+  WIKI_GRAPH_EDITOR_SCOPES,
+  WIKI_GRAPH_READER_SCOPES,
+  WIKI_GRAPH_SCOPES,
+  WikiGraphScope
+};
+//# sourceMappingURL=llm-scope.js.map

package/dist/common/llm-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/common/llm-scope.ts"],"sourcesContent":["export enum WikiGraphScope {\n  EditorCompress = \"serial-generation/editor-compress\",\n  EditorReview = \"serial-generation/editor-review\",\n  EditorReviewGuide = \"serial-generation/editor-review-guide\",\n  ReaderChoice = \"serial-generation/reader-choice\",\n  ReaderExtraction = \"serial-generation/reader-extraction\",\n}\n\nexport const WIKI_GRAPH_SCOPES = Object.freeze([\n  WikiGraphScope.EditorCompress,\n  WikiGraphScope.EditorReview,\n  WikiGraphScope.EditorReviewGuide,\n  WikiGraphScope.ReaderChoice,\n  WikiGraphScope.ReaderExtraction,\n] as const);\n\nexport const WIKI_GRAPH_EDITOR_SCOPES = Object.freeze({\n  compress: WikiGraphScope.EditorCompress,\n  review: WikiGraphScope.EditorReview,\n  reviewGuide: WikiGraphScope.EditorReviewGuide,\n});\n\nexport const WIKI_GRAPH_READER_SCOPES = Object.freeze({\n  choice: WikiGraphScope.ReaderChoice,\n  extraction: WikiGraphScope.ReaderExtraction,\n});\n"],"mappings":"AAAO,IAAK,iBAAL,kBAAKA,oBAAL;AACL,EAAAA,gBAAA,oBAAiB;AACjB,EAAAA,gBAAA,kBAAe;AACf,EAAAA,gBAAA,uBAAoB;AACpB,EAAAA,gBAAA,kBAAe;AACf,EAAAA,gBAAA,sBAAmB;AALT,SAAAA;AAAA,GAAA;AAQL,MAAM,oBAAoB,OAAO,OAAO;AAAA,EAC7C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAU;AAEH,MAAM,2BAA2B,OAAO,OAAO;AAAA,EACpD,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,aAAa;AACf,CAAC;AAEM,MAAM,2BAA2B,OAAO,OAAO;AAAA,EACpD,QAAQ;AAAA,EACR,YAAY;AACd,CAAC;","names":["WikiGraphScope"]}

package/dist/common/logging.d.ts

@@ -0,0 +1,22 @@
+import { Logger } from 'pino';
+
+declare function withLoggingContext<T>(input: {
+    readonly operation: string;
+    readonly logDirPath?: string;
+    readonly verbose?: boolean;
+}, operation: () => Promise<T>): Promise<T>;
+declare function getLogger(bindings?: Record<string, unknown>): Logger;
+declare function resolveArtifactPath(input: {
+    readonly category: string;
+    readonly fileName: string;
+    readonly logDirPath?: string;
+}): string | undefined;
+declare function allocateArtifactPath(input: {
+    readonly alwaysNumbered?: boolean;
+    readonly category: string;
+    readonly extension?: string;
+    readonly logDirPath?: string;
+    readonly prefix: string;
+}): string | undefined;
+
+export { allocateArtifactPath, getLogger, resolveArtifactPath, withLoggingContext };

package/dist/common/logging.js

@@ -0,0 +1,141 @@
+import { AsyncLocalStorage } from "async_hooks";
+import { randomUUID } from "crypto";
+import { existsSync, mkdirSync } from "fs";
+import { dirname, join, resolve } from "path";
+import pino, {
+  multistream
+} from "pino";
+import pretty from "pino-pretty";
+const loggingContext = new AsyncLocalStorage();
+const artifactCounters = /* @__PURE__ */ new Map();
+const silentLogger = pino({ enabled: false });
+async function withLoggingContext(input, operation) {
+  const rootLogDirPath = input.logDirPath === void 0 ? void 0 : resolve(input.logDirPath);
+  const runId = createRunId();
+  const runDirPath = rootLogDirPath === void 0 ? void 0 : join(rootLogDirPath, runId);
+  const artifactRootDirPath = runDirPath === void 0 ? void 0 : join(runDirPath, "artifacts");
+  if (runDirPath !== void 0) {
+    mkdirSync(runDirPath, { recursive: true });
+  }
+  const logger = createLogger({
+    operation: input.operation,
+    runId,
+    verbose: input.verbose ?? false,
+    ...runDirPath === void 0 ? {} : { eventLogPath: join(runDirPath, "run.log") }
+  });
+  return await loggingContext.run(
+    {
+      artifactCounters: /* @__PURE__ */ new Map(),
+      logger,
+      runId,
+      ...artifactRootDirPath === void 0 ? {} : { artifactRootDirPath },
+      ...rootLogDirPath === void 0 ? {} : { rootLogDirPath }
+    },
+    operation
+  );
+}
+function getLogger(bindings) {
+  const logger = loggingContext.getStore()?.logger ?? silentLogger;
+  return bindings === void 0 ? logger : logger.child(bindings);
+}
+function resolveArtifactPath(input) {
+  if (input.logDirPath === void 0) {
+    return void 0;
+  }
+  const rootLogDirPath = resolve(input.logDirPath);
+  const context = loggingContext.getStore();
+  if (context?.rootLogDirPath === rootLogDirPath && context.artifactRootDirPath !== void 0) {
+    const categoryDirPath = join(context.artifactRootDirPath, input.category);
+    mkdirSync(categoryDirPath, { recursive: true });
+    return join(categoryDirPath, input.fileName);
+  }
+  mkdirSync(rootLogDirPath, { recursive: true });
+  return join(rootLogDirPath, input.fileName);
+}
+function allocateArtifactPath(input) {
+  if (input.logDirPath === void 0) {
+    return void 0;
+  }
+  const rootLogDirPath = resolve(input.logDirPath);
+  const context = loggingContext.getStore();
+  const extension = input.extension ?? ".log";
+  const counterStore = context?.artifactCounters ?? artifactCounters;
+  const counterKey = `${rootLogDirPath}:${input.category}:${input.prefix}:${extension}`;
+  const nextIndex = counterStore.get(counterKey);
+  const startIndex = nextIndex === void 0 ? 1 : nextIndex + 1;
+  for (let index = startIndex; ; index += 1) {
+    const fileName = input.alwaysNumbered === true ? `${input.prefix}-${index}${extension}` : index === 1 ? `${input.prefix}${extension}` : `${input.prefix}-${index}${extension}`;
+    const resolvedPath = resolveArtifactPath({
+      category: input.category,
+      fileName,
+      logDirPath: input.logDirPath
+    });
+    if (resolvedPath === void 0) {
+      return void 0;
+    }
+    if (!existsSync(resolvedPath)) {
+      counterStore.set(counterKey, index);
+      return resolvedPath;
+    }
+  }
+}
+function createLogger(input) {
+  const streams = [];
+  if (input.eventLogPath !== void 0) {
+    mkdirSync(dirname(input.eventLogPath), { recursive: true });
+    streams.push({
+      level: "info",
+      stream: pretty(createPrettyOptions(input.eventLogPath))
+    });
+  }
+  if (input.verbose) {
+    streams.push({
+      level: "info",
+      stream: pretty(createPrettyOptions(process.stderr))
+    });
+  }
+  if (streams.length === 0) {
+    return silentLogger;
+  }
+  return pino(
+    {
+      base: null,
+      level: "info"
+    },
+    multistream(streams)
+  ).child({
+    operation: input.operation,
+    runId: input.runId
+  });
+}
+function createPrettyOptions(destination) {
+  return {
+    colorize: false,
+    destination,
+    ignore: "pid,hostname,operation,runId,component,scope,sessionId",
+    mkdir: typeof destination === "string",
+    singleLine: true,
+    sync: true,
+    translateTime: "SYS:yyyy-mm-dd HH:MM:ss"
+  };
+}
+function createRunId() {
+  const now = /* @__PURE__ */ new Date();
+  const year = String(now.getUTCFullYear());
+  const month = pad(now.getUTCMonth() + 1);
+  const day = pad(now.getUTCDate());
+  const hours = pad(now.getUTCHours());
+  const minutes = pad(now.getUTCMinutes());
+  const seconds = pad(now.getUTCSeconds());
+  return `${year}${month}${day}-${hours}${minutes}${seconds}-${randomUUID().slice(0, 8)}`;
+}
+function pad(value) {
+  return String(value).padStart(2, "0");
+}
+export {
+  allocateArtifactPath,
+  getLogger,
+  resolveArtifactPath,
+  withLoggingContext
+};
+//# sourceMappingURL=logging.js.map

package/dist/common/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/common/logging.ts"],"sourcesContent":["import { AsyncLocalStorage } from \"async_hooks\";\nimport { randomUUID } from \"crypto\";\nimport { existsSync, mkdirSync } from \"fs\";\nimport { dirname, join, resolve } from \"path\";\n\nimport pino, {\n  multistream,\n  type Logger as PinoLogger,\n  type StreamEntry,\n} from \"pino\";\nimport pretty from \"pino-pretty\";\nimport type { PrettyOptions } from \"pino-pretty\";\n\ninterface LoggingContext {\n  readonly artifactCounters: Map<string, number>;\n  readonly artifactRootDirPath?: string;\n  readonly logger: PinoLogger;\n  readonly rootLogDirPath?: string;\n  readonly runId: string;\n}\n\nconst loggingContext = new AsyncLocalStorage<LoggingContext>();\nconst artifactCounters = new Map<string, number>();\nconst silentLogger = pino({ enabled: false });\n\nexport async function withLoggingContext<T>(\n  input: {\n    readonly operation: string;\n    readonly logDirPath?: string;\n    readonly verbose?: boolean;\n  },\n  operation: () => Promise<T>,\n): Promise<T> {\n  const rootLogDirPath =\n    input.logDirPath === undefined ? undefined : resolve(input.logDirPath);\n  const runId = createRunId();\n  const runDirPath =\n    rootLogDirPath === undefined ? undefined : join(rootLogDirPath, runId);\n  const artifactRootDirPath =\n    runDirPath === undefined ? undefined : join(runDirPath, \"artifacts\");\n\n  if (runDirPath !== undefined) {\n    mkdirSync(runDirPath, { recursive: true });\n  }\n\n  const logger = createLogger({\n    operation: input.operation,\n    runId,\n    verbose: input.verbose ?? false,\n    ...(runDirPath === undefined\n      ? {}\n      : { eventLogPath: join(runDirPath, \"run.log\") }),\n  });\n\n  return await loggingContext.run(\n    {\n      artifactCounters: new Map(),\n      logger,\n      runId,\n      ...(artifactRootDirPath === undefined ? {} : { artifactRootDirPath }),\n      ...(rootLogDirPath === undefined ? {} : { rootLogDirPath }),\n    },\n    operation,\n  );\n}\n\nexport function getLogger(bindings?: Record<string, unknown>): PinoLogger {\n  const logger = loggingContext.getStore()?.logger ?? silentLogger;\n\n  return bindings === undefined ? logger : logger.child(bindings);\n}\n\nexport function resolveArtifactPath(input: {\n  readonly category: string;\n  readonly fileName: string;\n  readonly logDirPath?: string;\n}): string | undefined {\n  if (input.logDirPath === undefined) {\n    return undefined;\n  }\n\n  const rootLogDirPath = resolve(input.logDirPath);\n  const context = loggingContext.getStore();\n\n  if (\n    context?.rootLogDirPath === rootLogDirPath &&\n    context.artifactRootDirPath !== undefined\n  ) {\n    const categoryDirPath = join(context.artifactRootDirPath, input.category);\n\n    mkdirSync(categoryDirPath, { recursive: true });\n\n    return join(categoryDirPath, input.fileName);\n  }\n\n  mkdirSync(rootLogDirPath, { recursive: true });\n\n  return join(rootLogDirPath, input.fileName);\n}\n\nexport function allocateArtifactPath(input: {\n  readonly alwaysNumbered?: boolean;\n  readonly category: string;\n  readonly extension?: string;\n  readonly logDirPath?: string;\n  readonly prefix: string;\n}): string | undefined {\n  if (input.logDirPath === undefined) {\n    return undefined;\n  }\n\n  const rootLogDirPath = resolve(input.logDirPath);\n  const context = loggingContext.getStore();\n  const extension = input.extension ?? \".log\";\n  const counterStore = context?.artifactCounters ?? artifactCounters;\n  const counterKey = `${rootLogDirPath}:${input.category}:${input.prefix}:${extension}`;\n  const nextIndex = counterStore.get(counterKey);\n  const startIndex = nextIndex === undefined ? 1 : nextIndex + 1;\n\n  for (let index = startIndex; ; index += 1) {\n    const fileName =\n      input.alwaysNumbered === true\n        ? `${input.prefix}-${index}${extension}`\n        : index === 1\n          ? `${input.prefix}${extension}`\n          : `${input.prefix}-${index}${extension}`;\n    const resolvedPath = resolveArtifactPath({\n      category: input.category,\n      fileName,\n      logDirPath: input.logDirPath,\n    });\n\n    if (resolvedPath === undefined) {\n      return undefined;\n    }\n\n    if (!existsSync(resolvedPath)) {\n      counterStore.set(counterKey, index);\n      return resolvedPath;\n    }\n  }\n}\n\nfunction createLogger(input: {\n  readonly eventLogPath?: string;\n  readonly operation: string;\n  readonly runId: string;\n  readonly verbose: boolean;\n}): PinoLogger {\n  const streams: StreamEntry[] = [];\n\n  if (input.eventLogPath !== undefined) {\n    mkdirSync(dirname(input.eventLogPath), { recursive: true });\n    streams.push({\n      level: \"info\",\n      stream: pretty(createPrettyOptions(input.eventLogPath)),\n    });\n  }\n\n  if (input.verbose) {\n    streams.push({\n      level: \"info\",\n      stream: pretty(createPrettyOptions(process.stderr)),\n    });\n  }\n\n  if (streams.length === 0) {\n    return silentLogger;\n  }\n\n  return pino(\n    {\n      base: null,\n      level: \"info\",\n    },\n    multistream(streams),\n  ).child({\n    operation: input.operation,\n    runId: input.runId,\n  });\n}\n\nfunction createPrettyOptions(\n  destination: string | NodeJS.WritableStream,\n): PrettyOptions {\n  return {\n    colorize: false,\n    destination,\n    ignore: \"pid,hostname,operation,runId,component,scope,sessionId\",\n    mkdir: typeof destination === \"string\",\n    singleLine: true,\n    sync: true,\n    translateTime: \"SYS:yyyy-mm-dd HH:MM:ss\",\n  };\n}\n\nfunction createRunId(): string {\n  const now = new Date();\n  const year = String(now.getUTCFullYear());\n  const month = pad(now.getUTCMonth() + 1);\n  const day = pad(now.getUTCDate());\n  const hours = pad(now.getUTCHours());\n  const minutes = pad(now.getUTCMinutes());\n  const seconds = pad(now.getUTCSeconds());\n\n  return `${year}${month}${day}-${hours}${minutes}${seconds}-${randomUUID().slice(0, 8)}`;\n}\n\nfunction pad(value: number): string {\n  return String(value).padStart(2, \"0\");\n}\n"],"mappings":"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","names":[]}

package/dist/common/template.d.ts

@@ -0,0 +1,8 @@
+import { Environment } from 'nunjucks';
+
+declare function createEnv(dirPath: string, options?: {
+    readonly autoescape?: boolean;
+    readonly trimBlocks?: boolean;
+}): Environment;
+
+export { createEnv };

package/dist/common/template.js

@@ -0,0 +1,54 @@
+import { readFileSync, statSync } from "fs";
+import { resolve, sep } from "path";
+import { Environment, Loader } from "nunjucks";
+const JINJA_EXTENSION_PATTERN = /\.jinja$/i;
+const LEADING_DOT_SEGMENT_PATTERN = /^\.+\//;
+const LEADING_SLASH_PATTERN = /^\/+/;
+function createEnv(dirPath, options = {}) {
+  return new Environment(new DSTemplateLoader(resolve(dirPath)), {
+    autoescape: options.autoescape ?? true,
+    trimBlocks: options.trimBlocks ?? true
+  });
+}
+class DSTemplateLoader extends Loader {
+  #dirPath;
+  constructor(dirPath) {
+    super();
+    this.#dirPath = dirPath;
+  }
+  getSource(templateName) {
+    const normalizedTemplateName = normalizeTemplateName(templateName);
+    const targetPath = resolve(this.#dirPath, normalizedTemplateName);
+    assertWithinRoot(this.#dirPath, targetPath, normalizedTemplateName);
+    const source = readFileSync(targetPath, "utf8");
+    const modifiedTime = statSync(targetPath).mtimeMs;
+    return {
+      noCache: false,
+      path: targetPath,
+      src: source,
+      upToDate: () => statSync(targetPath).mtimeMs === modifiedTime
+    };
+  }
+}
+function normalizeTemplateName(templateName) {
+  if (LEADING_DOT_SEGMENT_PATTERN.test(templateName)) {
+    throw new Error(`invalid path ${templateName}`);
+  }
+  const withoutLeadingSlash = templateName.replace(LEADING_SLASH_PATTERN, "");
+  const withoutExtension = withoutLeadingSlash.replace(
+    JINJA_EXTENSION_PATTERN,
+    ""
+  );
+  return `${withoutExtension}.jinja`;
+}
+function assertWithinRoot(rootDirPath, targetPath, templateName) {
+  const rootPrefix = rootDirPath.endsWith(sep) ? rootDirPath : `${rootDirPath}${sep}`;
+  if (targetPath === rootDirPath || targetPath.startsWith(rootPrefix)) {
+    return;
+  }
+  throw new Error(`cannot find ${templateName}`);
+}
+export {
+  createEnv
+};
+//# sourceMappingURL=template.js.map

package/dist/common/template.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/common/template.ts"],"sourcesContent":["import { readFileSync, statSync } from \"fs\";\nimport { resolve, sep } from \"path\";\n\nimport { Environment, Loader, type LoaderSource } from \"nunjucks\";\n\nconst JINJA_EXTENSION_PATTERN = /\\.jinja$/i;\nconst LEADING_DOT_SEGMENT_PATTERN = /^\\.+\\//;\nconst LEADING_SLASH_PATTERN = /^\\/+/;\n\ntype LoaderSourceWithUpdateCheck = LoaderSource & {\n  upToDate: () => boolean;\n};\n\nexport function createEnv(\n  dirPath: string,\n  options: {\n    readonly autoescape?: boolean;\n    readonly trimBlocks?: boolean;\n  } = {},\n): Environment {\n  return new Environment(new DSTemplateLoader(resolve(dirPath)), {\n    autoescape: options.autoescape ?? true,\n    trimBlocks: options.trimBlocks ?? true,\n  });\n}\n\nclass DSTemplateLoader extends Loader {\n  readonly #dirPath: string;\n\n  public constructor(dirPath: string) {\n    super();\n    this.#dirPath = dirPath;\n  }\n\n  public getSource(templateName: string): LoaderSourceWithUpdateCheck {\n    const normalizedTemplateName = normalizeTemplateName(templateName);\n    const targetPath = resolve(this.#dirPath, normalizedTemplateName);\n\n    assertWithinRoot(this.#dirPath, targetPath, normalizedTemplateName);\n\n    const source = readFileSync(targetPath, \"utf8\");\n    const modifiedTime = statSync(targetPath).mtimeMs;\n\n    return {\n      noCache: false,\n      path: targetPath,\n      src: source,\n      upToDate: () => statSync(targetPath).mtimeMs === modifiedTime,\n    };\n  }\n}\n\nfunction normalizeTemplateName(templateName: string): string {\n  if (LEADING_DOT_SEGMENT_PATTERN.test(templateName)) {\n    throw new Error(`invalid path ${templateName}`);\n  }\n\n  const withoutLeadingSlash = templateName.replace(LEADING_SLASH_PATTERN, \"\");\n  const withoutExtension = withoutLeadingSlash.replace(\n    JINJA_EXTENSION_PATTERN,\n    \"\",\n  );\n\n  return `${withoutExtension}.jinja`;\n}\n\nfunction assertWithinRoot(\n  rootDirPath: string,\n  targetPath: string,\n  templateName: string,\n): void {\n  const rootPrefix = rootDirPath.endsWith(sep)\n    ? rootDirPath\n    : `${rootDirPath}${sep}`;\n\n  if (targetPath === rootDirPath || targetPath.startsWith(rootPrefix)) {\n    return;\n  }\n\n  throw new Error(`cannot find ${templateName}`);\n}\n"],"mappings":"AAAA,SAAS,cAAc,gBAAgB;AACvC,SAAS,SAAS,WAAW;AAE7B,SAAS,aAAa,cAAiC;AAEvD,MAAM,0BAA0B;AAChC,MAAM,8BAA8B;AACpC,MAAM,wBAAwB;AAMvB,SAAS,UACd,SACA,UAGI,CAAC,GACQ;AACb,SAAO,IAAI,YAAY,IAAI,iBAAiB,QAAQ,OAAO,CAAC,GAAG;AAAA,IAC7D,YAAY,QAAQ,cAAc;AAAA,IAClC,YAAY,QAAQ,cAAc;AAAA,EACpC,CAAC;AACH;AAEA,MAAM,yBAAyB,OAAO;AAAA,EAC3B;AAAA,EAEF,YAAY,SAAiB;AAClC,UAAM;AACN,SAAK,WAAW;AAAA,EAClB;AAAA,EAEO,UAAU,cAAmD;AAClE,UAAM,yBAAyB,sBAAsB,YAAY;AACjE,UAAM,aAAa,QAAQ,KAAK,UAAU,sBAAsB;AAEhE,qBAAiB,KAAK,UAAU,YAAY,sBAAsB;AAElE,UAAM,SAAS,aAAa,YAAY,MAAM;AAC9C,UAAM,eAAe,SAAS,UAAU,EAAE;AAE1C,WAAO;AAAA,MACL,SAAS;AAAA,MACT,MAAM;AAAA,MACN,KAAK;AAAA,MACL,UAAU,MAAM,SAAS,UAAU,EAAE,YAAY;AAAA,IACnD;AAAA,EACF;AACF;AAEA,SAAS,sBAAsB,cAA8B;AAC3D,MAAI,4BAA4B,KAAK,YAAY,GAAG;AAClD,UAAM,IAAI,MAAM,gBAAgB,YAAY,EAAE;AAAA,EAChD;AAEA,QAAM,sBAAsB,aAAa,QAAQ,uBAAuB,EAAE;AAC1E,QAAM,mBAAmB,oBAAoB;AAAA,IAC3C;AAAA,IACA;AAAA,EACF;AAEA,SAAO,GAAG,gBAAgB;AAC5B;AAEA,SAAS,iBACP,aACA,YACA,cACM;AACN,QAAM,aAAa,YAAY,SAAS,GAAG,IACvC,cACA,GAAG,WAAW,GAAG,GAAG;AAExB,MAAI,eAAe,eAAe,WAAW,WAAW,UAAU,GAAG;AACnE;AAAA,EACF;AAEA,QAAM,IAAI,MAAM,eAAe,YAAY,EAAE;AAC/C;","names":[]}

package/dist/common/tinyld-language.d.ts

@@ -0,0 +1,6 @@
+import { Language } from './language.js';
+
+declare function detectLanguageCode(text: string): string | undefined;
+declare function getLanguageDetectionCode(language: Language): string;
+
+export { detectLanguageCode, getLanguageDetectionCode };

package/dist/common/tinyld-language.js

@@ -0,0 +1,34 @@
+import { detect, validateISO2 } from "tinyld";
+import { getLanguageCode } from "./language.js";
+function detectLanguageCode(text) {
+  const normalizedText = text.trim();
+  if (normalizedText === "") {
+    return void 0;
+  }
+  try {
+    return normalizeLanguageCode(detect(normalizedText));
+  } catch {
+    return void 0;
+  }
+}
+function getLanguageDetectionCode(language) {
+  return getLanguageCode(language);
+}
+function normalizeLanguageCode(languageCode) {
+  const normalizedLanguageCode = languageCode.trim().toLowerCase();
+  const directLanguageCode = validateISO2(normalizedLanguageCode);
+  if (directLanguageCode !== "") {
+    return directLanguageCode;
+  }
+  const baseLanguageCode = normalizedLanguageCode.split("-")[0];
+  if (baseLanguageCode === void 0) {
+    return void 0;
+  }
+  const validatedBaseLanguageCode = validateISO2(baseLanguageCode);
+  return validatedBaseLanguageCode === "" ? void 0 : validatedBaseLanguageCode;
+}
+export {
+  detectLanguageCode,
+  getLanguageDetectionCode
+};
+//# sourceMappingURL=tinyld-language.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/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/common/wiki-graph-dir.d.ts

@@ -0,0 +1,10 @@
+declare function resolveWikiGraphHomeDirectoryPath(): string;
+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 { resolveWikiGraphCacheDatabasePath, resolveWikiGraphCacheDirectoryPath, resolveWikiGraphCoreDatabasePath, resolveWikiGraphHomeDirectoryPath, resolveWikiGraphJobsDirectoryPath, resolveWikiGraphLogsDirectoryPath, resolveWikiGraphStagingDirectoryPath, resolveWikiGraphTempRootDirectoryPath };

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

@@ -0,0 +1,41 @@
+import { homedir } from "os";
+import { join, resolve } from "path";
+function resolveWikiGraphHomeDirectoryPath() {
+  const localDataRootPath = process.env.WIKIGRAPH_STATE_DIR;
+  if (localDataRootPath !== void 0 && localDataRootPath.trim() !== "") {
+    return resolve(localDataRootPath);
+  }
+  return join(homedir(), ".wikigraph");
+}
+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 {
+  resolveWikiGraphCacheDatabasePath,
+  resolveWikiGraphCacheDirectoryPath,
+  resolveWikiGraphCoreDatabasePath,
+  resolveWikiGraphHomeDirectoryPath,
+  resolveWikiGraphJobsDirectoryPath,
+  resolveWikiGraphLogsDirectoryPath,
+  resolveWikiGraphStagingDirectoryPath,
+  resolveWikiGraphTempRootDirectoryPath
+};
+//# sourceMappingURL=wiki-graph-dir.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/common/wiki-graph-dir.ts"],"sourcesContent":["import { homedir } from \"os\";\nimport { join, resolve } from \"path\";\n\nexport function resolveWikiGraphHomeDirectoryPath(): string {\n  const localDataRootPath = process.env.WIKIGRAPH_STATE_DIR;\n\n  if (localDataRootPath !== undefined && localDataRootPath.trim() !== \"\") {\n    return resolve(localDataRootPath);\n  }\n\n  return join(homedir(), \".wikigraph\");\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,eAAe;AACxB,SAAS,MAAM,eAAe;AAEvB,SAAS,oCAA4C;AAC1D,QAAM,oBAAoB,QAAQ,IAAI;AAEtC,MAAI,sBAAsB,UAAa,kBAAkB,KAAK,MAAM,IAAI;AACtE,WAAO,QAAQ,iBAAiB;AAAA,EAClC;AAEA,SAAO,KAAK,QAAQ,GAAG,YAAY;AACrC;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/common/wiki-graph-temp.d.ts

@@ -0,0 +1,6 @@
+type WikiGraphTempCategory = "archive-open" | "archive-write" | "cli-output" | "sdpub-upgrade" | "stdin-create" | "url-create";
+declare function resolveWikiGraphStateRootPath(): string;
+declare function resolveWikiGraphTempDirectoryPath(category?: WikiGraphTempCategory): string;
+declare function createWikiGraphTempDirectory(category: WikiGraphTempCategory): Promise<string>;
+
+export { type WikiGraphTempCategory, createWikiGraphTempDirectory, resolveWikiGraphStateRootPath, resolveWikiGraphTempDirectoryPath };

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

@@ -0,0 +1,21 @@
+import { mkdir, mkdtemp } from "fs/promises";
+import { join } from "path";
+import { resolveWikiGraphTempRootDirectoryPath } from "./wiki-graph-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=wiki-graph-temp.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/common/wiki-graph-temp.ts"],"sourcesContent":["import { mkdir, mkdtemp } from \"fs/promises\";\nimport { join } from \"path\";\n\nimport { resolveWikiGraphTempRootDirectoryPath } from \"./wiki-graph-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/common/wiki-graph-uri.d.ts

@@ -0,0 +1,28 @@
+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 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 formatLocatedWikiGraphUri(archivePath: string, objectUri?: string): string;
+declare function formatWikiGraphCommandUri(archivePath: string, objectUri?: string, cwd?: string): string;
+declare function formatLocatedChapterUri(archivePath: string, chapterId: number): string;
+declare function formatLocatedChapterResourceUri(archivePath: string, chapterId: number, resource: "source" | "summary" | "title"): string;
+declare function formatLocatedChapterSourceCollectionUri(archivePath: string, chapterId: number): 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, WIKI_GRAPH_ARCHIVE_EXTENSION, WIKI_GRAPH_JOB_URI_PREFIX, WIKI_GRAPH_URI_PREFIX, formatLocatedChapterResourceUri, formatLocatedChapterSourceCollectionUri, formatLocatedChapterUri, formatLocatedWikiGraphUri, formatWikiGraphCommandUri, formatWikiGraphObjectUri, formatWikiGraphUriExpectedError, isWikiGraphJobUri, isWikiGraphUri, parseLocatedWikiGraphUri, requireArchiveUri, requireLocatedObjectOrArchiveUri, requireLocatedObjectUri };

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

@@ -0,0 +1,171 @@
+import { isAbsolute, relative, resolve } from "path";
+import { homedir } from "os";
+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 prefix = getWikiGraphUriPrefix(uri);
+  if (prefix === void 0) {
+    throw new Error(formatWikiGraphUriExpectedError(uri));
+  }
+  const body = uri.slice(prefix.length);
+  const split = body.split("#", 2);
+  const path = split[0] ?? "";
+  const hash = split[1] ?? "";
+  const parts = path.split("/");
+  const archiveIndex = parts.findIndex(
+    (part) => part.endsWith(WIKI_GRAPH_ARCHIVE_EXTENSION)
+  );
+  if (archiveIndex < 0) {
+    return { objectUri: uri };
+  }
+  const archivePath = parts.slice(0, archiveIndex + 1).join("/");
+  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,
+        hash === "" ? void 0 : hash
+      )
+    }
+  };
+}
+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, chapterId) {
+  return formatLocatedWikiGraphUri(
+    archivePath,
+    formatWikiGraphObjectUri(`chapter/${chapterId}`)
+  );
+}
+function formatLocatedChapterResourceUri(archivePath, chapterId, resource) {
+  return formatLocatedWikiGraphUri(
+    archivePath,
+    formatWikiGraphObjectUri(`chapter/${chapterId}/${resource}`)
+  );
+}
+function formatLocatedChapterSourceCollectionUri(archivePath, chapterId) {
+  return formatLocatedWikiGraphUri(
+    archivePath,
+    formatWikiGraphObjectUri(`chapter/${chapterId}/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,
+  requireArchiveUri,
+  requireLocatedObjectOrArchiveUri,
+  requireLocatedObjectUri
+};
+//# sourceMappingURL=wiki-graph-uri.js.map