wiki-graph-core 0.3.1

package/dist/facade/knowledge-graph-build.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/facade/knowledge-graph-build.ts"],"sourcesContent":["import { createReadStream, createWriteStream } from \"fs\";\nimport { mkdir, rm } from \"fs/promises\";\nimport { createInterface } from \"readline\";\nimport { join } from \"path\";\nimport { z } from \"zod\";\n\nimport type {\n  GuaranteedRequest,\n  GuaranteedRequestController,\n} from \"../guaranteed/index.js\";\nimport type {\n  Document,\n  FragmentRecord,\n  MentionLinkRecord,\n  MentionRecord,\n  ReadonlyDocument,\n  SentenceId,\n} from \"../document/index.js\";\nimport { LanguageCode, normalizeLanguageCode } from \"../common/language.js\";\nimport type { WikipageResolveProgress } from \"../wikipage/index.js\";\nimport {\n  buildWikimatchSurfaceProtectionInput,\n  buildWikimatchWindows,\n  enrichWikimatchCandidates,\n  filterCandidateQidOptions,\n  judgeWikimatchPolicy,\n  judgeWikimatchSurfaceProtection,\n  listCandidateSelectableQids,\n  matchWikispineSentenceCandidates,\n  type WikimatchAcceptedMention,\n  type WikimatchCandidate,\n  type WikimatchSentence,\n  type MatchWikispineSentenceCandidatesOptions,\n} from \"../wikimatch/index.js\";\nimport type { WikipageResolverOptions } from \"../wikipage/index.js\";\nimport {\n  buildWikilinkEvidenceWindows,\n  discoverWikilinkRelations,\n  type WikilinkEvidenceWindow,\n  type WikilinkMention,\n  type WikilinkSentence,\n} from \"../wikilink/index.js\";\n\nimport { getChapterDetails, type ChapterDetails } from \"./chapter.js\";\nimport type { BuildJobProgressReporter } from \"./build-queue.js\";\n\nexport interface ChapterKnowledgeGraphBuildArtifact {\n  readonly chapterId: number;\n  readonly mentionLinksPath: string;\n  readonly mentionsPath: string;\n  readonly parameter: GraphBuildParameterInput;\n  readonly workspacePath: string;\n}\n\nexport interface ChapterKnowledgeGraphInputSnapshot {\n  readonly details: ChapterDetails;\n  readonly fragments: readonly FragmentRecord[];\n}\n\nexport interface GraphBuildParameterInput {\n  readonly language?: string;\n  readonly prompt: string;\n}\n\nexport interface BuildChapterKnowledgeGraphArtifactOptions {\n  readonly mentionLinks:\n    | AsyncIterable<MentionLinkRecord>\n    | Iterable<MentionLinkRecord>;\n  readonly mentions: AsyncIterable<MentionRecord> | Iterable<MentionRecord>;\n  readonly parameter?: GraphBuildParameterInput;\n  readonly workspacePath: string;\n}\n\nexport interface GenerateChapterKnowledgeGraphArtifactOptions {\n  readonly policyPrompt: string;\n  readonly progressTracker?: Pick<\n    BuildJobProgressReporter,\n    \"throwIfStopped\" | \"updatePhase\"\n  >;\n  readonly request: GuaranteedRequestController;\n  readonly resolverOptions?: Omit<WikipageResolverOptions, \"progress\">;\n  readonly wikispine?: Pick<\n    MatchWikispineSentenceCandidatesOptions,\n    \"command\" | \"dataDir\" | \"endpoint\" | \"provider\"\n  >;\n  readonly workspacePath: string;\n}\n\nconst mentionRecordSchema = z.object({\n  id: z.string().min(1),\n  chapterId: z.number().int(),\n  sentenceIndex: z.number().int().nonnegative().optional(),\n  rangeStart: z.number().int().nonnegative(),\n  rangeEnd: z.number().int().nonnegative(),\n  surface: z.string().min(1),\n  qid: z.string().regex(/^Q[1-9][0-9]*$/),\n  confidence: z.number().min(0).max(1).optional(),\n  note: z.string().optional(),\n});\n\nconst sentenceIdSchema = z\n  .tuple([z.number().int().nonnegative(), z.number().int().nonnegative()])\n  .readonly();\n\nconst mentionLinkRecordSchema = z.object({\n  id: z.string().min(1),\n  sourceMentionId: z.string().min(1),\n  targetMentionId: z.string().min(1),\n  predicate: z.string().min(1),\n  evidenceSentenceIds: z.array(sentenceIdSchema).min(1),\n  confidence: z.number().min(0).max(1).optional(),\n  note: z.string().optional(),\n});\n\nconst WIKIMATCH_GROUNDING_DEFAULT_OPTION_BUDGETS = [5, 10, 20, 35] as const;\nconst WIKIMATCH_GROUNDING_PRIOR_OPTION_BUDGETS = [3, 5, 10, 20, 35] as const;\nconst WIKIMATCH_GROUNDING_MAX_OPTION_BUDGET = 50;\nconst WIKIMATCH_GROUNDING_SURFACE_PRIOR_THRESHOLD = 3;\nconst WIKIMATCH_SURFACE_PROTECTION_PERCENTILE = 0.1;\nconst WIKILINK_EVIDENCE_DISTANCE = 700;\nconst WIKILINK_WINDOW_LENGTH = 1800;\n\nexport async function generateChapterKnowledgeGraphArtifact(\n  document: ReadonlyDocument,\n  chapterId: number,\n  options: GenerateChapterKnowledgeGraphArtifactOptions,\n): Promise<ChapterKnowledgeGraphBuildArtifact> {\n  return await generateChapterKnowledgeGraphArtifactFromSnapshot(\n    chapterId,\n    await snapshotChapterKnowledgeGraphInput(document, chapterId),\n    options,\n  );\n}\n\nexport async function snapshotChapterKnowledgeGraphInput(\n  document: ReadonlyDocument,\n  chapterId: number,\n): Promise<ChapterKnowledgeGraphInputSnapshot> {\n  const details = await getChapterDetails(document, chapterId);\n\n  if (details.stage === \"planned\") {\n    throw new Error(\n      `Chapter ${chapterId} is planned. Set source before generating Knowledge Graph.`,\n    );\n  }\n\n  return {\n    details,\n    fragments: await readChapterFragments(document, chapterId),\n  };\n}\n\nexport async function generateChapterKnowledgeGraphArtifactFromSnapshot(\n  chapterId: number,\n  snapshot: ChapterKnowledgeGraphInputSnapshot,\n  options: GenerateChapterKnowledgeGraphArtifactOptions,\n): Promise<ChapterKnowledgeGraphBuildArtifact> {\n  if (snapshot.details.chapterId !== chapterId) {\n    throw new Error(\n      `Knowledge Graph snapshot belongs to chapter ${snapshot.details.chapterId}, not chapter ${chapterId}.`,\n    );\n  }\n  if (snapshot.details.stage === \"planned\") {\n    throw new Error(\n      `Chapter ${chapterId} is planned. Set source before generating Knowledge Graph.`,\n    );\n  }\n\n  const fragments = snapshot.fragments;\n  const text = joinFragmentText(fragments);\n  const sentences = createWikimatchSentences(fragments);\n  await options.progressTracker?.updatePhase({\n    done: 0,\n    phase: \"matching\",\n    phaseDetail: \"text\",\n    total: text.length,\n    unit: \"char\",\n  });\n  const rawCandidates = await matchWikispineSentenceCandidates({\n    includeDisambiguation: true,\n    onProgress: async (progress) => {\n      await options.progressTracker?.updatePhase({\n        done: progress.coveredRangeEnd,\n        force: false,\n        phase: \"matching\",\n        phaseDetail: \"text\",\n        total: text.length,\n        unit: \"char\",\n      });\n    },\n    ...(options.wikispine ?? {}),\n    sentences,\n  });\n  await options.progressTracker?.throwIfStopped();\n  await options.progressTracker?.updatePhase({\n    done: text.length,\n    phase: \"matching\",\n    phaseDetail: \"text\",\n    total: text.length,\n    unit: \"char\",\n  });\n  const screenedCandidates = await screenCandidates({\n    candidates: rawCandidates,\n    policyPrompt: options.policyPrompt,\n    ...(options.progressTracker === undefined\n      ? {}\n      : { progressTracker: options.progressTracker }),\n    request: options.request,\n    text,\n  });\n  await options.progressTracker?.throwIfStopped();\n  const qidCount = countUniqueQids(screenedCandidates);\n  await options.progressTracker?.updatePhase({\n    done: 0,\n    phase: \"enrichment\",\n    total: qidCount,\n    unit: \"qid\",\n  });\n  const enrichedCandidates = await enrichWikimatchCandidates(\n    screenedCandidates,\n    {\n      ...(options.progressTracker === undefined\n        ? {}\n        : {\n            progress: createEnrichmentProgressReporter(options.progressTracker),\n          }),\n      ...(options.resolverOptions === undefined\n        ? {}\n        : { resolverOptions: options.resolverOptions }),\n    },\n  );\n  await options.progressTracker?.throwIfStopped();\n  await options.progressTracker?.updatePhase({\n    done: qidCount,\n    phase: \"enrichment\",\n    total: qidCount,\n    unit: \"qid\",\n  });\n  const mentions = await judgeCandidates({\n    candidates: enrichedCandidates,\n    chapterId,\n    fragments,\n    policyPrompt: options.policyPrompt,\n    ...(options.progressTracker === undefined\n      ? {}\n      : { progressTracker: options.progressTracker }),\n    request: options.request,\n    text,\n  });\n  await options.progressTracker?.throwIfStopped();\n  const mentionLinks = await discoverMentionLinks({\n    fragments,\n    mentions,\n    ...(options.progressTracker === undefined\n      ? {}\n      : { progressTracker: options.progressTracker }),\n    request: options.request,\n  });\n  await options.progressTracker?.throwIfStopped();\n  const artifact = await buildChapterKnowledgeGraphArtifact(chapterId, {\n    mentionLinks,\n    mentions,\n    parameter: createKnowledgeGraphParameterInput(options),\n    workspacePath: options.workspacePath,\n  });\n\n  return artifact;\n}\n\nexport async function buildChapterKnowledgeGraphArtifact(\n  chapterId: number,\n  options: BuildChapterKnowledgeGraphArtifactOptions,\n): Promise<ChapterKnowledgeGraphBuildArtifact> {\n  const workspacePath = join(\n    options.workspacePath,\n    \"knowledge-graph\",\n    `chapter-${chapterId}`,\n  );\n  const mentionsPath = join(workspacePath, \"mentions.jsonl\");\n  const mentionLinksPath = join(workspacePath, \"mention-links.jsonl\");\n\n  await rm(workspacePath, { force: true, recursive: true });\n  await mkdir(workspacePath, { recursive: true });\n  await writeJsonl(mentionsPath, options.mentions, parseMentionRecord);\n  await writeJsonl(\n    mentionLinksPath,\n    options.mentionLinks,\n    parseMentionLinkRecord,\n  );\n\n  return {\n    chapterId,\n    mentionLinksPath,\n    mentionsPath,\n    parameter: options.parameter ?? {\n      language: LanguageCode.Chinese,\n      prompt: \"\",\n    },\n    workspacePath,\n  };\n}\n\nfunction createKnowledgeGraphParameterInput(\n  options: Pick<\n    GenerateChapterKnowledgeGraphArtifactOptions,\n    \"policyPrompt\" | \"resolverOptions\"\n  >,\n): GraphBuildParameterInput {\n  return {\n    language:\n      normalizeLanguageCode(options.resolverOptions?.language) ??\n      LanguageCode.Chinese,\n    prompt: options.policyPrompt,\n  };\n}\n\nasync function screenCandidates(input: {\n  readonly candidates: readonly WikimatchCandidate[];\n  readonly policyPrompt: string;\n  readonly progressTracker?: Pick<\n    BuildJobProgressReporter,\n    \"throwIfStopped\" | \"updatePhase\"\n  >;\n  readonly request: GuaranteedRequestController;\n  readonly text: string;\n}): Promise<readonly WikimatchCandidate[]> {\n  if (input.candidates.length === 0) {\n    return [];\n  }\n\n  const protectionInput = buildWikimatchSurfaceProtectionInput({\n    candidates: input.candidates,\n    percentile: WIKIMATCH_SURFACE_PROTECTION_PERCENTILE,\n    text: input.text,\n  });\n\n  await input.progressTracker?.updatePhase({\n    done: 0,\n    phase: \"screening\",\n    phaseDetail: `${protectionInput.suspiciousSurfaces.length} high-frequency surfaces`,\n    total: 1,\n    unit: \"window\",\n  });\n  await input.progressTracker?.throwIfStopped();\n  const protection = await judgeWikimatchSurfaceProtection({\n    policyPrompt: input.policyPrompt,\n    request: input.request,\n    suspiciousSurfaces: protectionInput.suspiciousSurfaces,\n  });\n  await input.progressTracker?.throwIfStopped();\n  const protectedSurfaces = new Set(\n    protection.protectedSurfaces.map((surface) => surface.text),\n  );\n  const allowedCandidateKeys = new Set(\n    protectionInput.candidates.map(createCandidateRangeKey),\n  );\n\n  await input.progressTracker?.updatePhase({\n    done: 1,\n    phase: \"screening\",\n    phaseDetail: `${protectedSurfaces.size} protected surfaces`,\n    total: 1,\n    unit: \"window\",\n  });\n\n  return protectionInput.suppressedCandidates.filter(\n    (candidate) =>\n      allowedCandidateKeys.has(createCandidateRangeKey(candidate)) ||\n      protectedSurfaces.has(candidate.surface),\n  );\n}\n\nfunction createCandidateRangeKey(candidate: WikimatchCandidate): string {\n  return `${candidate.range.start}\\0${candidate.range.end}\\0${candidate.surface}`;\n}\n\nasync function judgeCandidates(input: {\n  readonly candidates: readonly WikimatchCandidate[];\n  readonly chapterId: number;\n  readonly fragments: readonly FragmentRecord[];\n  readonly policyPrompt: string;\n  readonly progressTracker?: Pick<\n    BuildJobProgressReporter,\n    \"throwIfStopped\" | \"updatePhase\"\n  >;\n  readonly request: GuaranteedRequestController;\n  readonly text: string;\n}): Promise<readonly MentionRecord[]> {\n  const mentions: MentionRecord[] = [];\n  const sentenceLocations = buildSentenceLocations(input.fragments);\n  const acceptedMentions = await groundWikimatchCandidates({\n    candidates: input.candidates,\n    policyPrompt: input.policyPrompt,\n    ...(input.progressTracker === undefined\n      ? {}\n      : { progressTracker: input.progressTracker }),\n    request: input.request,\n    text: input.text,\n  });\n  let mentionIndex = 1;\n\n  for (const mention of acceptedMentions) {\n    const location = locateMention(sentenceLocations, mention.range.start);\n\n    mentions.push(\n      toMentionRecord(input.chapterId, mention, location, mentionIndex),\n    );\n    mentionIndex += 1;\n  }\n\n  return mentions;\n}\n\nexport async function groundWikimatchCandidates(input: {\n  readonly candidates: readonly WikimatchCandidate[];\n  readonly policyPrompt: string;\n  readonly progressTracker?: Pick<\n    BuildJobProgressReporter,\n    \"throwIfStopped\" | \"updatePhase\"\n  >;\n  readonly request: GuaranteedRequestController;\n  readonly text: string;\n}): Promise<readonly WikimatchAcceptedMention[]> {\n  const mentions: WikimatchAcceptedMention[] = [];\n  const candidatePages = createGroundingCandidatePages(input.candidates);\n  let completedWindows = 0;\n  let totalWindows = 0;\n\n  let activeCandidates = candidatePages.nextPage();\n\n  while (activeCandidates.length > 0) {\n    const windows = buildWikimatchWindows({\n      candidates: activeCandidates,\n      contextWords: 220,\n      optionBudget: WIKIMATCH_GROUNDING_MAX_OPTION_BUDGET,\n      text: input.text,\n    });\n\n    totalWindows += windows.length;\n    if (windows.length === 0) {\n      break;\n    }\n    await input.progressTracker?.updatePhase({\n      done: completedWindows,\n      phase: \"grounding\",\n      total: totalWindows,\n      unit: \"window\",\n    });\n\n    const results = await mapLazyGuaranteedRequests(\n      input.request,\n      windows,\n      async (window, request) => {\n        try {\n          await input.progressTracker?.throwIfStopped();\n          return await judgeWikimatchPolicy({\n            candidates: window.candidates,\n            policyPrompt: input.policyPrompt,\n            request,\n            window,\n          });\n        } finally {\n          completedWindows += 1;\n          await input.progressTracker?.updatePhase({\n            done: completedWindows,\n            phase: \"grounding\",\n            total: totalWindows,\n            unit: \"window\",\n          });\n        }\n      },\n    );\n\n    const continuedCandidateIds = new Set<string>();\n\n    for (const result of results) {\n      for (const mention of result.mentions) {\n        mentions.push(mention);\n        candidatePages.accept(mention);\n      }\n      for (const update of result.policyUpdates) {\n        candidatePages.close(update.candidateId, update.decision);\n      }\n      for (const continuation of result.continuations) {\n        for (const candidateId of continuation.candidateIds) {\n          continuedCandidateIds.add(candidateId);\n          candidatePages.continue(candidateId);\n        }\n      }\n    }\n\n    activeCandidates = candidatePages.nextPage(continuedCandidateIds);\n  }\n\n  await input.progressTracker?.updatePhase({\n    done: completedWindows,\n    phase: \"grounding\",\n    phaseDetail: formatGroundingEfficiency(\n      candidatePages.getStats(),\n      mentions.length,\n    ),\n    total: totalWindows,\n    unit: \"window\",\n  });\n\n  return mentions;\n}\n\nfunction createGroundingCandidatePages(\n  candidates: readonly WikimatchCandidate[],\n): {\n  readonly accept: (mention: WikimatchAcceptedMention) => void;\n  readonly close: (\n    candidateId: string,\n    decision?: \"skip_this_time\" | \"never_recall\",\n  ) => void;\n  readonly continue: (candidateId: string) => void;\n  readonly getStats: () => GroundingCandidatePageStats;\n  readonly nextPage: (\n    continuedCandidateIds?: ReadonlySet<string>,\n  ) => readonly WikimatchCandidate[];\n} {\n  const candidatesById = new Map(\n    candidates.map((candidate) => [candidate.id, candidate]),\n  );\n  const shownQidsByCandidateId = new Map(\n    candidates.map((candidate) => [candidate.id, new Set<string>()]),\n  );\n  const pageIndexesByCandidateId = new Map(\n    candidates.map((candidate) => [candidate.id, 0]),\n  );\n  const closedCandidateIds = new Set<string>();\n  const recallCounts = new Map<string, number>();\n  const surfaceStats = new Map<string, GroundingSurfaceStats>();\n  const stats: GroundingCandidatePageStats = {\n    candidatePageCount: 0,\n    qidAppearanceCount: 0,\n  };\n\n  return {\n    accept(mention) {\n      closedCandidateIds.add(mention.candidateId);\n      getSurfaceStats(surfaceStats, mention.surface).recallCount += 1;\n      recallCounts.set(\n        createSurfaceQidKey(mention.surface, mention.qid),\n        (recallCounts.get(createSurfaceQidKey(mention.surface, mention.qid)) ??\n          0) + 1,\n      );\n    },\n    close(candidateId, decision) {\n      closedCandidateIds.add(candidateId);\n      const candidate = candidatesById.get(candidateId);\n\n      if (\n        candidate !== undefined &&\n        (decision === \"skip_this_time\" || decision === \"never_recall\")\n      ) {\n        getSurfaceStats(surfaceStats, candidate.surface).rejectCount += 1;\n      }\n    },\n    continue(candidateId) {\n      const candidate = candidatesById.get(candidateId);\n\n      if (candidate !== undefined) {\n        getSurfaceStats(surfaceStats, candidate.surface).continueCount += 1;\n      }\n    },\n    getStats() {\n      return { ...stats };\n    },\n    nextPage(continuedCandidateIds) {\n      const pageCandidates: WikimatchCandidate[] = [];\n      const candidateIds =\n        continuedCandidateIds === undefined\n          ? candidates.map((candidate) => candidate.id)\n          : [...continuedCandidateIds];\n\n      for (const candidateId of candidateIds) {\n        if (closedCandidateIds.has(candidateId)) {\n          continue;\n        }\n\n        const candidate = candidatesById.get(candidateId);\n        const shownQids = shownQidsByCandidateId.get(candidateId);\n\n        if (candidate === undefined || shownQids === undefined) {\n          continue;\n        }\n\n        const sortedCandidate = sortCandidateOptionsByRecall(\n          candidate,\n          recallCounts,\n        );\n        const selectableQids = listCandidateSelectableQids(sortedCandidate);\n        const pageIndex = pageIndexesByCandidateId.get(candidateId) ?? 0;\n        const optionBudget = getGroundingCandidateOptionBudget(\n          getSurfaceStats(surfaceStats, candidate.surface),\n          pageIndex,\n        );\n        const selectedQids = selectableQids\n          .filter((qid) => !shownQids.has(qid))\n          .slice(0, optionBudget);\n\n        if (selectedQids.length === 0) {\n          closedCandidateIds.add(candidateId);\n          continue;\n        }\n\n        for (const qid of selectedQids) {\n          shownQids.add(qid);\n        }\n\n        const hasMoreOptions = selectableQids.some(\n          (qid) => !shownQids.has(qid),\n        );\n        const pageCandidate = filterCandidateQidOptions(\n          sortedCandidate,\n          new Set(selectedQids),\n        );\n\n        if (!hasMoreOptions) {\n          closedCandidateIds.add(candidateId);\n        }\n        getSurfaceStats(surfaceStats, candidate.surface).seenCount += 1;\n        pageIndexesByCandidateId.set(candidateId, pageIndex + 1);\n        stats.candidatePageCount += 1;\n        stats.qidAppearanceCount += selectedQids.length;\n        pageCandidates.push({\n          ...pageCandidate,\n          ...(hasMoreOptions ? { hasMoreOptions: true } : {}),\n        });\n      }\n\n      return pageCandidates;\n    },\n  };\n}\n\ninterface GroundingSurfaceStats {\n  continueCount: number;\n  recallCount: number;\n  rejectCount: number;\n  seenCount: number;\n}\n\ninterface GroundingCandidatePageStats {\n  candidatePageCount: number;\n  qidAppearanceCount: number;\n}\n\nfunction getSurfaceStats(\n  surfaceStats: Map<string, GroundingSurfaceStats>,\n  surface: string,\n): GroundingSurfaceStats {\n  const existing = surfaceStats.get(surface);\n\n  if (existing !== undefined) {\n    return existing;\n  }\n\n  const created = {\n    continueCount: 0,\n    recallCount: 0,\n    rejectCount: 0,\n    seenCount: 0,\n  };\n  surfaceStats.set(surface, created);\n\n  return created;\n}\n\nfunction getGroundingCandidateOptionBudget(\n  stats: GroundingSurfaceStats,\n  pageIndex: number,\n): number {\n  const budgets = hasStrongGroundingSurfacePrior(stats)\n    ? WIKIMATCH_GROUNDING_PRIOR_OPTION_BUDGETS\n    : WIKIMATCH_GROUNDING_DEFAULT_OPTION_BUDGETS;\n\n  return budgets[Math.min(pageIndex, budgets.length - 1)]!;\n}\n\nfunction hasStrongGroundingSurfacePrior(stats: GroundingSurfaceStats): boolean {\n  if (stats.seenCount < WIKIMATCH_GROUNDING_SURFACE_PRIOR_THRESHOLD) {\n    return false;\n  }\n\n  return (\n    (stats.recallCount >= 2 && stats.continueCount === 0) ||\n    (stats.rejectCount >= 2 && stats.recallCount === 0) ||\n    stats.continueCount >= WIKIMATCH_GROUNDING_SURFACE_PRIOR_THRESHOLD\n  );\n}\n\nfunction formatGroundingEfficiency(\n  stats: GroundingCandidatePageStats,\n  mentionCount: number,\n): string {\n  const qidPerMention =\n    mentionCount === 0\n      ? \"n/a\"\n      : (stats.qidAppearanceCount / mentionCount).toFixed(1);\n\n  return `efficiency qid/mention=${qidPerMention} qids=${stats.qidAppearanceCount} mentions=${mentionCount} pages=${stats.candidatePageCount}`;\n}\n\nfunction sortCandidateOptionsByRecall(\n  candidate: WikimatchCandidate,\n  recallCounts: ReadonlyMap<string, number>,\n): WikimatchCandidate {\n  return {\n    ...candidate,\n    qidOptions: [...candidate.qidOptions].sort((left, right) => {\n      return (\n        getOptionRecallScore(candidate.surface, right, recallCounts) -\n        getOptionRecallScore(candidate.surface, left, recallCounts)\n      );\n    }),\n  };\n}\n\nfunction getOptionRecallScore(\n  surface: string,\n  option: WikimatchCandidate[\"qidOptions\"][number],\n  recallCounts: ReadonlyMap<string, number>,\n): number {\n  const directScore =\n    recallCounts.get(createSurfaceQidKey(surface, option.qid)) ?? 0;\n  const disambiguationScore =\n    option.disambiguation?.linkedQids.reduce(\n      (total, item) =>\n        total + (recallCounts.get(createSurfaceQidKey(surface, item.qid)) ?? 0),\n      0,\n    ) ?? 0;\n  const profileScore =\n    option.disambiguation?.profile?.meanings.reduce(\n      (total, item) =>\n        total + (recallCounts.get(createSurfaceQidKey(surface, item.qid)) ?? 0),\n      0,\n    ) ?? 0;\n\n  return directScore + disambiguationScore + profileScore;\n}\n\nfunction createSurfaceQidKey(surface: string, qid: string): string {\n  return `${surface}\\0${qid}`;\n}\n\nexport function createEnrichmentProgressReporter(\n  progressTracker: Pick<\n    BuildJobProgressReporter,\n    \"throwIfStopped\" | \"updatePhase\"\n  >,\n): (event: WikipageResolveProgress) => Promise<void> {\n  return async (event) => {\n    await progressTracker.throwIfStopped();\n    const phase = formatEnrichmentProgressPhase(event);\n\n    await progressTracker.updatePhase({\n      done: event.done,\n      ...(phase.detail === undefined ? {} : { phaseDetail: phase.detail }),\n      phase: \"enrichment\",\n      total: event.total,\n      unit: phase.unit,\n    });\n  };\n}\n\nfunction formatEnrichmentProgressPhase(event: WikipageResolveProgress): {\n  readonly detail?: string;\n  readonly unit: \"page\" | \"qid\" | \"record\";\n} {\n  switch (event.detail) {\n    case \"disambiguation-page\":\n      return {\n        detail: \"disambiguation\",\n        unit: \"page\",\n      };\n    case \"entity\":\n      return {\n        detail: \"entity\",\n        unit: \"record\",\n      };\n    case \"linked-page\":\n      return {\n        detail: \"linked\",\n        unit: \"page\",\n      };\n    case \"page\":\n      return {\n        detail: \"page\",\n        unit: \"page\",\n      };\n    case \"qid\":\n      return {\n        unit: \"qid\",\n      };\n  }\n}\n\nasync function mapLazyGuaranteedRequests<TItem, TResult>(\n  request: GuaranteedRequestController,\n  items: readonly TItem[],\n  operation: (item: TItem, request: GuaranteedRequest) => Promise<TResult>,\n): Promise<readonly TResult[]> {\n  const lazy = request.lazy;\n\n  if (lazy !== undefined) {\n    return await Promise.all(\n      items.map(\n        async (item) =>\n          await lazy(async (request) => await operation(item, request)),\n      ),\n    );\n  }\n\n  const results: TResult[] = [];\n\n  for (const item of items) {\n    results.push(await operation(item, request));\n  }\n\n  return results;\n}\n\nasync function discoverMentionLinks(input: {\n  readonly fragments: readonly FragmentRecord[];\n  readonly mentions: readonly MentionRecord[];\n  readonly progressTracker?: Pick<\n    BuildJobProgressReporter,\n    \"throwIfStopped\" | \"updatePhase\"\n  >;\n  readonly request: GuaranteedRequestController;\n}): Promise<readonly MentionLinkRecord[]> {\n  const fragmentWindows = buildMentionLinkWindows(\n    input.fragments,\n    input.mentions,\n  );\n  let completedWindows = 0;\n\n  await input.progressTracker?.updatePhase({\n    done: 0,\n    phase: \"relation-discovery\",\n    total: fragmentWindows.length,\n    unit: \"window\",\n  });\n\n  const discoveredLinks = (\n    await mapLazyGuaranteedRequests(\n      input.request,\n      fragmentWindows,\n      async (item, request) => {\n        try {\n          await input.progressTracker?.throwIfStopped();\n          return await discoverWikilinkRelations({\n            chapterId: item.fragment.serialId,\n            fragmentId: item.fragment.fragmentId,\n            request,\n            sentences: item.fragment.sentences,\n            window: item.window,\n          });\n        } finally {\n          completedWindows += 1;\n          await input.progressTracker?.updatePhase({\n            done: completedWindows,\n            phase: \"relation-discovery\",\n            total: fragmentWindows.length,\n            unit: \"window\",\n          });\n        }\n      },\n    )\n  ).flat();\n\n  return discoveredLinks.map((link, index) => ({\n    ...(link.confidence === undefined ? {} : { confidence: link.confidence }),\n    evidenceSentenceIds: link.evidenceSentenceIds,\n    id: `l${input.fragments[0]?.serialId ?? 0}-${index + 1}`,\n    predicate: link.predicate,\n    sourceMentionId: link.sourceMentionId,\n    targetMentionId: link.targetMentionId,\n  }));\n}\n\nfunction buildMentionLinkWindows(\n  fragments: readonly FragmentRecord[],\n  mentions: readonly MentionRecord[],\n): ReadonlyArray<{\n  readonly fragment: FragmentRecord;\n  readonly window: WikilinkEvidenceWindow;\n}> {\n  return fragments.flatMap((fragment) => {\n    const startSentenceIndex = fragment.fragmentId;\n    const endSentenceIndex = startSentenceIndex + fragment.sentences.length - 1;\n    const fragmentMentions = toWikilinkMentions(\n      fragment.sentences,\n      mentions.filter(\n        (mention) =>\n          mention.sentenceIndex !== undefined &&\n          mention.sentenceIndex >= startSentenceIndex &&\n          mention.sentenceIndex <= endSentenceIndex,\n      ),\n      startSentenceIndex,\n    );\n    const windows = buildWikilinkEvidenceWindows({\n      maxEvidenceDistance: WIKILINK_EVIDENCE_DISTANCE,\n      mentions: fragmentMentions,\n      text: joinSentences(fragment.sentences),\n      windowLength: WIKILINK_WINDOW_LENGTH,\n    });\n\n    return windows.map((window) => ({\n      fragment,\n      window,\n    }));\n  });\n}\n\nfunction toWikilinkMentions(\n  sentences: readonly WikilinkSentence[],\n  mentions: readonly MentionRecord[],\n  startSentenceIndex: number,\n): readonly WikilinkMention[] {\n  const sentenceOffsets = buildFragmentSentenceOffsets(sentences);\n\n  return mentions.flatMap((mention) => {\n    if (mention.sentenceIndex === undefined) {\n      return [];\n    }\n\n    const sentenceOffset =\n      sentenceOffsets[mention.sentenceIndex - startSentenceIndex];\n\n    if (sentenceOffset === undefined) {\n      return [];\n    }\n\n    return [\n      {\n        id: mention.id,\n        qid: mention.qid,\n        range: {\n          end: sentenceOffset.start + mention.rangeEnd,\n          start: sentenceOffset.start + mention.rangeStart,\n        },\n        surface: mention.surface,\n      },\n    ];\n  });\n}\n\nfunction buildFragmentSentenceOffsets(\n  sentences: readonly WikilinkSentence[],\n): ReadonlyArray<{ readonly end: number; readonly start: number }> {\n  const offsets: Array<{ readonly end: number; readonly start: number }> = [];\n  let cursor = 0;\n\n  for (const sentence of sentences) {\n    const start = cursor;\n    const end = start + sentence.text.length;\n\n    offsets.push({ end, start });\n    cursor = end + 1;\n  }\n\n  return offsets;\n}\n\nfunction joinSentences(sentences: readonly WikilinkSentence[]): string {\n  return sentences.map((sentence) => sentence.text).join(\" \");\n}\n\nfunction countUniqueQids(candidates: readonly WikimatchCandidate[]): number {\n  return new Set(\n    candidates.flatMap((candidate) =>\n      candidate.qidOptions.map((option) => option.qid),\n    ),\n  ).size;\n}\n\nfunction toMentionRecord(\n  chapterId: number,\n  mention: WikimatchAcceptedMention,\n  location: {\n    readonly rangeStart: number;\n    readonly sentenceIndex: number;\n  },\n  index: number,\n): MentionRecord {\n  return {\n    chapterId,\n    ...(mention.confidence === undefined\n      ? {}\n      : { confidence: mention.confidence }),\n    id: `m${chapterId}-${index}`,\n    ...(mention.note === undefined ? {} : { note: mention.note }),\n    qid: mention.qid,\n    rangeEnd: location.rangeStart + mention.surface.length,\n    rangeStart: location.rangeStart,\n    sentenceIndex: location.sentenceIndex,\n    surface: mention.surface,\n  };\n}\n\ninterface SentenceLocation {\n  readonly absoluteStart: number;\n  readonly length: number;\n  readonly sentenceIndex: number;\n}\n\nfunction buildSentenceLocations(\n  fragments: readonly FragmentRecord[],\n): readonly SentenceLocation[] {\n  const locations: SentenceLocation[] = [];\n  let offset = 0;\n\n  for (const fragment of fragments) {\n    for (\n      let sentenceIndex = 0;\n      sentenceIndex < fragment.sentences.length;\n      sentenceIndex += 1\n    ) {\n      const length = fragment.sentences[sentenceIndex]!.text.length;\n\n      locations.push({\n        absoluteStart: offset,\n        length,\n        sentenceIndex: fragment.fragmentId + sentenceIndex,\n      });\n      offset += length + 1;\n    }\n  }\n\n  return locations;\n}\n\nfunction locateMention(\n  locations: readonly SentenceLocation[],\n  absoluteOffset: number,\n): {\n  readonly rangeStart: number;\n  readonly sentenceIndex: number;\n} {\n  for (const location of locations) {\n    const rangeEnd = location.absoluteStart + location.length;\n\n    if (absoluteOffset >= location.absoluteStart && absoluteOffset < rangeEnd) {\n      return {\n        rangeStart: absoluteOffset - location.absoluteStart,\n        sentenceIndex: location.sentenceIndex,\n      };\n    }\n  }\n\n  throw new Error(`Mention offset ${absoluteOffset} is outside chapter text.`);\n}\n\nasync function readChapterFragments(\n  document: ReadonlyDocument,\n  chapterId: number,\n): Promise<readonly FragmentRecord[]> {\n  const serialFragments = document.getSerialFragments(chapterId);\n\n  return await Promise.all(\n    (await serialFragments.listFragmentIds()).map(\n      async (fragmentId) => await serialFragments.getFragment(fragmentId),\n    ),\n  );\n}\n\nfunction joinFragmentText(fragments: readonly FragmentRecord[]): string {\n  return fragments\n    .flatMap((fragment) => fragment.sentences.map((sentence) => sentence.text))\n    .join(\" \");\n}\n\nfunction createWikimatchSentences(\n  fragments: readonly FragmentRecord[],\n): readonly WikimatchSentence[] {\n  const sentences: WikimatchSentence[] = [];\n  let offset = 0;\n\n  for (const fragment of fragments) {\n    for (let index = 0; index < fragment.sentences.length; index += 1) {\n      const sentence = fragment.sentences[index]!;\n\n      sentences.push({\n        id: `${fragment.serialId}:${fragment.fragmentId + index}`,\n        range: {\n          end: offset + sentence.text.length,\n          start: offset,\n        },\n        text: sentence.text,\n      });\n      offset += sentence.text.length + 1;\n    }\n  }\n\n  return sentences;\n}\n\nexport async function commitChapterKnowledgeGraphArtifact(\n  document: Document,\n  artifact: ChapterKnowledgeGraphBuildArtifact,\n): Promise<void> {\n  const mentions = await readJsonl(artifact.mentionsPath, parseMentionRecord);\n  const mentionLinks = await readJsonl(\n    artifact.mentionLinksPath,\n    parseMentionLinkRecord,\n  );\n\n  validateChapterKnowledgeGraphArtifact(artifact.chapterId, {\n    mentionLinks,\n    mentions,\n  });\n\n  await document.openSession(async (openedDocument) => {\n    await openedDocument.serials.ensure(artifact.chapterId);\n    const existingLinks = await openedDocument.mentionLinks.listByChapter(\n      artifact.chapterId,\n    );\n\n    if (existingLinks.length > 0 && mentionLinks.length === 0) {\n      throw new Error(\n        `Refusing to replace chapter ${artifact.chapterId} knowledge graph with an artifact that contains no mention links.`,\n      );\n    }\n\n    await openedDocument.mentionLinks.deleteByChapter(artifact.chapterId);\n    await openedDocument.mentions.deleteByChapter(artifact.chapterId);\n    await openedDocument.mentions.saveMany(mentions);\n    await openedDocument.mentionLinks.saveMany(mentionLinks);\n    const parameter = await openedDocument.graphBuildParameters.save(\n      artifact.parameter,\n    );\n    await openedDocument.serials.setKnowledgeGraphReady(\n      artifact.chapterId,\n      true,\n      parameter.hash,\n    );\n  });\n}\n\nexport async function clearChapterKnowledgeGraph(\n  document: Document,\n  chapterId: number,\n): Promise<void> {\n  await document.openSession(async (openedDocument) => {\n    await openedDocument.mentionLinks.deleteByChapter(chapterId);\n    await openedDocument.mentions.deleteByChapter(chapterId);\n    await openedDocument.serials.setKnowledgeGraphReady(chapterId, false);\n    await openedDocument.graphBuildParameters.deleteUnreferenced();\n  });\n}\n\nfunction validateChapterKnowledgeGraphArtifact(\n  chapterId: number,\n  records: {\n    readonly mentionLinks: readonly MentionLinkRecord[];\n    readonly mentions: readonly MentionRecord[];\n  },\n): void {\n  const mentionIds = new Set<string>();\n\n  for (const mention of records.mentions) {\n    if (mention.chapterId !== chapterId) {\n      throw new Error(\n        `Mention ${mention.id} belongs to chapter ${mention.chapterId}, expected chapter ${chapterId}.`,\n      );\n    }\n    if (mention.rangeEnd <= mention.rangeStart) {\n      throw new Error(\n        `Mention ${mention.id} has invalid range [${mention.rangeStart}, ${mention.rangeEnd}).`,\n      );\n    }\n    if (mentionIds.has(mention.id)) {\n      throw new Error(`Duplicate mention id ${mention.id}.`);\n    }\n\n    mentionIds.add(mention.id);\n  }\n\n  const linkIds = new Set<string>();\n\n  for (const link of records.mentionLinks) {\n    if (linkIds.has(link.id)) {\n      throw new Error(`Duplicate mention link id ${link.id}.`);\n    }\n    if (!mentionIds.has(link.sourceMentionId)) {\n      throw new Error(\n        `Mention link ${link.id} references unknown source mention ${link.sourceMentionId}.`,\n      );\n    }\n    if (!mentionIds.has(link.targetMentionId)) {\n      throw new Error(\n        `Mention link ${link.id} references unknown target mention ${link.targetMentionId}.`,\n      );\n    }\n    if (link.evidenceSentenceIds.length === 0) {\n      throw new Error(`Mention link ${link.id} has no evidence sentences.`);\n    }\n\n    for (const sentenceId of link.evidenceSentenceIds) {\n      if (sentenceId[0] !== chapterId) {\n        throw new Error(\n          `Mention link ${link.id} evidence sentence ${formatSentenceId(sentenceId)} is outside chapter ${chapterId}.`,\n        );\n      }\n    }\n\n    linkIds.add(link.id);\n  }\n}\n\nfunction formatSentenceId(sentenceId: SentenceId): string {\n  return sentenceId.join(\":\");\n}\n\nasync function writeJsonl<T>(\n  path: string,\n  records: AsyncIterable<T> | Iterable<T>,\n  parseRecord: (record: unknown) => T,\n): Promise<void> {\n  const stream = createWriteStream(path, { encoding: \"utf8\", flags: \"wx\" });\n\n  try {\n    for await (const record of records) {\n      stream.write(`${JSON.stringify(parseRecord(record))}\\n`);\n    }\n  } finally {\n    await closeWritableStream(stream);\n  }\n}\n\nasync function readJsonl<T>(\n  path: string,\n  parseRecord: (record: unknown) => T,\n): Promise<T[]> {\n  const records: T[] = [];\n  const lines = createInterface({\n    crlfDelay: Infinity,\n    input: createReadStream(path, { encoding: \"utf8\" }),\n  });\n  let lineNumber = 0;\n\n  for await (const line of lines) {\n    lineNumber += 1;\n    if (line.trim() === \"\") {\n      continue;\n    }\n\n    try {\n      records.push(parseRecord(JSON.parse(line)));\n    } catch (error) {\n      throw new Error(`Invalid JSONL record at ${path}:${lineNumber}`, {\n        cause: error,\n      });\n    }\n  }\n\n  return records;\n}\n\nfunction parseMentionRecord(record: unknown): MentionRecord {\n  const parsed = mentionRecordSchema.parse(record);\n\n  return {\n    chapterId: parsed.chapterId,\n    ...(parsed.confidence === undefined\n      ? {}\n      : { confidence: parsed.confidence }),\n    id: parsed.id,\n    ...(parsed.note === undefined ? {} : { note: parsed.note }),\n    qid: parsed.qid,\n    rangeEnd: parsed.rangeEnd,\n    rangeStart: parsed.rangeStart,\n    ...(parsed.sentenceIndex === undefined\n      ? {}\n      : { sentenceIndex: parsed.sentenceIndex }),\n    surface: parsed.surface,\n  };\n}\n\nfunction parseMentionLinkRecord(record: unknown): MentionLinkRecord {\n  const parsed = mentionLinkRecordSchema.parse(record);\n\n  return {\n    ...(parsed.confidence === undefined\n      ? {}\n      : { confidence: parsed.confidence }),\n    evidenceSentenceIds: parsed.evidenceSentenceIds,\n    id: parsed.id,\n    ...(parsed.note === undefined ? {} : { note: parsed.note }),\n    predicate: parsed.predicate,\n    sourceMentionId: parsed.sourceMentionId,\n    targetMentionId: parsed.targetMentionId,\n  };\n}\n\nasync function closeWritableStream(\n  stream: NodeJS.WritableStream,\n): Promise<void> {\n  await new Promise<void>((resolveClose, rejectClose) => {\n    stream.end((error?: Error | null) => {\n      if (error !== undefined && error !== null) {\n        rejectClose(error);\n        return;\n      }\n\n      resolveClose();\n    });\n  });\n}\n"],"mappings":"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","names":["request"]}

