#ifndef INDEX_H
#define INDEX_H

#include <time.h>
#include <stddef.h>

#define IDX_MAX_PROJECTS  256
#define IDX_NAME_LEN       128
#define IDX_HASH_LEN        64
#define IDX_PATH_LEN       512

/*
 * Per-project record stored in ~/.gbuild_index.
 *
 * File format (INI-style, one section per project):
 *
 *   [myproject]
 *   last_build_rc = 0
 *   last_build_ts = 1716000000
 *   last_head_hash = abc123def456
 */
typedef struct {
    char  name[IDX_NAME_LEN];
    int   last_build_rc;        /* exit code of last make_build(); -1 = never built */
    time_t last_build_ts;       /* unix timestamp of last build attempt             */
    char  last_head_hash[IDX_HASH_LEN]; /* git HEAD hash at last build             */
} ProjectRecord;

typedef struct {
    ProjectRecord projects[IDX_MAX_PROJECTS];
    int           count;
} ProjectIndex;

/* Load ~/.gbuild_index into idx.  Returns 0 on success, -1 if not found
 * (idx is still initialised to an empty index). */
int  index_load(ProjectIndex *idx, const char *path);

/* Persist idx to path, creating or overwriting the file. */
int  index_save(const ProjectIndex *idx, const char *path);

/* Find a record by name.  Returns a pointer into idx->projects, or NULL. */
ProjectRecord *index_find(ProjectIndex *idx, const char *name);

/* Find or create a record by name.  Returns NULL only if the index is full. */
ProjectRecord *index_upsert(ProjectIndex *idx, const char *name);

/* Walk clone_dir, find every subdir that contains .git, and upsert each one
 * into idx.  Does NOT overwrite existing build metadata — only adds new
 * entries for projects that are not yet tracked.
 * Returns the number of new entries added. */
int  index_scan(ProjectIndex *idx, const char *clone_dir);

/* Canonical path for the index file (~/.gbuild_index). */
void index_get_path(char *out, size_t n);

/* ---------------------------------------------------------------- status scan */

/*
 * Per-project status gathered by project_scan_all().
 * All string fields are NUL-terminated; numeric fields are -1 when unknown.
 */
typedef struct {
    char name[IDX_NAME_LEN];
    char branch[128];       /* current branch / "(detached:HASH)" */
    int  behind;            /* commits behind upstream; -1 = no upstream/error */
    int  dirty;             /* 1 = dirty, 0 = clean, -1 = error                */
    int  last_build_rc;     /* from index; -1 = never built                    */
    time_t last_build_ts;   /* from index; 0 = never built                     */
} StatusResult;

/*
 * Scan every subdirectory of clone_dir that contains .git.
 * For each one, fetch the three git metrics and join them with build
 * metadata from idx.  Results are written into results[0..max-1].
 * Worker threads run the git queries in parallel (pool of SCAN_THREADS).
 * Returns the number of projects found (may be 0, capped at max).
 */
#define SCAN_THREADS 6
int project_scan_all(const char *clone_dir, const ProjectIndex *idx,
                     StatusResult *results, int max);

#endif /* INDEX_H */