@unpolarize/code-sessions 0.1.0 → 0.2.0

package/dist/{chunk-ZJG2DWAK.js → chunk-HV6FQJPS.js}

@@ -133,6 +133,7 @@ Commands:
   init            Initialize the git-backed store (~/.sessions)
   start           Run the capture daemon (foreground)
   install-hooks   Install Claude Code hooks that feed the daemon
+  install-skills  Install the cs-label-session skill into agents [--agent claude|codex|grok|all]
   hook            (internal) forward a hook payload from stdin to the daemon
   backfill        Import existing transcripts into the store [--agent claude|grok|codex|all]
   reindex         (Re)derive insights for stored sessions  [--since YYYY-MM]
@@ -140,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]
   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/
   status          Show daemon/store status
   doctor          Environment checks
@@ -973,6 +975,45 @@ function deriveTags(turns) {
   for (const t of turns) for (const c of t.tool_calls) tags.add(c.name);
   return [...tags].slice(0, 12);
 }
+function projectIdFromPath(p) {
+  const segs = p.split("/").filter(Boolean);
+  const i = segs.indexOf("projects");
+  if (i >= 0 && segs[i + 1] === "ai" && segs[i + 2]) return `ai/${segs[i + 2]}`;
+  if (i >= 0 && segs[i + 1]) return segs[i + 1];
+  if (segs.includes("docs")) return "docs";
+  return null;
+}
+function deriveProjects(turns) {
+  const set = /* @__PURE__ */ new Set();
+  for (const t of turns) {
+    for (const c of t.tool_calls) {
+      const fp = c.input?.file_path ?? c.input?.path;
+      if (typeof fp === "string") {
+        const id = projectIdFromPath(fp);
+        if (id) set.add(id);
+      }
+    }
+  }
+  return [...set].sort().slice(0, 12);
+}
+var INTENT_PATTERNS = [
+  ["bugfix", /\b(fix|bug|broken|error|crash|regression|failing|stack ?trace)\b/i],
+  ["feature", /\b(add|implement|build|create|feature|support|introduce|new )\b/i],
+  ["refactor", /\b(refactor|clean ?up|simplify|rename|restructure|extract|dedupe)\b/i],
+  ["research", /\b(research|investigate|explore|compare|evaluate|find out|how (do|does|to)|why)\b/i],
+  ["docs", /\b(document|docs|readme|write[ -]?up|notes|comment)\b/i],
+  ["review", /\b(review|audit|critique|check|inspect)\b/i],
+  ["ops", /\b(deploy|release|publish|install|configure|ci\/?cd|pipeline|infra)\b/i]
+];
+function deriveIntent(turns) {
+  const firstUser = turns.find((t) => t.role === "user" && t.text.trim().length > 0);
+  if (!firstUser) return void 0;
+  const text = firstUser.text;
+  for (const [intent, re] of INTENT_PATTERNS) {
+    if (re.test(text)) return intent;
+  }
+  return "other";
+}
 
 // src/insights/provider.ts
 var FakeProvider = class {
@@ -980,10 +1021,13 @@ var FakeProvider = class {
   async label(req) {
     const result = {
       tags: deriveTags(req.turns),
+      projects: deriveProjects(req.turns),
       signals: []
     };
     const topic = guessTopic(req.turns);
     if (topic) result.topic = topic;
+    const intent = deriveIntent(req.turns);
+    if (intent) result.intent = intent;
     const assistantText = req.turns.find((t) => t.role === "assistant")?.text;
     if (assistantText) result.summary = assistantText.slice(0, 160);
     return result;
@@ -992,7 +1036,7 @@ var FakeProvider = class {
 
 // src/insights/llm.ts
 import { spawnSync as spawnSync2 } from "child_process";
-import { SIGNAL_KINDS } from "@unpolarize/code-sessions-schema";
+import { INTENTS, SIGNAL_KINDS } from "@unpolarize/code-sessions-schema";
 var MAX_HEAD = 40;
 var MAX_TAIL = 10;
 var MAX_TURN_CHARS = 400;
@@ -1006,8 +1050,8 @@ function buildPrompt(req) {
   }).join("\n");
   return [
     "You label a coding-agent session. Respond with ONLY a JSON object, no prose:",
-    '{"topic": string, "tags": string[], "summary": string, "signals": [{"kind": one of ' + SIGNAL_KINDS.join("|") + ', "severity": "info"|"warn"|"critical", "note": string}]}',
-    "topic: 3-6 words. tags: tools/themes. summary: <=1 sentence. signals: only notable ones.",
+    '{"topic": string, "intent": one of ' + INTENTS.join("|") + ', "tags": string[], "projects": string[], "summary": string, "signals": [{"kind": one of ' + SIGNAL_KINDS.join("|") + ', "severity": "info"|"warn"|"critical", "note": string}]}',
+    "topic: 3-6 words. intent: what the user wanted. tags: tools/themes. projects: repo/dir names touched. summary: <=1 sentence. signals: only notable ones.",
     "",
     "Transcript:",
     transcript
@@ -1017,19 +1061,23 @@ var KIND_SET = new Set(SIGNAL_KINDS);
 function parseLabelJson(out) {
   const start = out.indexOf("{");
   const end = out.lastIndexOf("}");
-  if (start < 0 || end <= start) return { tags: [], signals: [] };
+  if (start < 0 || end <= start) return { tags: [], projects: [], signals: [] };
   let obj;
   try {
     obj = JSON.parse(out.slice(start, end + 1));
   } catch {
-    return { tags: [], signals: [] };
+    return { tags: [], projects: [], signals: [] };
   }
   const result = {
     tags: Array.isArray(obj.tags) ? obj.tags.filter((t) => typeof t === "string") : [],
+    projects: Array.isArray(obj.projects) ? obj.projects.filter((t) => typeof t === "string") : [],
     signals: coerceSignals(obj.signals)
   };
   if (typeof obj.topic === "string") result.topic = obj.topic;
   if (typeof obj.summary === "string") result.summary = obj.summary;
+  if (typeof obj.intent === "string" && INTENTS.includes(obj.intent)) {
+    result.intent = obj.intent;
+  }
   return result;
 }
 function coerceSignals(raw) {
@@ -1130,13 +1178,15 @@ async function labelSession(sessionDir2, identity, provider, opts = {}) {
   const turns = readTurns(sessionDir2);
   if (turns.length === 0) return void 0;
   const heuristicSignals = deriveSignals(turns);
-  let provided = { tags: [], signals: [] };
+  let provided = { tags: [], projects: [], signals: [] };
   try {
     provided = await provider.label({ sessionId: identity.sessionId, host: identity.host, turns });
   } catch {
   }
   const topic = provided.topic ?? guessTopic(turns);
+  const intent = provided.intent ?? deriveIntent(turns);
   const tags = [.../* @__PURE__ */ new Set([...provided.tags, ...deriveTags(turns)])].slice(0, 16);
+  const projects = [.../* @__PURE__ */ new Set([...provided.projects, ...deriveProjects(turns)])].slice(0, 16);
   const signals = dedupeSignals([...heuristicSignals, ...provided.signals]);
   const insights = {
     schema: SCHEMA_VERSIONS2.insights,
@@ -1145,15 +1195,17 @@ async function labelSession(sessionDir2, identity, provider, opts = {}) {
     generated_at: opts.now ?? (/* @__PURE__ */ new Date()).toISOString(),
     provider: provider.name,
     tags,
+    projects,
     signals
   };
   if (topic) insights.topic = topic;
+  if (intent) insights.intent = intent;
   if (provided.summary) insights.summary = provided.summary;
   writeJsonAtomic2(insightsFile(sessionDir2), insights);
-  updateEnvelopeLabels(sessionDir2, topic, tags);
+  updateEnvelopeLabels(sessionDir2, { topic, intent, projects });
   return insights;
 }
-function updateEnvelopeLabels(sessionDir2, topic, tags) {
+function updateEnvelopeLabels(sessionDir2, l) {
   const path = envelopeFile(sessionDir2);
   if (!existsSync7(path)) return;
   let env;
@@ -1162,7 +1214,13 @@ function updateEnvelopeLabels(sessionDir2, topic, tags) {
   } catch {
     return;
   }
-  env.labels = [.../* @__PURE__ */ new Set([...topic ? [topic] : [], ...tags])].slice(0, 16);
+  env.labels = [
+    .../* @__PURE__ */ new Set([
+      ...l.intent ? [`intent:${l.intent}`] : [],
+      ...l.topic ? [l.topic] : [],
+      ...l.projects.map((p) => `project:${p}`)
+    ])
+  ].slice(0, 16);
   writeJsonAtomic2(path, env);
 }
 async function reindexStore(cfg, provider, opts = {}) {
@@ -1752,7 +1810,7 @@ import { createRequire } from "module";
 import { dirname as dirname6 } from "path";
 var nodeRequire = createRequire(import.meta.url);
 var { DatabaseSync } = nodeRequire("node:sqlite");
-var SCHEMA_VERSION = 1;
+var SCHEMA_VERSION = 2;
 function toMs(iso) {
   if (!iso) return null;
   const v = Date.parse(iso);
@@ -1768,7 +1826,8 @@ var SessionIndex = class {
   }
   migrate() {
     const row = this.db.prepare("PRAGMA user_version").get();
-    if ((row?.user_version ?? 0) < 1) {
+    const cur = row?.user_version ?? 0;
+    if (cur < 1) {
       this.db.exec(`
         CREATE TABLE IF NOT EXISTS session (
           session_id TEXT PRIMARY KEY,
@@ -1786,6 +1845,8 @@ var SessionIndex = class {
           title TEXT,
           labels_json TEXT NOT NULL DEFAULT '[]',
           topic TEXT,
+          intent TEXT,
+          projects_json TEXT NOT NULL DEFAULT '[]',
           source_path TEXT NOT NULL,
           mtime_ms INTEGER NOT NULL DEFAULT 0,
           size_bytes INTEGER NOT NULL DEFAULT 0,
@@ -1809,13 +1870,23 @@ var SessionIndex = class {
         CREATE TABLE IF NOT EXISTS insight (
           session_id TEXT PRIMARY KEY REFERENCES session(session_id) ON DELETE CASCADE,
           topic TEXT,
+          intent TEXT,
           tags_json TEXT NOT NULL DEFAULT '[]',
+          projects_json TEXT NOT NULL DEFAULT '[]',
           signals_json TEXT NOT NULL DEFAULT '[]',
           provider TEXT,
           generated_at TEXT
         );
       `);
       this.db.exec(`PRAGMA user_version = ${SCHEMA_VERSION}`);
+    } else if (cur < 2) {
+      this.db.exec(`
+        ALTER TABLE session ADD COLUMN intent TEXT;
+        ALTER TABLE session ADD COLUMN projects_json TEXT NOT NULL DEFAULT '[]';
+        ALTER TABLE insight ADD COLUMN intent TEXT;
+        ALTER TABLE insight ADD COLUMN projects_json TEXT NOT NULL DEFAULT '[]';
+        PRAGMA user_version = ${SCHEMA_VERSION};
+      `);
     }
   }
   /** session_id -> {mtime_ms, size_bytes} for incremental sync invalidation. */
@@ -1829,15 +1900,16 @@ var SessionIndex = class {
     this.db.prepare(
       `INSERT INTO session (session_id, host, agent, project_path, model, started_at, ended_at,
            turn_count, tool_call_count, input_tokens, output_tokens, cost_usd, title, labels_json,
-           topic, source_path, mtime_ms, size_bytes, indexed_at)
-         VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?)
+           topic, intent, projects_json, source_path, mtime_ms, size_bytes, indexed_at)
+         VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?)
          ON CONFLICT(session_id) DO UPDATE SET
            host=excluded.host, agent=excluded.agent, project_path=excluded.project_path,
            model=excluded.model, started_at=excluded.started_at, ended_at=excluded.ended_at,
            turn_count=excluded.turn_count, tool_call_count=excluded.tool_call_count,
            input_tokens=excluded.input_tokens, output_tokens=excluded.output_tokens,
            cost_usd=excluded.cost_usd, title=excluded.title, labels_json=excluded.labels_json,
-           topic=excluded.topic, source_path=excluded.source_path, mtime_ms=excluded.mtime_ms,
+           topic=excluded.topic, intent=excluded.intent, projects_json=excluded.projects_json,
+           source_path=excluded.source_path, mtime_ms=excluded.mtime_ms,
            size_bytes=excluded.size_bytes, indexed_at=excluded.indexed_at`
     ).run(
       env.session_id,
@@ -1855,6 +1927,8 @@ var SessionIndex = class {
       env.title ?? null,
       JSON.stringify(env.labels ?? []),
       src.topic ?? null,
+      src.intent ?? null,
+      JSON.stringify(src.projects ?? []),
       src.source_path,
       src.mtime_ms,
       src.size_bytes,
@@ -1884,12 +1958,14 @@ var SessionIndex = class {
   }
   upsertInsight(ins) {
     this.db.prepare(
-      `INSERT OR REPLACE INTO insight (session_id, topic, tags_json, signals_json, provider, generated_at)
-         VALUES (?,?,?,?,?,?)`
+      `INSERT OR REPLACE INTO insight (session_id, topic, intent, tags_json, projects_json, signals_json, provider, generated_at)
+         VALUES (?,?,?,?,?,?,?,?)`
     ).run(
       ins.session_id,
       ins.topic ?? null,
+      ins.intent ?? null,
       JSON.stringify(ins.tags ?? []),
+      JSON.stringify(ins.projects ?? []),
       JSON.stringify(ins.signals ?? []),
       ins.provider,
       ins.generated_at
@@ -1917,6 +1993,8 @@ var SessionIndex = class {
       title: r.title ?? null,
       labels: safeJson(r.labels_json),
       topic: r.topic ?? null,
+      intent: r.intent ?? null,
+      projects: safeJson(r.projects_json),
       source_path: r.source_path
     };
   }
@@ -1990,6 +2068,8 @@ function syncIndex(cfg, opts = {}) {
       if (!parsed.success) continue;
       const env = parsed.data;
       let topic;
+      let intent;
+      let projects = [];
       const insPath = insightsFile(ref.dir);
       let insights = void 0;
       if (existsSync13(insPath)) {
@@ -1997,6 +2077,8 @@ function syncIndex(cfg, opts = {}) {
         if (pi.success) {
           insights = pi.data;
           topic = pi.data.topic;
+          intent = pi.data.intent;
+          projects = pi.data.projects ?? [];
         }
       }
       index.upsertSession(env, {
@@ -2004,7 +2086,9 @@ function syncIndex(cfg, opts = {}) {
         mtime_ms,
         size_bytes,
         indexed_at: now,
-        ...topic ? { topic } : {}
+        projects,
+        ...topic ? { topic } : {},
+        ...intent ? { intent } : {}
       });
       index.replaceTurns(env.session_id, readTurns(ref.dir));
       if (insights) index.upsertInsight(insights);
@@ -2018,9 +2102,155 @@ function syncIndex(cfg, opts = {}) {
   }
 }
 
+// src/skills/templates.ts
+import { INTENTS as INTENTS2, SIGNAL_KINDS as SIGNAL_KINDS2 } from "@unpolarize/code-sessions-schema";
+function buildLabelSkillBody() {
+  return `You are labeling a coding-agent session for the code-sessions (CS) store.
+
+Read the provided session transcript and emit ONLY a single JSON object \u2014 no prose, no code fence:
+
+\`\`\`json
+{
+  "topic": "3-6 word summary of what the session was about",
+  "intent": "one of: ${INTENTS2.join(" | ")}",
+  "tags": ["short", "themes", "or", "tool", "names"],
+  "projects": ["repo-or-dir-names-touched"],
+  "signals": [
+    { "kind": "one of: ${SIGNAL_KINDS2.join(" | ")}", "severity": "info|warn|critical", "note": "why" }
+  ],
+  "summary": "one sentence"
+}
+\`\`\`
+
+Guidance:
+- **intent** = what the user wanted (a feature, a bug fixed, a refactor, research, docs, ops, a review, a chore).
+- **projects** = the projects/repos the session actually edited (from file paths it wrote to), not everything mentioned.
+- **signals** = only notable ones: stuck loops, error-recovery, unusually high cost, very long sessions, tool-heavy stretches, strong negative/positive affect.
+- Keep it terse and machine-parseable. Output the JSON and nothing else.`;
+}
+function buildClaudeSkill() {
+  return `---
+name: cs-label-session
+description: Label a coding session (topic, intent, tags, projects touched, signals) as JSON for the code-sessions store. Use when asked to classify or summarize a session.
+---
+
+${buildLabelSkillBody()}
+`;
+}
+function buildPromptFile() {
+  return `# cs-label-session
+
+${buildLabelSkillBody()}
+`;
+}
+
+// src/skills/install.ts
+import { mkdirSync as mkdirSync8, writeFileSync as writeFileSync7 } from "fs";
+import { homedir as homedir4 } from "os";
+import { dirname as dirname7, join as join8 } from "path";
+function targetsFor(agent, home) {
+  const out = [];
+  const want = (a) => agent === "all" || agent === a;
+  if (want("claude")) {
+    out.push({
+      agent: "claude",
+      path: join8(home, ".claude", "skills", "cs-label-session", "SKILL.md"),
+      content: buildClaudeSkill()
+    });
+  }
+  if (want("codex")) {
+    out.push({
+      agent: "codex",
+      path: join8(home, ".codex", "prompts", "cs-label-session.md"),
+      content: buildPromptFile()
+    });
+  }
+  if (want("grok")) {
+    out.push({
+      agent: "grok",
+      path: join8(home, ".grok", "prompts", "cs-label-session.md"),
+      content: buildPromptFile()
+    });
+  }
+  return out;
+}
+function installSkills(opts = {}) {
+  const home = opts.home ?? homedir4();
+  const installed = [];
+  for (const t of targetsFor(opts.agent ?? "all", home)) {
+    mkdirSync8(dirname7(t.path), { recursive: true });
+    writeFileSync7(t.path, t.content);
+    installed.push(t.path);
+  }
+  return { installed };
+}
+
+// src/fork.ts
+import { existsSync as existsSync14, readFileSync as readFileSync12 } from "fs";
+import { randomUUID } from "crypto";
+import { mkdirSync as mkdirSync9, renameSync as renameSync5, writeFileSync as writeFileSync8 } from "fs";
+import { dirname as dirname8 } from "path";
+import {
+  safeParseSession as safeParseSession3
+} from "@unpolarize/code-sessions-schema";
+function locateSession(storeDir, sessionId) {
+  const ref = listSessionDirs(storeDir).find((r) => r.sessionId === sessionId);
+  return ref ? { dir: ref.dir } : void 0;
+}
+function loadEnvelope2(dir) {
+  const p = envelopeFile(dir);
+  if (!existsSync14(p)) return void 0;
+  const parsed = safeParseSession3(JSON.parse(readFileSync12(p, "utf8")));
+  return parsed.success ? parsed.data : void 0;
+}
+function writeJsonAtomic4(path, value) {
+  mkdirSync9(dirname8(path), { recursive: true });
+  const tmp = `${path}.tmp`;
+  writeFileSync8(tmp, `${JSON.stringify(value, null, 2)}
+`);
+  renameSync5(tmp, path);
+}
+function forkSession(cfg, opts) {
+  const located = locateSession(cfg.storeDir, opts.sessionId);
+  if (!located) throw new Error(`session not found in store: ${opts.sessionId}`);
+  const srcEnv = loadEnvelope2(located.dir);
+  const allTurns = readTurns(located.dir);
+  const prefix = allTurns.filter((t) => t.turn_index <= opts.atTurn);
+  if (prefix.length === 0) throw new Error(`no turns at or before index ${opts.atTurn}`);
+  const newId = opts.newSessionId ?? randomUUID();
+  const agent = opts.agent ?? srcEnv?.agent ?? "claude-code";
+  const month = monthOf(srcEnv?.started_at ?? prefix[0]?.ts);
+  const dir = sessionDir(cfg.storeDir, cfg.host, month, newId);
+  const newTurns = prefix.map((t) => ({
+    ...t,
+    session_id: newId,
+    host: cfg.host,
+    agent
+  }));
+  for (const t of newTurns) writeTurnFile(dir, t);
+  const env = computeEnvelope(
+    newTurns,
+    {
+      ...srcEnv?.model ? { model: srcEnv.model } : {},
+      ...srcEnv?.project_path ? { project_path: srcEnv.project_path } : {},
+      ...srcEnv?.title ? { title: `fork: ${srcEnv.title}` } : {}
+    },
+    { session_id: newId, host: cfg.host, agent, native_uuid: newId }
+  );
+  env.forked_from = { session_id: opts.sessionId, turn_index: opts.atTurn };
+  env.native_ref.format = "fork";
+  writeJsonAtomic4(envelopeFile(dir), env);
+  return {
+    newSessionId: newId,
+    sessionDir: dir,
+    turns: newTurns.length,
+    forkedFrom: env.forked_from
+  };
+}
+
 // src/commands.ts
-import { existsSync as existsSync14, writeFileSync as writeFileSync7 } from "fs";
-import { join as join8 } from "path";
+import { existsSync as existsSync15, writeFileSync as writeFileSync9 } from "fs";
+import { join as join9 } from "path";
 function gitStoreFor(cfg) {
   return new GitStore(cfg.storeDir, {
     ...cfg.git.remote ? { remote: cfg.git.remote } : {},
@@ -2030,13 +2260,13 @@ function gitStoreFor(cfg) {
 function listClaudeTranscripts(projectsDir, maxDepth = 3) {
   const out = [];
   const walk = (dir, depth) => {
-    if (depth > maxDepth || !existsSync14(dir)) return;
+    if (depth > maxDepth || !existsSync15(dir)) return;
     for (const e of readEntries(dir)) {
       const name = String(e.name);
       if (e.isFile() && name.endsWith(".jsonl")) {
-        out.push({ sessionId: name.replace(/\.jsonl$/, ""), path: join8(dir, name) });
+        out.push({ sessionId: name.replace(/\.jsonl$/, ""), path: join9(dir, name) });
       } else if (e.isDirectory()) {
-        walk(join8(dir, name), depth + 1);
+        walk(join9(dir, name), depth + 1);
       }
     }
   };
@@ -2046,9 +2276,9 @@ function listClaudeTranscripts(projectsDir, maxDepth = 3) {
 function cmdInit(cfg) {
   const git = gitStoreFor(cfg);
   git.init();
-  const configPath = join8(cfg.storeDir, "config.json");
-  if (!existsSync14(configPath)) {
-    writeFileSync7(
+  const configPath = join9(cfg.storeDir, "config.json");
+  if (!existsSync15(configPath)) {
+    writeFileSync9(
       configPath,
       `${JSON.stringify({ insights: cfg.insights, batch: cfg.batch, hygiene: cfg.hygiene }, null, 2)}
 `
@@ -2061,7 +2291,7 @@ function cmdStatus(cfg) {
   const state = new StateStore(cfg.statePath);
   const sessions = Object.keys(state.all());
   const stored = listSessionDirs(cfg.storeDir);
-  const socketUp = existsSync14(cfg.socketPath);
+  const socketUp = existsSync15(cfg.socketPath);
   const lines = [
     `store:      ${cfg.storeDir}`,
     `host:       ${cfg.host}`,
@@ -2130,7 +2360,7 @@ async function cmdReindex(cfg, opts = {}) {
 }
 function cmdInstallHooks(cfg, opts = {}) {
   const home = cfg.claudeProjectsDir.replace(/\/projects\/?$/, "");
-  const settingsPath = opts.settingsPath ?? join8(home, "settings.json");
+  const settingsPath = opts.settingsPath ?? join9(home, "settings.json");
   const command = opts.command ?? "code-sessions hook";
   const res = installHooks(settingsPath, command);
   return {
@@ -2140,10 +2370,10 @@ function cmdInstallHooks(cfg, opts = {}) {
 }
 function cmdDoctor(cfg) {
   const checks = [
-    ["store dir exists", existsSync14(cfg.storeDir)],
-    ["store is git repo", existsSync14(join8(cfg.storeDir, ".git"))],
-    ["daemon socket present", existsSync14(cfg.socketPath)],
-    ["claude projects dir", existsSync14(cfg.claudeProjectsDir)]
+    ["store dir exists", existsSync15(cfg.storeDir)],
+    ["store is git repo", existsSync15(join9(cfg.storeDir, ".git"))],
+    ["daemon socket present", existsSync15(cfg.socketPath)],
+    ["claude projects dir", existsSync15(cfg.claudeProjectsDir)]
   ];
   const lines = checks.map(([name, ok]) => `${ok ? "\u2713" : "\u2717"} ${name}`);
   const code = checks.every(([, ok]) => ok) ? 0 : 1;
@@ -2159,6 +2389,31 @@ async function cmdExport(cfg, opts = {}) {
     output: `Exported ${res.exported}/${res.total} session(s) to ${cfg.telemetry.endpoint} (${res.failed} failed)`
   };
 }
+function cmdFork(cfg, opts) {
+  if (!opts.sessionId || Number.isNaN(opts.atTurn)) {
+    return { code: 1, output: "usage: code-sessions fork <session-id> --at <turn> [--id <new-id>]" };
+  }
+  try {
+    const res = forkSession(cfg, {
+      sessionId: opts.sessionId,
+      atTurn: opts.atTurn,
+      ...opts.newId ? { newSessionId: opts.newId } : {}
+    });
+    const git = gitStoreFor(cfg);
+    if (git.isRepo()) git.commit(`fork ${opts.sessionId}@${opts.atTurn} -> ${res.newSessionId}`);
+    return {
+      code: 0,
+      output: `Forked ${opts.sessionId} at turn ${opts.atTurn} \u2192 ${res.newSessionId} (${res.turns} turns) at ${res.sessionDir}`
+    };
+  } catch (e) {
+    return { code: 1, output: `fork failed: ${e instanceof Error ? e.message : String(e)}` };
+  }
+}
+function cmdInstallSkills(opts = {}) {
+  const res = installSkills(opts.agent ? { agent: opts.agent } : {});
+  return { code: 0, output: `Installed cs-label-session skill:
+  ${res.installed.join("\n  ")}` };
+}
 function cmdIndex(cfg) {
   const stats = syncIndex(cfg);
   return {
@@ -2171,8 +2426,9 @@ function fmtRow(r) {
   const agent = (r.agent || "?").padEnd(11).slice(0, 11);
   const tok = String(r.input_tokens + r.output_tokens).padStart(8);
   const cost = `$${r.cost_usd.toFixed(2)}`.padStart(8);
-  const title = (r.topic || r.title || r.session_id).slice(0, 48);
-  return `${date}  ${agent}  ${tok}  ${cost}  ${title}`;
+  const intent = (r.intent || "\xB7").padEnd(8).slice(0, 8);
+  const title = (r.topic || r.title || r.session_id).slice(0, 44);
+  return `${date}  ${agent}  ${intent}  ${tok}  ${cost}  ${title}`;
 }
 function cmdQuery(cfg, opts = {}) {
   const index = new SessionIndex(cfg.indexPath);
@@ -2218,9 +2474,9 @@ async function startDaemon(cfg) {
 }
 
 // src/hooks/shim.ts
-import { existsSync as existsSync15 } from "fs";
+import { existsSync as existsSync16 } from "fs";
 async function handleHookInput(socketPath, rawInput) {
-  if (!existsSync15(socketPath)) return { ok: false, error: "daemon not running" };
+  if (!existsSync16(socketPath)) return { ok: false, error: "daemon not running" };
   let parsed;
   try {
     parsed = JSON.parse(rawInput);
@@ -2276,6 +2532,9 @@ export {
   deriveSignals,
   guessTopic,
   deriveTags,
+  projectIdFromPath,
+  deriveProjects,
+  deriveIntent,
   FakeProvider,
   buildPrompt,
   parseLabelJson,
@@ -2304,6 +2563,11 @@ export {
   writeImportedSession,
   SessionIndex,
   syncIndex,
+  buildLabelSkillBody,
+  buildClaudeSkill,
+  buildPromptFile,
+  installSkills,
+  forkSession,
   listClaudeTranscripts,
   cmdInit,
   cmdStatus,
@@ -2312,6 +2576,8 @@ export {
   cmdInstallHooks,
   cmdDoctor,
   cmdExport,
+  cmdFork,
+  cmdInstallSkills,
   cmdIndex,
   cmdQuery,
   cmdSearch,

package/dist/cli.js

@@ -4,9 +4,11 @@ import {
   cmdBackfill,
   cmdDoctor,
   cmdExport,
+  cmdFork,
   cmdIndex,
   cmdInit,
   cmdInstallHooks,
+  cmdInstallSkills,
   cmdQuery,
   cmdReindex,
   cmdSearch,
@@ -20,7 +22,7 @@ import {
   parseFlags,
   readStdin,
   startDaemon
-} from "./chunk-ZJG2DWAK.js";
+} from "./chunk-HV6FQJPS.js";
 
 // src/analytics/command.ts
 import { mkdirSync, writeFileSync } from "fs";
@@ -231,6 +233,9 @@ async function main(argv) {
         })
       );
       break;
+    case "install-skills":
+      emit(cmdInstallSkills(typeof flags.agent === "string" ? { agent: flags.agent } : {}));
+      break;
     case "backfill":
       emit(
         await cmdBackfill(cfg, {
@@ -264,6 +269,17 @@ async function main(argv) {
       emit(cmdSearch(cfg, { query: q, ...typeof flags.limit === "string" ? { limit: Number(flags.limit) } : {} }));
       break;
     }
+    case "fork": {
+      const sid = argv.slice(1).find((a) => !a.startsWith("--")) ?? "";
+      emit(
+        cmdFork(cfg, {
+          sessionId: sid,
+          atTurn: typeof flags.at === "string" ? Number(flags.at) : NaN,
+          ...typeof flags.id === "string" ? { newId: flags.id } : {}
+        })
+      );
+      break;
+    }
     case "hook": {
       try {
         const input = await readStdin();