claude-term-tabs 0.0.0-bootstrap

package/dist/transcript.js

@@ -0,0 +1,127 @@
+import { closeSync, fstatSync, openSync, readSync } from 'node:fs';
+import { repoName } from "./paths.js";
+const HEAD_BYTES = 64 * 1024;
+const DEFAULT_TAIL_BYTES = 256 * 1024;
+const PROMPT_CHARS = 200;
+const WRAPPER_PREFIXES = ['<command', '<local-command', '<system', '<user-prompt-submit-hook', 'Caveat:'];
+/**
+ * Build a Digest from a transcript by reading its head (first prompt, cwd) and a tail window
+ * (latest title, last prompt, branch). A missing or unreadable file yields the fallback fields
+ * plus a `note`; it never throws.
+ */
+export function extractDigest(path, fallback, opts = {}) {
+    let fd;
+    try {
+        fd = openSync(path, 'r');
+    }
+    catch (err) {
+        return fallbackDigest(fallback, `transcript unreadable: ${err.message}`);
+    }
+    try {
+        const { size, mtimeMs } = fstatSync(fd);
+        const headEntries = parseLines(readRange(fd, 0, Math.min(size, HEAD_BYTES)), false);
+        const tail = readTail(fd, size, opts.tailBytes ?? DEFAULT_TAIL_BYTES);
+        const cwd = tail.cwd ?? firstString(headEntries, 'cwd') ?? fallback.cwd ?? '';
+        return {
+            sessionId: fallback.sessionId,
+            cwd,
+            ...repoName(cwd),
+            title: tail.customTitle ?? tail.aiTitle ?? tail.summary,
+            firstPrompt: firstRealPrompt(headEntries),
+            lastPrompt: trimPrompt(tail.lastPrompt),
+            branch: tail.branch ?? firstString(headEntries, 'gitBranch'),
+            lastActive: Math.round(mtimeMs)
+        };
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+function fallbackDigest(fallback, note) {
+    const cwd = fallback.cwd ?? '';
+    return { sessionId: fallback.sessionId, cwd, ...repoName(cwd), lastActive: 0, note };
+}
+function readRange(fd, start, length) {
+    const buf = Buffer.alloc(length);
+    const read = readSync(fd, buf, 0, length, start);
+    return buf.subarray(0, read).toString('utf8');
+}
+function readTail(fd, size, initial) {
+    let window = Math.max(1, initial);
+    for (;;) {
+        const start = Math.max(0, size - window);
+        const entries = parseLines(readRange(fd, start, size - start), start > 0);
+        const fields = collectTail(entries);
+        const titled = fields.customTitle ?? fields.aiTitle ?? fields.summary;
+        if (titled !== undefined || start === 0)
+            return fields;
+        window *= 2;
+    }
+}
+function parseLines(text, dropFirst) {
+    const lines = text.split('\n');
+    const usable = dropFirst ? lines.slice(1) : lines;
+    return usable.flatMap(line => {
+        if (line.trim() === '')
+            return [];
+        try {
+            const parsed = JSON.parse(line);
+            return isEntry(parsed) ? [parsed] : [];
+        }
+        catch {
+            return [];
+        }
+    });
+}
+function isEntry(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+function collectTail(entries) {
+    return entries.reduce((acc, e) => ({
+        customTitle: e.type === 'custom-title' ? str(e.customTitle) ?? acc.customTitle : acc.customTitle,
+        aiTitle: e.type === 'ai-title' ? str(e.aiTitle) ?? acc.aiTitle : acc.aiTitle,
+        summary: e.type === 'summary' ? str(e.summary) ?? acc.summary : acc.summary,
+        lastPrompt: e.type === 'last-prompt' ? str(e.lastPrompt) ?? acc.lastPrompt : acc.lastPrompt,
+        branch: str(e.gitBranch) ?? acc.branch,
+        cwd: str(e.cwd) ?? acc.cwd
+    }), {});
+}
+function firstString(entries, key) {
+    for (const e of entries) {
+        const v = str(e[key]);
+        if (v !== undefined)
+            return v;
+    }
+    return undefined;
+}
+function firstRealPrompt(entries) {
+    for (const e of entries) {
+        if (e.type !== 'user' || e.isMeta === true)
+            continue;
+        const text = userText(e.message);
+        if (text !== undefined && !WRAPPER_PREFIXES.some(p => text.trimStart().startsWith(p))) {
+            return trimPrompt(text);
+        }
+    }
+    return undefined;
+}
+function userText(message) {
+    if (!isEntry(message))
+        return undefined;
+    const content = message.content;
+    if (typeof content === 'string')
+        return content;
+    if (!Array.isArray(content))
+        return undefined;
+    const texts = content.filter(isEntry).filter(b => b.type === 'text').map(b => str(b.text) ?? '');
+    const joined = texts.join(' ').trim();
+    return joined === '' ? undefined : joined;
+}
+function trimPrompt(text) {
+    if (text === undefined)
+        return undefined;
+    return text.replace(/\s+/g, ' ').trim().slice(0, PROMPT_CHARS);
+}
+function str(v) {
+    return typeof v === 'string' && v !== '' ? v : undefined;
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "claude-term-tabs",
+  "version": "0.0.0-bootstrap",
+  "description": "Find a running Claude Code session by what you remember, and jump to its terminal tab",
+  "type": "module",
+  "license": "MIT",
+  "author": "Emma Coutu",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ecoutu/claude-term-tabs.git"
+  },
+  "homepage": "https://github.com/ecoutu/claude-term-tabs#readme",
+  "bugs": {
+    "url": "https://github.com/ecoutu/claude-term-tabs/issues"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "iterm2",
+    "wezterm",
+    "terminal",
+    "tabs",
+    "cli"
+  ],
+  "bin": {
+    "claude-term-tabs": "bin/claude-term-tabs",
+    "ctt": "bin/claude-term-tabs"
+  },
+  "files": [
+    "bin",
+    "dist"
+  ],
+  "engines": {
+    "node": ">=24"
+  },
+  "scripts": {
+    "test": "CTT_NO_REAL_EXEC=1 node --test 'tests/**/*.test.ts'",
+    "check": "tsc",
+    "prepare": "husky",
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "prepack": "npm run build"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "21.2.4",
+    "@commitlint/config-conventional": "21.2.4",
+    "@semantic-release/changelog": "7.0.0",
+    "@semantic-release/git": "11.0.1",
+    "@types/node": "24.19.2",
+    "husky": "9.1.7",
+    "semantic-release": "25.0.9",
+    "typescript": "5.9.3"
+  }
+}