Function safelyReadMemoryFileAsync

src/utils/claudemd.ts:430–459

* Used by processMemoryFile → getMemoryFiles so the event loop stays * responsive during the directory walk (many readFile attempts, most * ENOENT). When includeBasePath is given, @include paths are resolved in * the same lex pass and returned alongside the parsed file.

(
  filePath: string,
  type: MemoryType,
  includeBasePath?: string,
)

 * the same lex pass and returned alongside the parsed file.
 */
async function safelyReadMemoryFileAsync(
  filePath: string,
  type: MemoryType,
  includeBasePath?: string,
): Promise<{ info: MemoryFileInfo | null; includePaths: string[] }> {
  try {
    const fs = getFsImplementation()
    const rawContent = await fs.readFile(filePath, { encoding: 'utf-8' })
    const {
      content: sanitizedContent,
      stripped: strippedOperationalSections,
    } = stripOperationalProjectInstructions(rawContent, filePath, type)
    const parsed = parseMemoryFileContent(
      sanitizedContent,
      filePath,
      type,
      includeBasePath,
    )

    if (parsed.info && strippedOperationalSections) {
      parsed.info.contentDiffersFromDisk = true
      parsed.info.rawContent = rawContent
    }

    return parsed
  } catch (error) {
    handleMemoryFileReadError(error, filePath)
    return { info: null, includePaths: [] }
  }
}

type MarkdownToken = {
  type: string