cc-query 0.2.1 → 0.3.0

package/README.md

@@ -42,13 +42,25 @@ echo "SELECT count(*) FROM messages;" | cc-query .
 
 ## Skill (experimental)
 
-This [skill](https://gist.github.com/dannycoates/b4436fb77c9cfd2763028eee42d1d320) gives claude the ability and slash command `/reflect` to work with claude session history.
+This [example skill](examples/skills/reflect/SKILL.md) gives claude the ability and slash command `/reflect` to work with claude session history.
+
+Why not a plugin? If you copy the skill you can reflect on it to adapt to your own usage.
 
 For example you can ask questions like:
 - Across all projects what bash commands return the most errors?
 - Let's analyze the last session and identify how we might improve the claude.md file
 - Gimme a summary of what we worked on this past week
 - Let's go though our whole session history and identify repeated patterns that we could extract into skills
+- Let's look at our use of cc-query tool calls to see how we might improve the reflect skill
+
+### Test drive
+
+To test drive this skill do something like this:
+
+1. `npm i -g cc-query`
+2. Clone this repo or otherwise fetch the `examples/skills/reflect` dir
+3. `mkdir -p ~/.claude/skills && cp -R examples/skills/reflect ~/.claude/skills/`
+4. run claude and use `/reflect [whatever you want]`
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-query",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "SQL REPL for querying Claude Code session data",
   "type": "module",
   "exports": {

package/src/query-session.js

@@ -8,6 +8,59 @@ import { getSessionFiles } from "./session-loader.js";
  * @property {number} projectCount
  */
 
+/**
+ * Convert a result value to string for display
+ * @param {any} val
+ * @returns {string}
+ */
+function valueToString(val) {
+  if (val === null || val === undefined) return "NULL";
+  if (typeof val === "bigint") return val.toString();
+  if (typeof val === "object") {
+    // Handle DuckDB timestamp objects (returned as {micros: bigint})
+    if ("micros" in val) {
+      const ms = Number(val.micros) / 1000;
+      return new Date(ms).toISOString().replace("T", " ").replace("Z", "");
+    }
+    // Handle DuckDB UUID objects (returned as {hugeint: string})
+    if ("hugeint" in val) {
+      // Convert 128-bit signed decimal to UUID hex string
+      // DuckDB XORs the high bit for sorting, so flip it back
+      let n = BigInt(val.hugeint);
+      if (n < 0n) n += 1n << 128n; // Convert from signed to unsigned
+      n ^= 1n << 127n; // Flip high bit (undo DuckDB's sort optimization)
+      const hex = n.toString(16).padStart(32, "0");
+      return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+    }
+    return JSON.stringify(val, (_, v) =>
+      typeof v === "bigint" ? v.toString() : v,
+    );
+  }
+  return String(val);
+}
+
+/**
+ * Format query results as TSV with header row
+ * @param {import("@duckdb/node-api").DuckDBResultReader} result
+ * @returns {string}
+ */
+function formatResultsTsv(result) {
+  const columnCount = result.columnCount;
+  if (columnCount === 0) return "";
+
+  const columnNames = [];
+  for (let i = 0; i < columnCount; i++) {
+    columnNames.push(result.columnName(i));
+  }
+  const rows = result.getRows();
+
+  const lines = [columnNames.join("\t")];
+  for (const row of rows) {
+    lines.push(row.map(valueToString).join("\t"));
+  }
+  return lines.join("\n");
+}
+
 /**
  * Format query results as a table string
  * @param {import("@duckdb/node-api").DuckDBResultReader} result
@@ -29,33 +82,7 @@ function formatResults(result) {
   }
 
   // Convert all values to strings and calculate column widths
-  const stringRows = rows.map((row) =>
-    row.map((val) => {
-      if (val === null || val === undefined) return "NULL";
-      if (typeof val === "bigint") return val.toString();
-      if (typeof val === "object") {
-        // Handle DuckDB timestamp objects (returned as {micros: bigint})
-        if ("micros" in val) {
-          const ms = Number(val.micros) / 1000;
-          return new Date(ms).toISOString().replace("T", " ").replace("Z", "");
-        }
-        // Handle DuckDB UUID objects (returned as {hugeint: string})
-        if ("hugeint" in val) {
-          // Convert 128-bit signed decimal to UUID hex string
-          // DuckDB XORs the high bit for sorting, so flip it back
-          let n = BigInt(val.hugeint);
-          if (n < 0n) n += 1n << 128n; // Convert from signed to unsigned
-          n ^= 1n << 127n; // Flip high bit (undo DuckDB's sort optimization)
-          const hex = n.toString(16).padStart(32, "0");
-          return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
-        }
-        return JSON.stringify(val, (_, v) =>
-          typeof v === "bigint" ? v.toString() : v,
-        );
-      }
-      return String(val);
-    }),
-  );
+  const stringRows = rows.map((row) => row.map(valueToString));
 
   const widths = columnNames.map((name, i) => {
     const maxDataWidth = Math.max(
@@ -171,6 +198,19 @@ export class QuerySession {
     return formatResults(result);
   }
 
+  /**
+   * Execute a SQL query and return TSV formatted string with header
+   * @param {string} sql
+   * @returns {Promise<string>} Query result as TSV
+   */
+  async queryTsv(sql) {
+    if (!this.#connection) {
+      throw new Error("Session not initialized - use QuerySession.create()");
+    }
+    const result = await this.#connection.runAndReadAll(sql);
+    return formatResultsTsv(result);
+  }
+
   /**
    * Execute a SQL query and return raw rows
    * @param {string} sql

package/src/repl.js

@@ -188,6 +188,7 @@ async function readStdin() {
 
 /**
  * Run queries from piped input (non-interactive mode)
+ * Uses TSV output format with --- separator between queries
  * @param {QuerySession} qs
  * @param {string} input
  */
@@ -198,12 +199,25 @@ async function runPipedQueries(qs, input) {
     .map((s) => s.trim())
     .filter((s) => s && s !== ";");
 
+  let isFirstOutput = true;
+
   for (const stmt of statements) {
     if (stmt.startsWith(".")) {
       const shouldExit = await handleDotCommand(stmt, qs);
       if (shouldExit) break;
     } else {
-      await executeQuery(qs, stmt);
+      try {
+        const result = await qs.queryTsv(stmt);
+        if (result) {
+          if (!isFirstOutput) {
+            console.log("---");
+          }
+          console.log(result);
+          isFirstOutput = false;
+        }
+      } catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : err}`);
+      }
     }
   }
 }