package/dist/facade/llm-sampling.d.ts

@@ -0,0 +1,11 @@
+import { WikiGraphScope } from '../common/llm-scope.js';
+import { TemperatureSetting, SamplingScopeConfig } from '../llm/types.js';
+import 'ai';
+
+type WikiGraphSamplingConfig = SamplingScopeConfig<WikiGraphScope>;
+declare function createDefaultWikiGraphSampling(input?: {
+    readonly temperature?: TemperatureSetting;
+    readonly topP?: TemperatureSetting;
+}): WikiGraphSamplingConfig;
+
+export { type WikiGraphSamplingConfig, createDefaultWikiGraphSampling };

package/dist/facade/llm-sampling.js

@@ -0,0 +1,58 @@
+import { WikiGraphScope } from "../common/llm-scope.js";
+const DEFAULT_WIKI_GRAPH_SAMPLING = Object.freeze({
+  [WikiGraphScope.EditorCompress]: Object.freeze({
+    temperature: 0.7,
+    topP: 0.9
+  }),
+  [WikiGraphScope.EditorReview]: Object.freeze({
+    temperature: [0.3, 0.95],
+    topP: [0.4, 0.8]
+  }),
+  [WikiGraphScope.EditorReviewGuide]: Object.freeze({
+    temperature: 0.4,
+    topP: 0.6
+  }),
+  [WikiGraphScope.ReaderChoice]: Object.freeze({
+    temperature: [0.3, 0.95],
+    topP: [0.4, 0.8]
+  }),
+  [WikiGraphScope.ReaderExtraction]: Object.freeze({
+    temperature: [0.3, 0.95],
+    topP: [0.4, 0.8]
+  })
+});
+function createDefaultWikiGraphSampling(input = {}) {
+  return Object.freeze({
+    [WikiGraphScope.EditorCompress]: applySamplingOverrides(
+      DEFAULT_WIKI_GRAPH_SAMPLING[WikiGraphScope.EditorCompress],
+      input
+    ),
+    [WikiGraphScope.EditorReview]: applySamplingOverrides(
+      DEFAULT_WIKI_GRAPH_SAMPLING[WikiGraphScope.EditorReview],
+      input
+    ),
+    [WikiGraphScope.EditorReviewGuide]: applySamplingOverrides(
+      DEFAULT_WIKI_GRAPH_SAMPLING[WikiGraphScope.EditorReviewGuide],
+      input
+    ),
+    [WikiGraphScope.ReaderChoice]: applySamplingOverrides(
+      DEFAULT_WIKI_GRAPH_SAMPLING[WikiGraphScope.ReaderChoice],
+      input
+    ),
+    [WikiGraphScope.ReaderExtraction]: applySamplingOverrides(
+      DEFAULT_WIKI_GRAPH_SAMPLING[WikiGraphScope.ReaderExtraction],
+      input
+    )
+  });
+}
+function applySamplingOverrides(profile, input) {
+  return Object.freeze({
+    ...profile,
+    ...input.temperature === void 0 ? {} : { temperature: input.temperature },
+    ...input.topP === void 0 ? {} : { topP: input.topP }
+  });
+}
+export {
+  createDefaultWikiGraphSampling
+};
+//# sourceMappingURL=llm-sampling.js.map

