Function readSingleFile

src/node/utils/main/instructionFiles.ts:71–102

Read a single instruction file via the given reader, returning structured info.

(
  reader: FileReader,
  directory: string,
  filename: string,
  scope: InstructionScope,
  isLocal: boolean,
  projectName: string | undefined,
  muxOnly: boolean
)

/** Read a single instruction file via the given reader, returning structured info. */
async function readSingleFile(
  reader: FileReader,
  directory: string,
  filename: string,
  scope: InstructionScope,
  isLocal: boolean,
  projectName: string | undefined,
  muxOnly: boolean
): Promise<ReadInstructionFileResult> {
  let raw: string;
  try {
    raw = await reader.readFile(path.join(directory, filename));
  } catch {
    return { exists: false };
  }
  const sanitized = stripMarkdownComments(raw);
  if (sanitized.length === 0) return { exists: true, file: null };
  return {
    exists: true,
    file: {
      path: path.join(directory, filename),
      filename,
      isLocal,
      muxOnly,
      scope,
      projectName: projectName ?? null,
      content: sanitized,
      bytes: Buffer.byteLength(sanitized, "utf-8"),
      tokens: null,
    },
  };
}

/** Try each base filename in priority order; return the first that exists. */
async function readBaseInstructionFile(