Function readPlanFromGuarded

src/commands/test.ts:1974–2024

* Read + validate a plan JSON file. Returns the parsed `CliPlanInput` * on success, throws a typed `VALIDATION_ERROR` envelope on any * schema problem (missing fields, wrong types, oversize body, etc.). * * Stat-first guard mirrors piece-2's `readCodeFileGuarded` — reject * obvious oversize fil

(path: string)

 * plans the cap is 256 KB (vs. 350 KB for code).
 */
function readPlanFromGuarded(path: string): CliPlanInput {
  const absolute = resolveAbsolute(path);

  let stat;
  try {
    stat = statSync(absolute);
  } catch (err) {
    const code = (err as NodeJS.ErrnoException).code;
    if (code === 'ENOENT') {
      throw localValidationError('plan-from', `file does not exist: ${path}`);
    }
    if (code === 'EACCES') {
      throw localValidationError('plan-from', `permission denied reading ${path}`);
    }
    const reason = err instanceof Error ? err.message : 'unknown error';
    throw localValidationError('plan-from', `cannot stat ${path}: ${reason}`);
  }
  if (stat.size > MAX_PLAN_BODY_BYTES) {
    throw ApiError.fromEnvelope({
      error: {
        code: 'PAYLOAD_TOO_LARGE',
        message: `Plan body exceeds the 256 KB CLI cap (${stat.size} bytes).`,
        nextAction: 'Split into multiple smaller tests or trim step descriptions.',
        requestId: 'local',
        details: {
          field: 'plan-from',
          sizeBytes: stat.size,
          maxBytes: MAX_PLAN_BODY_BYTES,
        },
      },
    });
  }

  let raw;
  try {
    raw = stripBom(readFileSync(absolute, 'utf8'));
  } catch (err) {
    const reason = err instanceof Error ? err.message : 'unknown error';
    throw localValidationError('plan-from', `cannot read ${path}: ${reason}`);
  }

  let parsed: unknown;
  try {
    parsed = JSON.parse(raw);
  } catch (err) {
    const reason = err instanceof Error ? err.message : 'unknown error';
    throw localValidationError('plan-from', `not valid JSON: ${reason}`);
  }

  return assertPlanShape(parsed);
}

/**
 * Type-narrow + validate a parsed plan input. Pulled out so the same