package/dist/facade/llm-sampling.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/facade/llm-sampling.ts"],"sourcesContent":["import { WikiGraphScope } from \"../common/llm-scope.js\";\nimport type {\n  SamplingProfile,\n  SamplingScopeConfig,\n  TemperatureSetting,\n} from \"../llm/index.js\";\n\nexport type WikiGraphSamplingConfig = SamplingScopeConfig<WikiGraphScope>;\n\nconst DEFAULT_WIKI_GRAPH_SAMPLING = Object.freeze({\n  [WikiGraphScope.EditorCompress]: Object.freeze({\n    temperature: 0.7,\n    topP: 0.9,\n  }),\n  [WikiGraphScope.EditorReview]: Object.freeze({\n    temperature: [0.3, 0.95] as const,\n    topP: [0.4, 0.8] as const,\n  }),\n  [WikiGraphScope.EditorReviewGuide]: Object.freeze({\n    temperature: 0.4,\n    topP: 0.6,\n  }),\n  [WikiGraphScope.ReaderChoice]: Object.freeze({\n    temperature: [0.3, 0.95] as const,\n    topP: [0.4, 0.8] as const,\n  }),\n  [WikiGraphScope.ReaderExtraction]: Object.freeze({\n    temperature: [0.3, 0.95] as const,\n    topP: [0.4, 0.8] as const,\n  }),\n} satisfies WikiGraphSamplingConfig);\n\nexport function createDefaultWikiGraphSampling(\n  input: {\n    readonly temperature?: TemperatureSetting;\n    readonly topP?: TemperatureSetting;\n  } = {},\n): WikiGraphSamplingConfig {\n  return Object.freeze({\n    [WikiGraphScope.EditorCompress]: applySamplingOverrides(\n      DEFAULT_WIKI_GRAPH_SAMPLING[WikiGraphScope.EditorCompress],\n      input,\n    ),\n    [WikiGraphScope.EditorReview]: applySamplingOverrides(\n      DEFAULT_WIKI_GRAPH_SAMPLING[WikiGraphScope.EditorReview],\n      input,\n    ),\n    [WikiGraphScope.EditorReviewGuide]: applySamplingOverrides(\n      DEFAULT_WIKI_GRAPH_SAMPLING[WikiGraphScope.EditorReviewGuide],\n      input,\n    ),\n    [WikiGraphScope.ReaderChoice]: applySamplingOverrides(\n      DEFAULT_WIKI_GRAPH_SAMPLING[WikiGraphScope.ReaderChoice],\n      input,\n    ),\n    [WikiGraphScope.ReaderExtraction]: applySamplingOverrides(\n      DEFAULT_WIKI_GRAPH_SAMPLING[WikiGraphScope.ReaderExtraction],\n      input,\n    ),\n  } satisfies WikiGraphSamplingConfig);\n}\n\nfunction applySamplingOverrides(\n  profile: SamplingProfile,\n  input: {\n    readonly temperature?: TemperatureSetting;\n    readonly topP?: TemperatureSetting;\n  },\n): SamplingProfile {\n  return Object.freeze({\n    ...profile,\n    ...(input.temperature === undefined\n      ? {}\n      : { temperature: input.temperature }),\n    ...(input.topP === undefined ? {} : { topP: input.topP }),\n  });\n}\n"],"mappings":"AAAA,SAAS,sBAAsB;AAS/B,MAAM,8BAA8B,OAAO,OAAO;AAAA,EAChD,CAAC,eAAe,cAAc,GAAG,OAAO,OAAO;AAAA,IAC7C,aAAa;AAAA,IACb,MAAM;AAAA,EACR,CAAC;AAAA,EACD,CAAC,eAAe,YAAY,GAAG,OAAO,OAAO;AAAA,IAC3C,aAAa,CAAC,KAAK,IAAI;AAAA,IACvB,MAAM,CAAC,KAAK,GAAG;AAAA,EACjB,CAAC;AAAA,EACD,CAAC,eAAe,iBAAiB,GAAG,OAAO,OAAO;AAAA,IAChD,aAAa;AAAA,IACb,MAAM;AAAA,EACR,CAAC;AAAA,EACD,CAAC,eAAe,YAAY,GAAG,OAAO,OAAO;AAAA,IAC3C,aAAa,CAAC,KAAK,IAAI;AAAA,IACvB,MAAM,CAAC,KAAK,GAAG;AAAA,EACjB,CAAC;AAAA,EACD,CAAC,eAAe,gBAAgB,GAAG,OAAO,OAAO;AAAA,IAC/C,aAAa,CAAC,KAAK,IAAI;AAAA,IACvB,MAAM,CAAC,KAAK,GAAG;AAAA,EACjB,CAAC;AACH,CAAmC;AAE5B,SAAS,+BACd,QAGI,CAAC,GACoB;AACzB,SAAO,OAAO,OAAO;AAAA,IACnB,CAAC,eAAe,cAAc,GAAG;AAAA,MAC/B,4BAA4B,eAAe,cAAc;AAAA,MACzD;AAAA,IACF;AAAA,IACA,CAAC,eAAe,YAAY,GAAG;AAAA,MAC7B,4BAA4B,eAAe,YAAY;AAAA,MACvD;AAAA,IACF;AAAA,IACA,CAAC,eAAe,iBAAiB,GAAG;AAAA,MAClC,4BAA4B,eAAe,iBAAiB;AAAA,MAC5D;AAAA,IACF;AAAA,IACA,CAAC,eAAe,YAAY,GAAG;AAAA,MAC7B,4BAA4B,eAAe,YAAY;AAAA,MACvD;AAAA,IACF;AAAA,IACA,CAAC,eAAe,gBAAgB,GAAG;AAAA,MACjC,4BAA4B,eAAe,gBAAgB;AAAA,MAC3D;AAAA,IACF;AAAA,EACF,CAAmC;AACrC;AAEA,SAAS,uBACP,SACA,OAIiB;AACjB,SAAO,OAAO,OAAO;AAAA,IACnB,GAAG;AAAA,IACH,GAAI,MAAM,gBAAgB,SACtB,CAAC,IACD,EAAE,aAAa,MAAM,YAAY;AAAA,IACrC,GAAI,MAAM,SAAS,SAAY,CAAC,IAAI,EAAE,MAAM,MAAM,KAAK;AAAA,EACzD,CAAC;AACH;","names":[]}

