@unpolarize/code-sessions 0.3.0 → 0.5.0

package/dist/{chunk-ON3CPW4C.js → chunk-Y7DRROK7.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/
@@ -633,17 +634,32 @@ var GitStore = class {
   isRepo() {
     return existsSync5(join3(this.dir, ".git"));
   }
-  /** Initialize the store repo (idempotent): git init, scaffolding files, remote. */
+  /** Initialize the store repo (idempotent): git init, connect remote (adopting
+   * its existing history on a fresh clone so a second machine continues the same
+   * store instead of forking), then write scaffolding files if still absent. */
   init() {
     if (!this.isRepo()) {
       const r = spawnSync("git", ["init", "-b", "main", this.dir], { encoding: "utf8" });
       if (r.status !== 0) throw new Error(`git init failed: ${r.stderr}`);
     }
+    if (this.opts.remote) {
+      this.ensureRemote(this.opts.remote);
+      this.adoptRemoteIfEmpty();
+    }
     const giPath = join3(this.dir, ".gitignore");
     if (!existsSync5(giPath)) writeFileSync3(giPath, GITIGNORE);
     const gaPath = join3(this.dir, ".gitattributes");
     if (!existsSync5(gaPath)) writeFileSync3(gaPath, GITATTRIBUTES);
-    if (this.opts.remote) this.ensureRemote(this.opts.remote);
+  }
+  /** When this clone has no commits yet, pull the remote's existing store so we
+   * continue its history (multi-machine) rather than starting a divergent one.
+   * No-op for an empty/unreachable remote. */
+  adoptRemoteIfEmpty() {
+    if (this.run(["rev-parse", "--verify", "HEAD"]).ok) return;
+    if (!this.run(["fetch", "origin"]).ok) return;
+    if (!this.run(["rev-parse", "--verify", "origin/main"]).ok) return;
+    this.run(["reset", "--hard", "origin/main"]);
+    this.run(["branch", "--set-upstream-to=origin/main", "main"]);
   }
   ensureRemote(remote) {
     const existing = this.run(["remote", "get-url", "origin"]);
@@ -2157,6 +2173,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(
@@ -2462,7 +2513,17 @@ function cmdInit(cfg) {
   if (!existsSync16(configPath)) {
     writeFileSync9(
       configPath,
-      `${JSON.stringify({ insights: cfg.insights, batch: cfg.batch, hygiene: cfg.hygiene }, null, 2)}
+      `${JSON.stringify(
+        {
+          insights: cfg.insights,
+          batch: cfg.batch,
+          hygiene: cfg.hygiene,
+          // persist the remote so the daemon/CLI keep pushing here without flags
+          git: { ...cfg.git.remote ? { remote: cfg.git.remote } : {}, autoPush: cfg.git.autoPush }
+        },
+        null,
+        2
+      )}
 `
     );
   }
@@ -2605,6 +2666,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 +2868,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-Y7DRROK7.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-Y7DRROK7.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.5.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.5.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

@@ -59,7 +59,17 @@ export function cmdInit(cfg: CodeSessionsConfig): CommandResult {
   if (!existsSync(configPath)) {
     writeFileSync(
       configPath,
-      `${JSON.stringify({ insights: cfg.insights, batch: cfg.batch, hygiene: cfg.hygiene }, null, 2)}\n`,
+      `${JSON.stringify(
+        {
+          insights: cfg.insights,
+          batch: cfg.batch,
+          hygiene: cfg.hygiene,
+          // persist the remote so the daemon/CLI keep pushing here without flags
+          git: { ...(cfg.git.remote ? { remote: cfg.git.remote } : {}), autoPush: cfg.git.autoPush },
+        },
+        null,
+        2,
+      )}\n`,
     );
   }
   git.commit('init store');
@@ -234,6 +244,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

package/src/store/git.ts

@@ -58,17 +58,35 @@ export class GitStore {
     return existsSync(join(this.dir, '.git'));
   }
 
-  /** Initialize the store repo (idempotent): git init, scaffolding files, remote. */
+  /** Initialize the store repo (idempotent): git init, connect remote (adopting
+   * its existing history on a fresh clone so a second machine continues the same
+   * store instead of forking), then write scaffolding files if still absent. */
   init(): void {
     if (!this.isRepo()) {
       const r = spawnSync('git', ['init', '-b', 'main', this.dir], { encoding: 'utf8' });
       if (r.status !== 0) throw new Error(`git init failed: ${r.stderr}`);
     }
+    // Connect + adopt remote BEFORE writing scaffolding, so an adopted checkout
+    // doesn't collide with untracked .gitignore/.gitattributes we'd write.
+    if (this.opts.remote) {
+      this.ensureRemote(this.opts.remote);
+      this.adoptRemoteIfEmpty();
+    }
     const giPath = join(this.dir, '.gitignore');
     if (!existsSync(giPath)) writeFileSync(giPath, GITIGNORE);
     const gaPath = join(this.dir, '.gitattributes');
     if (!existsSync(gaPath)) writeFileSync(gaPath, GITATTRIBUTES);
-    if (this.opts.remote) this.ensureRemote(this.opts.remote);
+  }
+
+  /** When this clone has no commits yet, pull the remote's existing store so we
+   * continue its history (multi-machine) rather than starting a divergent one.
+   * No-op for an empty/unreachable remote. */
+  private adoptRemoteIfEmpty(): void {
+    if (this.run(['rev-parse', '--verify', 'HEAD']).ok) return; // already has local history
+    if (!this.run(['fetch', 'origin']).ok) return; // empty or unreachable remote
+    if (!this.run(['rev-parse', '--verify', 'origin/main']).ok) return; // remote has no main
+    this.run(['reset', '--hard', 'origin/main']);
+    this.run(['branch', '--set-upstream-to=origin/main', 'main']);
   }
 
   ensureRemote(remote: string): void {