chore: import upstream snapshot with attribution

src/foundation/constants.h

@@ -0,0 +1,97 @@
+/*
+ * constants.h — Project-wide named constants.
+ *
+ * Eliminates magic numbers flagged by readability-magic-numbers.
+ * Every literal integer/float in source should reference a named constant.
+ */
+#ifndef CBM_CONSTANTS_H
+#define CBM_CONSTANTS_H
+
+/* ── Allocation counts ───────────────────────────────────────── */
+enum { CBM_ALLOC_ONE = 1 }; /* calloc(CBM_ALLOC_ONE, sizeof(T)) */
+
+/* ── Byte / character constants ──────────────────────────────── */
+enum {
+    CBM_BYTE_RANGE = 256, /* full byte range 0x00–0xFF */
+    CBM_QUOTE_PAIR = 2,   /* two quote characters (open + close) */
+    CBM_QUOTE_OFFSET = 1, /* skip opening quote */
+};
+
+/* ── Size units (powers of 2) ────────────────────────────────── */
+enum {
+    CBM_SZ_2 = 2,
+    CBM_SZ_3 = 3,
+    CBM_SZ_4 = 4,
+    CBM_SZ_5 = 5,
+    CBM_SZ_6 = 6,
+    CBM_SZ_7 = 7,
+    CBM_SZ_8 = 8,
+    CBM_SZ_16 = 16,
+    CBM_SZ_32 = 32,
+    CBM_SZ_64 = 64,
+    CBM_SZ_128 = 128,
+    CBM_SZ_256 = 256,
+    CBM_SZ_512 = 512,
+    CBM_SZ_1K = 1024,
+    CBM_SZ_2K = 2048,
+    CBM_SZ_4K = 4096,
+    CBM_SZ_8K = 8192,
+    CBM_SZ_16K = 16384,
+    CBM_SZ_32K = 32768,
+    CBM_SZ_64K = 65536,
+};
+
+/* ── Numeric bases and common factors ────────────────────────── */
+enum {
+    CBM_DECIMAL_BASE = 10,
+    CBM_HEX_BASE = 16,
+    CBM_PERCENT = 100,
+};
+
+/* ── Tree-sitter field name helper ───────────────────────────── */
+/* Usage: ts_node_child_by_field_name(node, TS_FIELD("callee"))
+ * Expands to: ts_node_child_by_field_name(node, TS_FIELD("callee"))
+ * The sizeof includes the NUL terminator, so subtract 1. */
+#define TS_FIELD(name) (name), (uint32_t)(sizeof(name) - SKIP_ONE)
+
+/* ── Tree-sitter line offset ─────────────────────────────────── */
+/* ts_node row is 0-based; source lines are 1-based. */
+enum { TS_LINE_OFFSET = 1 };
+
+/* Common offset constants. */
+
+/* Common offset constants. */
+
+/* ── Sentinel values ─────────────────────────────────────────── */
+enum {
+    CBM_NOT_FOUND = -1, /* search miss, invalid index */
+    CBM_INIT_DONE = 1,  /* initialization flag */
+};
+
+/* ── Default pagination limits ───────────────────────────────── */
+/* Default page size for search_graph and the underlying store-layer search.
+ * Responses land in an LLM agent's context window, so the default favors a
+ * cheap first page (~50 TOON rows ≈ 1.5K tokens) over raw coverage; the
+ * response always carries 'total' and 'has_more', and agents page via
+ * offset+limit or narrow with label/file_pattern when has_more is true. */
+enum { CBM_DEFAULT_SEARCH_LIMIT = 50 };
+
+/* ── Time conversion factors ─────────────────────────────────── */
+#define CBM_NSEC_PER_SEC 1000000000ULL
+#define CBM_USEC_PER_SEC 1000000ULL
+#define CBM_MSEC_PER_SEC 1000ULL
+#define CBM_NSEC_PER_USEC 1000ULL
+#define CBM_NSEC_PER_MSEC 1000000ULL
+
+/* ── Common string/buffer sizes ──────────────────────────────── */
+enum {
+    CBM_SMALL_BUF = 3,   /* small scratch buffers */
+    CBM_NAME_BUF = 4,    /* name buffer slots */
+    CBM_PATH_MAX = 1024, /* path buffer size */
+    CBM_LINE_BUF = 512,  /* line read buffer */
+};
+
+/* Common offset constants (used across many files). */
+enum { SKIP_ONE = 1, PAIR_LEN = 2 };
+
+#endif /* CBM_CONSTANTS_H */