package/dist/facade/types.d.ts

@@ -0,0 +1,8 @@
+interface WikiGraphSerialEntry {
+    readonly fragmentCount: number;
+    readonly serialId: number;
+    readonly title: string | null;
+    readonly tocPath: readonly string[];
+}
+
+export type { WikiGraphSerialEntry };

package/dist/facade/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/facade/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/facade/wiki-graph-archive.d.ts

@@ -0,0 +1,41 @@
+import { ReadonlyDocument } from '../document/document.js';
+import { BookMeta } from '../source/meta.js';
+import { SourceAsset } from '../source/types.js';
+import { TocFile } from '../source/toc.js';
+import { ChapterStage } from './chapter.js';
+import { WikiGraphSerialEntry } from './types.js';
+import '../document/database.js';
+import 'sqlite3';
+import '../document/text-streams.js';
+import '../document/types.js';
+import '../document/stores.js';
+import 'zod';
+import '../common/language.js';
+import '../common/llm-scope.js';
+import '../llm/client.js';
+import '../llm/context.js';
+import '../llm/cache.js';
+import '../llm/types.js';
+import 'ai';
+import '../reader/types.js';
+import '../reader/attention/attention.js';
+import '../reader/chunk-batch/types.js';
+import '../reader/segment/types.js';
+import '../serial.js';
+
+declare class WikiGraphArchive {
+    #private;
+    constructor(document: ReadonlyDocument, documentDirectoryPath: string);
+    exportEpub(path: string): Promise<void>;
+    exportText(path: string): Promise<void>;
+    readCover(): Promise<SourceAsset | undefined>;
+    readMeta(): Promise<BookMeta | undefined>;
+    readToc(): Promise<TocFile | undefined>;
+    readArchiveFormatVersion(): Promise<number>;
+    readChapterStage(serialId: number): Promise<ChapterStage>;
+    listSerials(): Promise<readonly WikiGraphSerialEntry[]>;
+    readSerialSummary(serialId: number): Promise<string>;
+    saveAs(path: string): Promise<void>;
+}
+
+export { WikiGraphArchive };

