@unpolarize/code-sessions 0.3.0 → 0.4.0

package/dist/{chunk-ON3CPW4C.js → chunk-3VPXOUIE.js}

@@ -141,6 +141,7 @@ Commands:
   index           (Re)build the internal SQLite index from the git store
   query           List recent sessions from the index  [--limit N] [--agent X]
   usage           Aggregated token/cost usage (totals/by-agent/by-day)  [--json]
+  graph           Sessions \xD7 topics graph (nodes + edges)  [--json]
   search          Full-text search session turns  <text> [--limit N]
   fork            Fork a session at a turn ("git for sessions")  <session-id> --at N [--id X]
   analytics       Compute MVP-2 rollups + digest into analytics/
@@ -2157,6 +2158,41 @@ var SessionIndex = class {
     ).all(like, like, limit);
     return rows.map((r) => this.rowToIndex(r));
   }
+  /** Graph of sessions clustered by topic (+ fork lineage where known). */
+  graphData() {
+    const rows = this.db.prepare("SELECT session_id, agent, topic, intent, cost_usd, title FROM session ORDER BY started_at DESC").all();
+    const nodes = [];
+    const edges = [];
+    const topicNodes = /* @__PURE__ */ new Map();
+    const topicId = (t) => {
+      let id = topicNodes.get(t);
+      if (!id) {
+        id = `topic:${topicNodes.size}`;
+        topicNodes.set(t, id);
+        nodes.push({ id, kind: "topic", label: t, sessions: 0, cost_usd: 0 });
+      }
+      return id;
+    };
+    for (const r of rows) {
+      const sid = `s:${r.session_id}`;
+      nodes.push({
+        id: sid,
+        kind: "session",
+        label: (r.topic || r.title || r.session_id).slice(0, 48),
+        agent: r.agent,
+        intent: r.intent ?? null,
+        cost_usd: r.cost_usd,
+        sessions: 1
+      });
+      const topic = (r.topic || r.intent || "misc").toString();
+      const tid = topicId(topic);
+      edges.push({ from: sid, to: tid, kind: "has-topic" });
+      const tn = nodes.find((n) => n.id === tid);
+      tn.sessions += 1;
+      tn.cost_usd += r.cost_usd;
+    }
+    return { nodes, edges };
+  }
   /** Aggregated usage for a Usage panel: totals, by agent, by day, by project, top cost. */
   usageSummary(opts = {}) {
     const rows = this.db.prepare(
@@ -2605,6 +2641,19 @@ function cmdFork(cfg, opts) {
     return { code: 1, output: `fork failed: ${e instanceof Error ? e.message : String(e)}` };
   }
 }
+function cmdGraph(cfg, opts = {}) {
+  syncIndex(cfg);
+  const index = new SessionIndex(cfg.indexPath);
+  try {
+    const g = index.graphData();
+    if (opts.json) return { code: 0, output: JSON.stringify(g) };
+    const topics = g.nodes.filter((n) => n.kind === "topic").length;
+    const sessions = g.nodes.filter((n) => n.kind === "session").length;
+    return { code: 0, output: `graph: ${sessions} sessions across ${topics} topics, ${g.edges.length} edges` };
+  } finally {
+    index.close();
+  }
+}
 function cmdUsage(cfg, opts = {}) {
   syncIndex(cfg);
   const index = new SessionIndex(cfg.indexPath);
@@ -2794,6 +2843,7 @@ export {
   cmdDoctor,
   cmdExport,
   cmdFork,
+  cmdGraph,
   cmdUsage,
   cmdInstallSkills,
   cmdIndex,

package/dist/cli.js

@@ -5,6 +5,7 @@ import {
   cmdDoctor,
   cmdExport,
   cmdFork,
+  cmdGraph,
   cmdIndex,
   cmdInit,
   cmdInstallHooks,
@@ -23,7 +24,7 @@ import {
   parseFlags,
   readStdin,
   startDaemon
-} from "./chunk-ON3CPW4C.js";
+} from "./chunk-3VPXOUIE.js";
 
 // src/analytics/command.ts
 import { mkdirSync, writeFileSync } from "fs";
@@ -260,6 +261,9 @@ async function main(argv) {
     case "usage":
       emit(cmdUsage(cfg, { json: flags.json === true }));
       break;
+    case "graph":
+      emit(cmdGraph(cfg, { json: flags.json === true }));
+      break;
     case "query":
       emit(
         cmdQuery(cfg, {

package/dist/index.js

@@ -20,6 +20,7 @@ import {
   cmdDoctor,
   cmdExport,
   cmdFork,
+  cmdGraph,
   cmdIndex,
   cmdInit,
   cmdInstallHooks,
@@ -92,7 +93,7 @@ import {
   writeBlobFile,
   writeImportedSession,
   writeTurnFile
-} from "./chunk-ON3CPW4C.js";
+} from "./chunk-3VPXOUIE.js";
 export {
   CaptureEngine,
   DEFAULT_HOOK_EVENTS,
@@ -115,6 +116,7 @@ export {
   cmdDoctor,
   cmdExport,
   cmdFork,
+  cmdGraph,
   cmdIndex,
   cmdInit,
   cmdInstallHooks,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unpolarize/code-sessions",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Headless, event-driven cross-agent session capture agent (daemon + CLI)",
   "license": "MIT",
   "type": "module",
@@ -25,7 +25,7 @@
     "build": "tsup src/index.ts src/cli.ts --format esm --clean --out-dir dist"
   },
   "dependencies": {
-    "@unpolarize/code-sessions-schema": "^0.3.0",
+    "@unpolarize/code-sessions-schema": "^0.4.0",
     "zod": "^3.23.8"
   }
 }

package/src/cli.ts

@@ -5,6 +5,7 @@ import {
   cmdDoctor,
   cmdExport,
   cmdFork,
+  cmdGraph,
   cmdIndex,
   cmdInit,
   cmdInstallHooks,
@@ -74,6 +75,9 @@ export async function main(argv: string[]): Promise<void> {
     case 'usage':
       emit(cmdUsage(cfg, { json: flags.json === true }));
       break;
+    case 'graph':
+      emit(cmdGraph(cfg, { json: flags.json === true }));
+      break;
     case 'query':
       emit(
         cmdQuery(cfg, {

package/src/cliargs.ts

@@ -59,6 +59,7 @@ Commands:
   index           (Re)build the internal SQLite index from the git store
   query           List recent sessions from the index  [--limit N] [--agent X]
   usage           Aggregated token/cost usage (totals/by-agent/by-day)  [--json]
+  graph           Sessions × topics graph (nodes + edges)  [--json]
   search          Full-text search session turns  <text> [--limit N]
   fork            Fork a session at a turn ("git for sessions")  <session-id> --at N [--id X]
   analytics       Compute MVP-2 rollups + digest into analytics/

package/src/commands.ts

@@ -234,6 +234,21 @@ export function cmdFork(
   }
 }
 
+/** Sessions × topics graph (nodes + edges) from the CS index. JSON for the graph view. */
+export function cmdGraph(cfg: CodeSessionsConfig, opts: { json?: boolean } = {}): CommandResult {
+  syncIndex(cfg);
+  const index = new SessionIndex(cfg.indexPath);
+  try {
+    const g = index.graphData();
+    if (opts.json) return { code: 0, output: JSON.stringify(g) };
+    const topics = g.nodes.filter((n) => n.kind === 'topic').length;
+    const sessions = g.nodes.filter((n) => n.kind === 'session').length;
+    return { code: 0, output: `graph: ${sessions} sessions across ${topics} topics, ${g.edges.length} edges` };
+  } finally {
+    index.close();
+  }
+}
+
 /** Aggregated usage from the CS index (totals/byAgent/byDay/byProject/topByCost). */
 export function cmdUsage(cfg: CodeSessionsConfig, opts: { json?: boolean } = {}): CommandResult {
   syncIndex(cfg); // ensure the index reflects the current store

package/src/index_store/db.test.ts

@@ -116,6 +116,25 @@ describe('SessionIndex', () => {
     }
   });
 
+  it('builds a sessions×topics graph', () => {
+    const idx = new SessionIndex(':memory:');
+    try {
+      idx.upsertSession(env('a', 'claude-code'), { ...src, topic: 'fix parser' });
+      idx.upsertSession(env('b', 'grok'), { ...src, source_path: '/s/b.json', topic: 'fix parser' });
+      idx.upsertSession(env('c', 'codex'), { ...src, source_path: '/s/c.json', topic: 'add feature' });
+      const g = idx.graphData();
+      const topics = g.nodes.filter((n) => n.kind === 'topic');
+      const sessions = g.nodes.filter((n) => n.kind === 'session');
+      expect(sessions).toHaveLength(3);
+      expect(topics).toHaveLength(2); // "fix parser" + "add feature"
+      expect(g.edges).toHaveLength(3); // each session -> its topic
+      const fixParser = topics.find((t) => t.label === 'fix parser')!;
+      expect(fixParser.sessions).toBe(2);
+    } finally {
+      idx.close();
+    }
+  });
+
   it('filters by agent and deletes sessions (cascade turns)', () => {
     const idx = new SessionIndex(':memory:');
     try {

package/src/index_store/db.ts

@@ -51,6 +51,25 @@ export interface UsageBucket {
   cost_usd: number;
 }
 
+export interface GraphNode {
+  id: string;
+  kind: 'session' | 'topic';
+  label: string;
+  agent?: string;
+  intent?: string | null;
+  cost_usd: number;
+  sessions: number;
+}
+export interface GraphEdge {
+  from: string;
+  to: string;
+  kind: 'has-topic' | 'forked-from';
+}
+export interface GraphData {
+  nodes: GraphNode[];
+  edges: GraphEdge[];
+}
+
 export interface UsageSummary {
   totals: { sessions: number; input_tokens: number; output_tokens: number; cost_usd: number };
   byAgent: Record<string, UsageBucket>;
@@ -308,6 +327,44 @@ export class SessionIndex {
     return (rows as any[]).map((r) => this.rowToIndex(r));
   }
 
+  /** Graph of sessions clustered by topic (+ fork lineage where known). */
+  graphData(): GraphData {
+    const rows = this.db
+      .prepare('SELECT session_id, agent, topic, intent, cost_usd, title FROM session ORDER BY started_at DESC')
+      .all() as any[];
+    const nodes: GraphNode[] = [];
+    const edges: GraphEdge[] = [];
+    const topicNodes = new Map<string, string>(); // topic -> node id
+    const topicId = (t: string) => {
+      let id = topicNodes.get(t);
+      if (!id) {
+        id = `topic:${topicNodes.size}`;
+        topicNodes.set(t, id);
+        nodes.push({ id, kind: 'topic', label: t, sessions: 0, cost_usd: 0 });
+      }
+      return id;
+    };
+    for (const r of rows) {
+      const sid = `s:${r.session_id}`;
+      nodes.push({
+        id: sid,
+        kind: 'session',
+        label: (r.topic || r.title || r.session_id).slice(0, 48),
+        agent: r.agent,
+        intent: r.intent ?? null,
+        cost_usd: r.cost_usd,
+        sessions: 1,
+      });
+      const topic = (r.topic || r.intent || 'misc').toString();
+      const tid = topicId(topic);
+      edges.push({ from: sid, to: tid, kind: 'has-topic' });
+      const tn = nodes.find((n) => n.id === tid)!;
+      tn.sessions += 1;
+      tn.cost_usd += r.cost_usd;
+    }
+    return { nodes, edges };
+  }
+
   /** Aggregated usage for a Usage panel: totals, by agent, by day, by project, top cost. */
   usageSummary(opts: { days?: number; topN?: number } = {}): UsageSummary {
     const rows = this.db