Function readIndexMeta

src/core/index-meta.ts:144–177

(rootDir: string)

}

export async function readIndexMeta(rootDir: string): Promise<IndexMeta> {
  const metaPath = path.join(rootDir, CODEBASE_CONTEXT_DIRNAME, INDEX_META_FILENAME);

  let parsed: unknown;
  try {
    const raw = await fs.readFile(metaPath, 'utf-8');
    parsed = JSON.parse(raw);
  } catch (error) {
    throw asIndexCorrupted('Index meta missing or unreadable (rebuild required)', error);
  }

  const result = IndexMetaSchema.safeParse(parsed);
  if (!result.success) {
    throw new IndexCorruptedError(
      `Index meta schema mismatch (rebuild required): ${result.error.message}`
    );
  }

  const meta = result.data;

  if (meta.metaVersion !== INDEX_META_VERSION) {
    throw new IndexCorruptedError(
      `Index meta version mismatch (rebuild required): expected metaVersion=${INDEX_META_VERSION}, found metaVersion=${meta.metaVersion}`
    );
  }

  if (meta.formatVersion !== INDEX_FORMAT_VERSION) {
    throw new IndexCorruptedError(
      `Index format version mismatch (rebuild required): expected formatVersion=${INDEX_FORMAT_VERSION}, found formatVersion=${meta.formatVersion}`
    );
  }

  return meta;
}

export async function validateIndexArtifacts(rootDir: string, meta: IndexMeta): Promise<void> {
  const contextDir = path.join(rootDir, CODEBASE_CONTEXT_DIRNAME);