affaan-m/ECC · error · Error

is too large ( bytes).

Error message

${label} is too large (${opened.size} bytes).

What it means

readRegularTextFile throws when the opened file exceeds the configured maxBytes cap (default MAX_DOCUMENT_BYTES). It bounds memory usage when loading vault documents; the faulting input is the oversized file named by `label`.

Solutions

1. Split or prune the memory document below the size cap.
2. Pass a larger maxBytes option if the caller legitimately needs bigger documents.
3. Archive oversized documents instead of loading them whole.

When it happens

Trigger: Thrown at scripts/lib/memory-vault.js:170 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of affaan-m/ECC@8321021c54 (2026-09-16). Data as JSON: /api/errors/9c3ec5697f7b9402. Report an issue: GitHub.

Appendix: source

Thrown at scripts/lib/memory-vault.js:170

  const descriptor = fs.openSync(filePath, flags);
  try {
    const opened = fs.fstatSync(descriptor, { bigint: true });
    if (!opened.isFile()) {
      throw new Error(`${label} must be a regular, non-symlink file.`);
    }
    const after = fs.lstatSync(filePath, { bigint: true });
    if (
      after.isSymbolicLink()
      || !after.isFile()
      || !sameFileIdentity(after, opened)
    ) {
      throw new Error(`${label} must remain a regular, non-symlink file while it is opened.`);
    }
    if (options.trustedRoot) {
      assertWithinTrustedRoot(filePath, options.trustedRoot, `read ${label}`);
    }
    if (opened.size > BigInt(maxBytes)) {
      throw new Error(`${label} is too large (${opened.size} bytes).`);
    }

    const chunks = [];
    let total = 0;
    while (total <= maxBytes) {
      const buffer = Buffer.alloc(Math.min(64 * 1024, maxBytes + 1 - total));
      const bytesRead = fs.readSync(descriptor, buffer, 0, buffer.length, null);
      if (bytesRead === 0) break;
      chunks.push(buffer.subarray(0, bytesRead));
      total += bytesRead;
    }
    if (total > maxBytes) {
      throw new Error(`${label} is too large (maximum ${maxBytes} bytes).`);
    }
    return decodeUtf8(Buffer.concat(chunks, total), label);
  } finally {
    fs.closeSync(descriptor);
  }

View on GitHub (pinned to 8321021c54)