refactor: standardize include structures

Standardize and clean up #include directives across all headers,
source implementation files, and unit test suites.

- Break circular dependency chains between key modules (cache, link,
  memcache, sonic, and network) using forward struct declarations
  instead of direct header inclusions.
- Group and sort system library and project-specific includes
  alphabetically at the top of each file.
- Remove redundant includes and unused forward declarations.
- Explicitly declare direct header dependencies in implementation files.

Author: fangfufu

src/cache.c

@@ -1,6 +1,7 @@
 #include "cache.h"
 
 #include "config.h"
+#include "link.h"
 #include "log.h"
 #include "memcache.h"
 #include "util.h"

src/cache.h

@@ -1,28 +1,18 @@
 #ifndef CACHE_H
 #define CACHE_H
-#include <sys/types.h>
-#include <stdio.h>
-#include <stdint.h>
 #include <pthread.h>
 #include <semaphore.h>
-
-/**
- * \file cache.h
- * \brief cache related structures and functions
- * \details
- *   - We store the metadata and the actual data separately in two
- * separate folders.
- */
-
-typedef struct Cache Cache;
-
-#include "link.h"
-#include "network.h"
+#include <stdint.h>
+#include <stdio.h>
+#include <sys/types.h>
 
 #include "util.h"
 
+typedef struct Cache Cache;
+typedef struct Link Link;
 struct TransferStruct;
 
+
 typedef struct ActiveDownload {
     off_t offset;
     struct TransferStruct *ts;

src/fuse_local.c

@@ -1,5 +1,6 @@
 #include "fuse_local.h"
 
+#include "cache.h"
 #include "link.h"
 #include "log.h"
 

src/link.c

@@ -1,18 +1,20 @@
 #include "link.h"
 
+#include "cache.h"
+#include "config.h"
 #include "log.h"
 #include "memcache.h"
+#include "network.h"
 #include "util.h"
 
-#include <gumbo.h>
-
 #include <assert.h>
 #include <ctype.h>
 #include <errno.h>
+#include <gumbo.h>
 #include <stdlib.h>
 #include <string.h>
-#include <unistd.h>
 #include <sys/param.h>
+#include <unistd.h>
 
 #define STATUS_LEN 64
 

src/link.h

@@ -6,15 +6,17 @@
  * \brief link related structures and functions
  */
 
-typedef struct Link Link;
-typedef struct LinkTable LinkTable;
+#include <curl/curl.h>
+#include <limits.h>
+#include <sys/types.h>
 
-#include "cache.h"
-#include "config.h"
-#include "network.h"
+#include "memcache.h"
 #include "sonic.h"
 
-#include <curl/curl.h>
+typedef struct Cache Cache;
+typedef struct Link Link;
+typedef struct LinkTable LinkTable;
+
 
 /**
  * \brief the link type

src/log.h

@@ -1,7 +1,6 @@
 #ifndef LOG_H
 #define LOG_H
 
-#include "util.h"
 
 /**
  * \brief Log types

src/main.c

@@ -1,15 +1,18 @@
+#include "cache.h"
+#include "config.h"
 #include "fuse_local.h"
 #include "link.h"
 #include "log.h"
+#include "network.h"
 #include "util.h"
 
 #include <ctype.h>
 #include <errno.h>
-#include <unistd.h>
-#include <sys/stat.h>
 #include <getopt.h>
 #include <stdlib.h>
 #include <string.h>
+#include <sys/stat.h>
+#include <unistd.h>
 
 void add_arg(char ***fuse_argv_ptr, int *fuse_argc, char *opt_string);
 static void print_help(char *program_name, int long_help);

src/memcache.h

@@ -1,6 +1,11 @@
 #ifndef MEMCACHE_H
 #define MEMCACHE_H
-#include "link.h"
+
+#include <stddef.h>
+
+typedef struct Link Link;
+typedef struct Cache Cache;
+
 
 /**
  * \brief specify the type of data transfer
@@ -10,7 +15,7 @@ typedef enum { FILESTAT = 's', DATA = 'd' } TransferType;
 /**
  * \brief For storing transfer data and metadata
  */
-struct TransferStruct {
+typedef struct TransferStruct {
     /** \brief The array to store the data */
     char *data;
     /** \brief The current size of the array */
@@ -25,7 +30,7 @@ struct TransferStruct {
     Cache *cache_ptr;
     /** \brief The ActiveDownload structure associated with the transfer */
     struct ActiveDownload *ad_ptr;
-};
+} TransferStruct;
 
 /**
  * \brief Callback function for file transfer

src/network.c

@@ -1,14 +1,15 @@
 #include "network.h"
 
+#include "config.h"
+#include "link.h"
 #include "log.h"
 #include "memcache.h"
 #include "util.h"
 
-#include <openssl/crypto.h>
-
 #include <errno.h>
-#include <string.h>
+#include <openssl/crypto.h>
 #include <stdio.h>
+#include <string.h>
 #include <unistd.h>
 
 /*

src/network.h

@@ -6,10 +6,6 @@
  * \brief network related functions
  */
 
-typedef struct TransferStruct TransferStruct;
-
-#include "link.h"
-
 #include <curl/curl.h>
 
 /** \brief HTTP response codes */