feat: extract const literal values into symbols.value

Captures string, number, boolean, null, negative numbers, `as const`,
and simple template literals. 615 values extracted on benchmark repo.

Author: SutuSebastian

.agents/rules/codemap.mdc

@@ -98,6 +98,7 @@ bun src/index.ts query --json "<SQL>"
 | Type/interface shape | `SELECT name, type, is_optional, is_readonly FROM type_members WHERE symbol_name = '...'` |
 | Deprecated symbols | `SELECT name, kind, file_path, doc_comment FROM symbols WHERE doc_comment LIKE '%@deprecated%'` |
 | Symbol docs | `SELECT name, signature, doc_comment FROM symbols WHERE name = '...' AND doc_comment IS NOT NULL` |
+| Const values | `SELECT name, value, file_path FROM symbols WHERE kind = 'const' AND value IS NOT NULL AND name LIKE '%...'` |
 
 **Use `DISTINCT`** on dependency and import queries — a file importing multiple specifiers from the same module produces duplicate rows.
 

.agents/skills/codemap/SKILL.md

@@ -90,6 +90,7 @@ LIMIT 10
 | is_default_export | INTEGER    | 1 if default export                                       |
 | members           | TEXT       | JSON enum members (NULL for non-enums)                    |
 | doc_comment       | TEXT       | Leading JSDoc text (cleaned), NULL when absent            |
+| value             | TEXT       | Literal value for consts (`"ok"`, `42`, `true`, `null`)   |
 
 ### `type_members` — Properties of interfaces and object-literal type aliases
 
@@ -220,6 +221,10 @@ WHERE doc_comment LIKE '%@deprecated%';
 SELECT name, signature, doc_comment FROM symbols
 WHERE name = 'formatCurrency' AND doc_comment IS NOT NULL;
 
+-- Const values (config flags, magic strings)
+SELECT name, value, file_path FROM symbols
+WHERE kind = 'const' AND value IS NOT NULL AND name LIKE '%URL%';
+
 -- File overview (imports + exports)
 SELECT 'import' as dir, source as name, specifiers as detail
 FROM imports WHERE file_path LIKE '%OrderRow%'

docs/architecture.md

@@ -186,6 +186,7 @@ All tables use `STRICT` mode. Tables marked with `WITHOUT ROWID` store data dire
 | is_default_export | INTEGER    | 1 if default export                                                                                                                                                                 |
 | members           | TEXT       | JSON array of enum members (NULL for non-enums). Each entry: `{"name":"…","value":"…"}` (value omitted for implicit-value enums)                                                    |
 | doc_comment       | TEXT       | Leading JSDoc comment text (cleaned: `*` prefixes stripped, trimmed). NULL when absent. Preserves `@deprecated`, `@param`, etc. tags                                                |
+| value             | TEXT       | Literal value for `const` declarations (strings, numbers, booleans, `null`). NULL for non-literal or non-const symbols. Handles `as const` and simple template literals             |
 
 ### `type_members` — Properties and methods of interfaces and object-literal types (`STRICT`)
 

src/db.ts

@@ -51,7 +51,8 @@ export function createTables(db: CodemapDatabase) {
       is_exported INTEGER DEFAULT 0,
       is_default_export INTEGER DEFAULT 0,
       members TEXT,
-      doc_comment TEXT
+      doc_comment TEXT,
+      value TEXT
     ) STRICT;
 
     CREATE TABLE IF NOT EXISTS imports (
@@ -272,6 +273,7 @@ export interface SymbolRow {
   is_default_export: number;
   members: string | null;
   doc_comment: string | null;
+  value: string | null;
 }
 
 const BATCH_SIZE = 100;
@@ -304,8 +306,8 @@ export function insertSymbols(db: CodemapDatabase, symbols: SymbolRow[]) {
   batchInsert(
     db,
     symbols,
-    "INSERT INTO symbols (file_path, name, kind, line_start, line_end, signature, is_exported, is_default_export, members, doc_comment)",
-    "(?,?,?,?,?,?,?,?,?,?)",
+    "INSERT INTO symbols (file_path, name, kind, line_start, line_end, signature, is_exported, is_default_export, members, doc_comment, value)",
+    "(?,?,?,?,?,?,?,?,?,?,?)",
     (s, v) =>
       v.push(
         s.file_path,
@@ -318,6 +320,7 @@ export function insertSymbols(db: CodemapDatabase, symbols: SymbolRow[]) {
         s.is_default_export,
         s.members,
         s.doc_comment,
+        s.value,
       ),
   );
 }

src/parser.test.ts

@@ -265,6 +265,63 @@ describe("extractFileData", () => {
     });
   });
 
