Added features

Added: Project Overview TUI Build Cache / Dirty Detection Post-Build Hooks gbuild status
2026-05-23 21:03:54 +02:00
parent 351ce1b06e
commit 939232e72e
18 changed files with 2768 additions and 272 deletions
@@ -0,0 +1,82 @@
+#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 */