package/dist/facade/wiki-graph-archive.js

@@ -0,0 +1,130 @@
+import { writeEpub, writePlainText } from "../output/index.js";
+import {
+  readWikgArchiveFormatVersion,
+  writeWikgArchive
+} from "../wikg/index.js";
+class WikiGraphArchive {
+  #document;
+  #documentDirectoryPath;
+  constructor(document, documentDirectoryPath) {
+    this.#document = document;
+    this.#documentDirectoryPath = documentDirectoryPath;
+  }
+  async exportEpub(path) {
+    await writeEpub({
+      document: this.#document,
+      path
+    });
+  }
+  async exportText(path) {
+    await writePlainText({
+      document: this.#document,
+      path
+    });
+  }
+  async readCover() {
+    return await this.#document.readCover();
+  }
+  async readMeta() {
+    return await this.#document.readBookMeta();
+  }
+  async readToc() {
+    return await this.#document.readToc();
+  }
+  async readArchiveFormatVersion() {
+    return await readWikgArchiveFormatVersion(this.#documentDirectoryPath);
+  }
+  async readChapterStage(serialId) {
+    return await this.#document.openSession(async (document) => {
+      const toc = await document.readToc();
+      if (toc === void 0) {
+        throw new Error("Document TOC is missing");
+      }
+      if (!toc.items.some((item) => hasSerialId(item, serialId))) {
+        throw new Error(
+          `Chapter ${serialId} does not exist. Use \`wg <archive-uri>/chapter list\` to discover chapter ids.`
+        );
+      }
+      const summary = await document.readSummary(serialId);
+      if (summary !== void 0) {
+        return "summarized";
+      }
+      const serial = await document.serials.getById(serialId);
+      if (serial?.topologyReady === true) {
+        return "graphed";
+      }
+      if ((await document.getSerialFragments(serialId).listFragmentIds()).length > 0) {
+        return "sourced";
+      }
+      return "planned";
+    });
+  }
+  async listSerials() {
+    return await this.#document.openSession(async (document) => {
+      const toc = await document.readToc();
+      if (toc === void 0) {
+        throw new Error("Document TOC is missing");
+      }
+      return await collectSerialEntries(document, toc.items);
+    });
+  }
+  async readSerialSummary(serialId) {
+    return await this.#document.openSession(async (document) => {
+      const record = await document.serials.getById(serialId);
+      if (record === void 0) {
+        throw new Error(
+          `No completed summary exists for id ${serialId}. Use \`wg wikg://<archive.wikg>/chapter list\` to discover chapter ids, then \`wg wikg://<archive.wikg>/chapter/${serialId}/summary get\` after summary is ready.`
+        );
+      }
+      const summary = await document.readSummary(serialId);
+      if (summary === void 0) {
+        throw new Error(
+          `Chapter ${serialId} summary is missing. Run \`wg wikg://local/job add --input <chapter-uri> --task reading-summary --accept-cost\` before export, or inspect the archive with \`wg <archive-uri>/chapter/tree get\`.`
+        );
+      }
+      return summary;
+    });
+  }
+  async saveAs(path) {
+    await flushDocument(this.#document);
+    await writeWikgArchive(this.#documentDirectoryPath, path);
+  }
+}
+function hasSerialId(item, serialId) {
+  return item.serialId === serialId || item.children.some((child) => hasSerialId(child, serialId));
+}
+async function flushDocument(document) {
+  if (!isFlushableDocument(document)) {
+    return;
+  }
+  await document.flush();
+}
+function isFlushableDocument(document) {
+  return "flush" in document && typeof document.flush === "function";
+}
+async function collectSerialEntries(document, items, ancestorTitles = []) {
+  const entries = [];
+  for (const item of items) {
+    const title = item.title?.trim() || `Chapter ${item.serialId ?? "group"}`;
+    const tocPath = [...ancestorTitles, title];
+    if (item.serialId !== void 0) {
+      const summary = await document.readSummary(item.serialId);
+      if (summary !== void 0) {
+        entries.push({
+          fragmentCount: (await document.getSerialFragments(item.serialId).listFragmentIds()).length,
+          serialId: item.serialId,
+          title,
+          tocPath
+        });
+      }
+    }
+    entries.push(
+      ...await collectSerialEntries(document, item.children, tocPath)
+    );
+  }
+  return entries;
+}
+export {
+  WikiGraphArchive
+};
+//# sourceMappingURL=wiki-graph-archive.js.map

package/dist/facade/wiki-graph-archive.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/facade/wiki-graph-archive.ts"],"sourcesContent":["import type { ReadonlyDocument } from \"../document/index.js\";\nimport { writeEpub, writePlainText } from \"../output/index.js\";\nimport type {\n  BookMeta,\n  SourceAsset,\n  TocFile,\n  TocItem,\n} from \"../source/index.js\";\n\nimport {\n  readWikgArchiveFormatVersion,\n  writeWikgArchive,\n} from \"../wikg/index.js\";\nimport type { ChapterStage } from \"./chapter.js\";\nimport type { WikiGraphSerialEntry } from \"./types.js\";\n\nexport class WikiGraphArchive {\n  readonly #document: ReadonlyDocument;\n  readonly #documentDirectoryPath: string;\n\n  public constructor(\n    document: ReadonlyDocument,\n    documentDirectoryPath: string,\n  ) {\n    this.#document = document;\n    this.#documentDirectoryPath = documentDirectoryPath;\n  }\n\n  public async exportEpub(path: string): Promise<void> {\n    await writeEpub({\n      document: this.#document,\n      path,\n    });\n  }\n\n  public async exportText(path: string): Promise<void> {\n    await writePlainText({\n      document: this.#document,\n      path,\n    });\n  }\n\n  public async readCover(): Promise<SourceAsset | undefined> {\n    return await this.#document.readCover();\n  }\n\n  public async readMeta(): Promise<BookMeta | undefined> {\n    return await this.#document.readBookMeta();\n  }\n\n  public async readToc(): Promise<TocFile | undefined> {\n    return await this.#document.readToc();\n  }\n\n  public async readArchiveFormatVersion(): Promise<number> {\n    return await readWikgArchiveFormatVersion(this.#documentDirectoryPath);\n  }\n\n  public async readChapterStage(serialId: number): Promise<ChapterStage> {\n    return await this.#document.openSession(async (document) => {\n      const toc = await document.readToc();\n\n      if (toc === undefined) {\n        throw new Error(\"Document TOC is missing\");\n      }\n      if (!toc.items.some((item) => hasSerialId(item, serialId))) {\n        throw new Error(\n          `Chapter ${serialId} does not exist. Use \\`wg <archive-uri>/chapter list\\` to discover chapter ids.`,\n        );\n      }\n\n      const summary = await document.readSummary(serialId);\n\n      if (summary !== undefined) {\n        return \"summarized\";\n      }\n\n      const serial = await document.serials.getById(serialId);\n\n      if (serial?.topologyReady === true) {\n        return \"graphed\";\n      }\n      if (\n        (await document.getSerialFragments(serialId).listFragmentIds()).length >\n        0\n      ) {\n        return \"sourced\";\n      }\n\n      return \"planned\";\n    });\n  }\n\n  public async listSerials(): Promise<readonly WikiGraphSerialEntry[]> {\n    return await this.#document.openSession(async (document) => {\n      const toc = await document.readToc();\n\n      if (toc === undefined) {\n        throw new Error(\"Document TOC is missing\");\n      }\n\n      return await collectSerialEntries(document, toc.items);\n    });\n  }\n\n  public async readSerialSummary(serialId: number): Promise<string> {\n    return await this.#document.openSession(async (document) => {\n      const record = await document.serials.getById(serialId);\n\n      if (record === undefined) {\n        throw new Error(\n          `No completed summary exists for id ${serialId}. Use \\`wg wikg://<archive.wikg>/chapter list\\` to discover chapter ids, then \\`wg wikg://<archive.wikg>/chapter/${serialId}/summary get\\` after summary is ready.`,\n        );\n      }\n\n      const summary = await document.readSummary(serialId);\n\n      if (summary === undefined) {\n        throw new Error(\n          `Chapter ${serialId} summary is missing. Run \\`wg wikg://local/job add --input <chapter-uri> --task reading-summary --accept-cost\\` before export, or inspect the archive with \\`wg <archive-uri>/chapter/tree get\\`.`,\n        );\n      }\n\n      return summary;\n    });\n  }\n\n  public async saveAs(path: string): Promise<void> {\n    await flushDocument(this.#document);\n    await writeWikgArchive(this.#documentDirectoryPath, path);\n  }\n}\n\nfunction hasSerialId(item: TocItem, serialId: number): boolean {\n  return (\n    item.serialId === serialId ||\n    item.children.some((child) => hasSerialId(child, serialId))\n  );\n}\n\nasync function flushDocument(document: ReadonlyDocument): Promise<void> {\n  if (!isFlushableDocument(document)) {\n    return;\n  }\n\n  await document.flush();\n}\n\nfunction isFlushableDocument(\n  document: ReadonlyDocument,\n): document is ReadonlyDocument & { flush(): Promise<void> } {\n  return \"flush\" in document && typeof document.flush === \"function\";\n}\n\nasync function collectSerialEntries(\n  document: ReadonlyDocument,\n  items: readonly TocItem[],\n  ancestorTitles: readonly string[] = [],\n): Promise<readonly WikiGraphSerialEntry[]> {\n  const entries: WikiGraphSerialEntry[] = [];\n\n  for (const item of items) {\n    const title = item.title?.trim() || `Chapter ${item.serialId ?? \"group\"}`;\n    const tocPath = [...ancestorTitles, title];\n\n    if (item.serialId !== undefined) {\n      const summary = await document.readSummary(item.serialId);\n\n      if (summary !== undefined) {\n        entries.push({\n          fragmentCount: (\n            await document.getSerialFragments(item.serialId).listFragmentIds()\n          ).length,\n          serialId: item.serialId,\n          title,\n          tocPath,\n        });\n      }\n    }\n\n    entries.push(\n      ...(await collectSerialEntries(document, item.children, tocPath)),\n    );\n  }\n\n  return entries;\n}\n"],"mappings":"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","names":[]}