+  describe("const literal value extraction", () => {
+    it("extracts string literal", () => {
+      const src = `export const URL = "https://api.example.com";\n`;
+      const d = extractFileData("/proj/x.ts", src, "x.ts");
+      expect(d.symbols.find((s) => s.name === "URL")?.value).toBe(
+        "https://api.example.com",
+      );
+    });
+
+    it("extracts number literal", () => {
+      const src = `export const MAX = 42;\n`;
+      const d = extractFileData("/proj/x.ts", src, "x.ts");
+      expect(d.symbols.find((s) => s.name === "MAX")?.value).toBe("42");
+    });
+
+    it("extracts boolean literal", () => {
+      const src = `export const DEBUG = true;\n`;
+      const d = extractFileData("/proj/x.ts", src, "x.ts");
+      expect(d.symbols.find((s) => s.name === "DEBUG")?.value).toBe("true");
+    });
+
+    it("extracts negative number", () => {
+      const src = `export const OFFSET = -1;\n`;
+      const d = extractFileData("/proj/x.ts", src, "x.ts");
+      expect(d.symbols.find((s) => s.name === "OFFSET")?.value).toBe("-1");
+    });
+
+    it("extracts null literal", () => {
+      const src = `export const EMPTY = null;\n`;
+      const d = extractFileData("/proj/x.ts", src, "x.ts");
+      expect(d.symbols.find((s) => s.name === "EMPTY")?.value).toBe("null");
+    });
+
+    it("extracts value through as const", () => {
+      const src = `export const MODE = "production" as const;\n`;
+      const d = extractFileData("/proj/x.ts", src, "x.ts");
+      expect(d.symbols.find((s) => s.name === "MODE")?.value).toBe(
+        "production",
+      );
+    });
+
+    it("extracts simple template literal without expressions", () => {
+      const src = `export const GREETING = \`hello world\`;\n`;
+      const d = extractFileData("/proj/x.ts", src, "x.ts");
+      expect(d.symbols.find((s) => s.name === "GREETING")?.value).toBe(
+        "hello world",
+      );
+    });
+
+    it("returns null for non-literal values", () => {
+      const src = `export const arr = [1, 2];\nexport const fn = () => {};\n`;
+      const d = extractFileData("/proj/x.ts", src, "x.ts");
+      expect(d.symbols.find((s) => s.name === "arr")?.value).toBeNull();
+      expect(d.symbols.find((s) => s.name === "fn")?.value).toBeNull();
+    });
+  });
+
   describe("component detection heuristic", () => {
     it("detects components that return JSX", () => {
       const src = `export function Card() { return <div>card</div>; }\n`;

src/parser.ts

@@ -132,6 +132,7 @@ export function extractFileData(
         is_default_export: isDefault ? 1 : 0,
         members: null,
         doc_comment: findJsDoc(jsDocComments, node.start, source),
+        value: null,
       });
 
       if (isTsx && /^[A-Z]/.test(name)) {
@@ -175,6 +176,7 @@ export function extractFileData(
           is_default_export: isDefault ? 1 : 0,
           members: null,
           doc_comment: findJsDoc(jsDocComments, node.start, source),
+          value: isArrowOrFn ? null : extractLiteralValue(init),
         });
 
         if (isTsx && /^[A-Z]/.test(name) && isArrowOrFn) {
@@ -209,6 +211,7 @@ export function extractFileData(
         is_default_export: 0,
         members: null,
         doc_comment: findJsDoc(jsDocComments, node.start, source),
+        value: null,
       });
       if (node.typeAnnotation?.type === "TSTypeLiteral") {
         extractObjectMembers(
@@ -252,6 +255,7 @@ export function extractFileData(
         is_default_export: 0,
         members: null,
         doc_comment: findJsDoc(jsDocComments, node.start, source),
+        value: null,
       });
       extractObjectMembers(node.body?.body, relPath, name, typeMembers);
     },
@@ -288,6 +292,7 @@ export function extractFileData(
         is_default_export: 0,
         members,
         doc_comment: findJsDoc(jsDocComments, node.start, source),
+        value: null,
       });
     },
 
@@ -332,6 +337,7 @@ export function extractFileData(
         is_default_export: defaultExportedNames.has(name) ? 1 : 0,
         members: null,
         doc_comment: findJsDoc(jsDocComments, node.start, source),
+        value: null,
       });
     },
 
@@ -614,6 +620,34 @@ function findJsDoc(
   return doc.text || null;
 }
 
+function extractLiteralValue(init: any): string | null {
+  if (!init) return null;
+  let node = init;
+  if (node.type === "TSAsExpression" || node.type === "TSSatisfiesExpression") {
+    node = node.expression;
+  }
+  if (node.type === "Literal") {
+    return node.value === null ? "null" : String(node.value);
+  }
+  if (
+    node.type === "UnaryExpression" &&
+    node.prefix &&
+    node.operator === "-" &&
+    node.argument?.type === "Literal" &&
+    typeof node.argument.value === "number"
+  ) {
+    return String(-node.argument.value);
+  }
+  if (
+    node.type === "TemplateLiteral" &&
+    node.expressions?.length === 0 &&
+    node.quasis?.length === 1
+  ) {
+    return node.quasis[0].value?.cooked ?? null;
+  }
+  return null;
+}
+
 function extractObjectMembers(
   members: any[] | undefined,
   filePath: string,

templates/agents/skills/codemap/SKILL.md

@@ -90,6 +90,7 @@ LIMIT 10
 | is_default_export | INTEGER    | 1 if default export                                       |
 | members           | TEXT       | JSON enum members (NULL for non-enums)                    |
 | doc_comment       | TEXT       | Leading JSDoc text (cleaned), NULL when absent            |
+| value             | TEXT       | Literal value for consts (`"ok"`, `42`, `true`, `null`)   |
 
 ### `type_members` — Properties of interfaces and object-literal type aliases