package/dist/gc/files.d.ts

@@ -0,0 +1,15 @@
+declare function isDisposableDirectoryEntry(name: string): boolean;
+declare function removeDisposableDirectory(directoryPath: string): Promise<number>;
+declare function removeDisposableChildDirectories(rootPath: string): Promise<{
+    readonly freedBytes: number;
+    readonly removed: number;
+    readonly scanned: number;
+}>;
+declare function removeDisposableDescendantDirectories(rootPath: string): Promise<{
+    readonly freedBytes: number;
+    readonly removed: number;
+    readonly scanned: number;
+}>;
+declare function readPathSize(path: string): Promise<number>;
+
+export { isDisposableDirectoryEntry, readPathSize, removeDisposableChildDirectories, removeDisposableDescendantDirectories, removeDisposableDirectory };

package/dist/gc/files.js

@@ -0,0 +1,141 @@
+import { readdir, rm, rmdir, stat } from "fs/promises";
+import { join } from "path";
+import { isNodeError } from "../utils/node-error.js";
+const DISPOSABLE_DIRECTORY_ENTRIES = /* @__PURE__ */ new Set([".DS_Store"]);
+const DISPOSABLE_DIRECTORY_TTL_MS = 6e4;
+function isDisposableDirectoryEntry(name) {
+  return DISPOSABLE_DIRECTORY_ENTRIES.has(name);
+}
+async function removeDisposableDirectory(directoryPath) {
+  const entries = await readdir(directoryPath).catch((error) => {
+    if (isNodeError(error) && error.code === "ENOENT") {
+      return void 0;
+    }
+    throw error;
+  });
+  if (entries === void 0) {
+    return 0;
+  }
+  if (entries.some((entry) => !isDisposableDirectoryEntry(entry))) {
+    return 0;
+  }
+  let freedBytes = 0;
+  for (const entry of entries) {
+    const path = join(directoryPath, entry);
+    freedBytes += await readPathSize(path);
+    await rm(path, { force: true, recursive: true });
+  }
+  await rmdir(directoryPath).catch((error) => {
+    if (isNodeError(error) && error.code === "ENOENT") {
+      return;
+    }
+    throw error;
+  });
+  return freedBytes;
+}
+async function removeDisposableChildDirectories(rootPath) {
+  const entries = await readdir(rootPath, { withFileTypes: true }).catch(
+    (error) => {
+      if (isNodeError(error) && error.code === "ENOENT") {
+        return [];
+      }
+      throw error;
+    }
+  );
+  let freedBytes = 0;
+  let removed = 0;
+  let scanned = 0;
+  for (const entry of entries) {
+    if (!entry.isDirectory()) {
+      continue;
+    }
+    scanned += 1;
+    const directoryPath = join(rootPath, entry.name);
+    const stats = await stat(directoryPath).catch((error) => {
+      if (isNodeError(error) && error.code === "ENOENT") {
+        return void 0;
+      }
+      throw error;
+    });
+    if (stats === void 0 || Date.now() - stats.mtimeMs < DISPOSABLE_DIRECTORY_TTL_MS) {
+      continue;
+    }
+    const removedBytes = await removeDisposableDirectory(directoryPath);
+    if (await pathExists(directoryPath)) {
+      freedBytes += removedBytes;
+      continue;
+    }
+    freedBytes += removedBytes;
+    removed += 1;
+  }
+  return { freedBytes, removed, scanned };
+}
+async function removeDisposableDescendantDirectories(rootPath) {
+  const entries = await readdir(rootPath, { withFileTypes: true }).catch(
+    (error) => {
+      if (isNodeError(error) && error.code === "ENOENT") {
+        return [];
+      }
+      throw error;
+    }
+  );
+  let freedBytes = 0;
+  let removed = 0;
+  let scanned = 0;
+  for (const entry of entries) {
+    if (!entry.isDirectory()) {
+      continue;
+    }
+    const directoryPath = join(rootPath, entry.name);
+    const childResult = await removeDisposableDescendantDirectories(directoryPath);
+    freedBytes += childResult.freedBytes;
+    removed += childResult.removed;
+    scanned += childResult.scanned + 1;
+    const removedBytes = await removeDisposableDirectory(directoryPath);
+    if (await pathExists(directoryPath)) {
+      freedBytes += removedBytes;
+      continue;
+    }
+    freedBytes += removedBytes;
+    removed += 1;
+  }
+  return { freedBytes, removed, scanned };
+}
+async function readPathSize(path) {
+  try {
+    const stats = await stat(path);
+    if (stats.isDirectory()) {
+      const entries = await readdir(path);
+      let size = 0;
+      for (const entry of entries) {
+        size += await readPathSize(join(path, entry));
+      }
+      return size;
+    }
+    return stats.size;
+  } catch (error) {
+    if (isNodeError(error) && error.code === "ENOENT") {
+      return 0;
+    }
+    throw error;
+  }
+}
+async function pathExists(path) {
+  try {
+    await stat(path);
+    return true;
+  } catch (error) {
+    if (isNodeError(error) && error.code === "ENOENT") {
+      return false;
+    }
+    throw error;
+  }
+}
+export {
+  isDisposableDirectoryEntry,
+  readPathSize,
+  removeDisposableChildDirectories,
+  removeDisposableDescendantDirectories,
+  removeDisposableDirectory
+};
+//# sourceMappingURL=files.js.map

package/dist/gc/files.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/gc/files.ts"],"sourcesContent":["import { readdir, rm, rmdir, stat } from \"fs/promises\";\nimport { join } from \"path\";\n\nimport { isNodeError } from \"../utils/node-error.js\";\n\nconst DISPOSABLE_DIRECTORY_ENTRIES = new Set([\".DS_Store\"]);\nconst DISPOSABLE_DIRECTORY_TTL_MS = 60_000;\n\nexport function isDisposableDirectoryEntry(name: string): boolean {\n  return DISPOSABLE_DIRECTORY_ENTRIES.has(name);\n}\n\nexport async function removeDisposableDirectory(\n  directoryPath: string,\n): Promise<number> {\n  const entries = await readdir(directoryPath).catch((error: unknown) => {\n    if (isNodeError(error) && error.code === \"ENOENT\") {\n      return undefined;\n    }\n\n    throw error;\n  });\n\n  if (entries === undefined) {\n    return 0;\n  }\n  if (entries.some((entry) => !isDisposableDirectoryEntry(entry))) {\n    return 0;\n  }\n\n  let freedBytes = 0;\n\n  for (const entry of entries) {\n    const path = join(directoryPath, entry);\n\n    freedBytes += await readPathSize(path);\n    await rm(path, { force: true, recursive: true });\n  }\n\n  await rmdir(directoryPath).catch((error: unknown) => {\n    if (isNodeError(error) && error.code === \"ENOENT\") {\n      return;\n    }\n\n    throw error;\n  });\n  return freedBytes;\n}\n\nexport async function removeDisposableChildDirectories(\n  rootPath: string,\n): Promise<{\n  readonly freedBytes: number;\n  readonly removed: number;\n  readonly scanned: number;\n}> {\n  const entries = await readdir(rootPath, { withFileTypes: true }).catch(\n    (error: unknown) => {\n      if (isNodeError(error) && error.code === \"ENOENT\") {\n        return [];\n      }\n\n      throw error;\n    },\n  );\n  let freedBytes = 0;\n  let removed = 0;\n  let scanned = 0;\n\n  for (const entry of entries) {\n    if (!entry.isDirectory()) {\n      continue;\n    }\n\n    scanned += 1;\n    const directoryPath = join(rootPath, entry.name);\n    const stats = await stat(directoryPath).catch((error: unknown) => {\n      if (isNodeError(error) && error.code === \"ENOENT\") {\n        return undefined;\n      }\n\n      throw error;\n    });\n\n    if (\n      stats === undefined ||\n      Date.now() - stats.mtimeMs < DISPOSABLE_DIRECTORY_TTL_MS\n    ) {\n      continue;\n    }\n\n    const removedBytes = await removeDisposableDirectory(directoryPath);\n\n    if (await pathExists(directoryPath)) {\n      freedBytes += removedBytes;\n      continue;\n    }\n\n    freedBytes += removedBytes;\n    removed += 1;\n  }\n\n  return { freedBytes, removed, scanned };\n}\n\nexport async function removeDisposableDescendantDirectories(\n  rootPath: string,\n): Promise<{\n  readonly freedBytes: number;\n  readonly removed: number;\n  readonly scanned: number;\n}> {\n  const entries = await readdir(rootPath, { withFileTypes: true }).catch(\n    (error: unknown) => {\n      if (isNodeError(error) && error.code === \"ENOENT\") {\n        return [];\n      }\n\n      throw error;\n    },\n  );\n  let freedBytes = 0;\n  let removed = 0;\n  let scanned = 0;\n\n  for (const entry of entries) {\n    if (!entry.isDirectory()) {\n      continue;\n    }\n\n    const directoryPath = join(rootPath, entry.name);\n    const childResult =\n      await removeDisposableDescendantDirectories(directoryPath);\n\n    freedBytes += childResult.freedBytes;\n    removed += childResult.removed;\n    scanned += childResult.scanned + 1;\n\n    const removedBytes = await removeDisposableDirectory(directoryPath);\n\n    if (await pathExists(directoryPath)) {\n      freedBytes += removedBytes;\n      continue;\n    }\n\n    freedBytes += removedBytes;\n    removed += 1;\n  }\n\n  return { freedBytes, removed, scanned };\n}\n\nexport async function readPathSize(path: string): Promise<number> {\n  try {\n    const stats = await stat(path);\n\n    if (stats.isDirectory()) {\n      const entries = await readdir(path);\n      let size = 0;\n\n      for (const entry of entries) {\n        size += await readPathSize(join(path, entry));\n      }\n\n      return size;\n    }\n\n    return stats.size;\n  } catch (error) {\n    if (isNodeError(error) && error.code === \"ENOENT\") {\n      return 0;\n    }\n\n    throw error;\n  }\n}\n\nasync function pathExists(path: string): Promise<boolean> {\n  try {\n    await stat(path);\n    return true;\n  } catch (error) {\n    if (isNodeError(error) && error.code === \"ENOENT\") {\n      return false;\n    }\n\n    throw error;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/gc/index.d.ts

@@ -0,0 +1,2 @@
+export { tryRunWikiGraphGc } from './runner.js';
+export { GcContext, GcJob, GcJobReport, GcJobResult, GcRunReport } from './types.js';

package/dist/gc/index.js

@@ -0,0 +1,5 @@
+import { tryRunWikiGraphGc } from "./runner.js";
+export {
+  tryRunWikiGraphGc
+};
+//# sourceMappingURL=index.js.map

package/dist/gc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/gc/index.ts"],"sourcesContent":["export { tryRunWikiGraphGc } from \"./runner.js\";\nexport type {\n  GcContext,\n  GcJob,\n  GcJobReport,\n  GcJobResult,\n  GcRunReport,\n} from \"./types.js\";\n"],"mappings":"AAAA,SAAS,yBAAyB;","names":[]}

package/dist/gc/lock.d.ts

@@ -0,0 +1,3 @@
+declare function tryAcquireGcLock(scope?: string): Promise<(() => Promise<void>) | undefined>;
+
+export { tryAcquireGcLock };