ccompactor 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ccompactor contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -0,0 +1,37 @@
+# NOTICE
+
+## No Anthropic-derived code
+
+CCompactor contains **no code derived from Anthropic's Claude Code CLI**, and no code from any fork
+of it.
+
+An earlier iteration vendored two modules (`prompt.ts`, `grouping.ts`) from
+[openclaude](https://github.com/Gitlawb/openclaude) to reach behavioural parity while the engine was
+being written. Those files were never imported by anything: `src/compact/engine.ts` has always
+delegated to `summariseWithContract`, which is written against the published nine-section contract
+with ccompactor's own wording. The vendored directory has been deleted, and with it the only obstacle
+to publishing.
+
+The nine-section contract — Primary Request and Intent, Key Technical Concepts, Files and Code
+Sections, Errors and fixes, Problem Solving, All user messages, Pending Tasks, Current Work, Optional
+Next Step — is the published behaviour of Claude Code's `/compact`, described in `docs/SPEC.md`.
+Section structure is an idea, not protectable expression; implementing it from its description is
+ordinary engineering.
+
+`packages/ccompactor/scripts/guard-vendor.mjs` remains and runs on `prepack`, so the mistake cannot
+be reintroduced silently.
+
+## What ccompactor owes to sctxx
+
+The product framing — cross-agent handoff, provenance on every claim, a verify step, layered
+artifacts — follows [sctxx](https://github.com/handyutils/sctxx) by the same author. None of its code
+is used; sctxx is Rust, ccompactor is TypeScript, and the two agree on behaviour rather than
+implementation. The handoff benchmark is a port, so the two tools' numbers are comparable, and they
+are compared in the open — including where ccompactor is behind.
+
+## What ccompactor owes to published research
+
+The compaction-side design follows the survey sctxx's `docs/research/` records: observation masking
+as the cheapest strategy with an ablation (arXiv:2508.21433), addressable recall as what makes
+dropping safe (arXiv:2607.25066), and the finding that no published result measures a handoff to a
+different agent (arXiv:2606.02875).

package/README.md

@@ -0,0 +1,101 @@
+# ccompactor
+
+**Extract any coding-agent session into a compact, verified, provenance-linked handoff that any other
+agent can continue from.**
+
+Claude Code, Codex CLI and Pi keep their transcripts on disk. `ccompactor` reads one, builds
+deterministic ledgers of what actually happened, and writes an artifact you can hand to a *different*
+agent so it starts where the last one stopped instead of re-deriving ten days of work.
+
+```sh
+npm i -g ccompactor
+ccompactor list --any-project
+ccompactor extract claude:last --out .ccompactor
+```
+
+Then point any agent at `.ccompactor/handoff.md`:
+
+```sh
+ccompactor handoff claude:last --to codex --run
+```
+
+## What it does
+
+| command | what it does |
+| --- | --- |
+| `ccompactor doctor` | which agent stores are on this machine |
+| `ccompactor list` | sessions, newest first |
+| `ccompactor find <query>` | fuzzy search over id, project, and the first thing the human asked for |
+| `ccompactor extract <ref>` | the handoff artifact |
+| `ccompactor expand <ref> a..b` | the events behind an `[evt a–b]` pointer, in exact pages |
+| `ccompactor verify <dir>` | re-check an artifact: are the quotes still in the transcript, do the files still exist |
+| `ccompactor handoff <ref> --to <agent>` | launch Claude, Codex or Pi with the context preloaded |
+| `ccompactor skill install` | the Agent Skill, so agents know to use it |
+| `ccompactor --tui` | an interactive browser — filter, search, extract, handoff |
+| `ccompactor bench <refs...>` | measure whether a handoff actually hands anything off |
+
+Session references are `claude:7c1e8f82`, `codex:last`, `pi:<id>`, or a path to a transcript.
+
+## Deterministic first
+
+`--llm none` produces a complete artifact with **no model and no network**. On a real 103,757-event
+session that is **4,050 tokens in 2 seconds**.
+
+The artifact has four layers, cheapest first, so a reader can stop as soon as it knows enough:
+
+- **L0 Brief** — the goal, the hard constraints quoted verbatim, where the work was, what it
+  committed, the last commands, what to verify first.
+- **L1 Continuation summary** — model-written, or an explicit notice that none ran.
+- **L2 Ledgers** — files touched with edit counts, commands with outcomes, error signatures ranked by
+  repetition, a tool census. All deterministic.
+- **L3 Retrieval** — an index of every episode the artifact did not carry, with event ranges, so
+  anything dropped is still reachable.
+
+Every claim carries a pointer, and the pointer works:
+
+```sh
+ccompactor expand claude:7c1e8f82 4122..4381 --context 3
+```
+
+## The model is optional
+
+```sh
+ccompactor extract claude:last --llm none              # nothing leaves the machine
+ccompactor extract claude:last --llm api:anthropic     # ANTHROPIC_API_KEY
+ccompactor extract claude:last --llm api:openai        # OPENAI_API_KEY
+ccompactor extract claude:last --llm api:compat/<model>  # CCOMPACTOR_BASE_URL + CCOMPACTOR_API_KEY
+```
+
+Secrets are redacted before any model call and again in the rendered artifact. Transcript content is
+treated as data, never as instructions.
+
+## Benchmarked, including where it loses
+
+`ccompactor` ships a handoff benchmark with four arms — `none`, `tail`, `artifact`, and
+`retrieval` (the successor can ask for an event range and be given the real events).
+
+Measured head to head against its Rust sister project [sctxx](https://github.com/handyutils/sctxx) on
+the same session, same questions, same backend, three runs each:
+
+| arm | ccompactor | sctxx |
+| --- | --- | --- |
+| none | 0% | 0% |
+| tail | 0–5% | 9% |
+| artifact | 25% | 23% |
+| **retrieval** | **~38%** | **~73%** |
+
+**ccompactor is behind, and the site says so.** The gap is real — the ranges do not overlap across
+repeated runs — and the cause is not yet identified.
+
+## Install without Node
+
+Standalone binaries for macOS (arm64, x64), Linux (x64, arm64, plus `.deb`) and Windows (x64, arm64)
+are attached to each [GitHub release](https://github.com/ccompactor/ccompactor/releases).
+
+## Requirements
+
+Node ≥ 20 for the npm install. The standalone binaries need nothing.
+
+## Licence
+
+MIT. Contains no code derived from Anthropic's Claude Code CLI — see [NOTICE](NOTICE).

package/dist/adapters/claude.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Claude Code session adapter.
+ *
+ * The store is `~/.claude/projects/<slugified-cwd>/<session-uuid>.jsonl`, one
+ * JSON object per line. Two properties of that format decide this adapter's
+ * shape:
+ *
+ * 1. **It is a tree, not a log.** Every record carries `uuid` and `parentUuid`.
+ *    When a session is rewound or a message is edited, the file keeps the
+ *    abandoned branch. Replaying the file in line order would hand a successor
+ *    work the human explicitly walked away from, so the active branch is
+ *    resolved by walking parent pointers back from the newest record.
+ *
+ * 2. **The provider compacts its own context.** A `summary` record, or a user
+ *    turn that is the provider's continuation preamble, marks a boundary.
+ *    Everything before it was already summarised once; re-summarising a summary
+ *    is how meaning is lost, so the boundary is recorded and honoured downstream.
+ */
+import type { AgentKind, SessionIR, SessionRef } from '../ir/types.js';
+import type { Adapter, ListOptions, ReadOptions } from './types.js';
+export declare function claudeStore(): string;
+/**
+ * Claude Code encodes the project directory into the store path by replacing
+ * every non-alphanumeric character with `-`. It is not reversible — two
+ * different paths can produce the same slug — which is why the cwd recorded
+ * inside the transcript is preferred wherever it exists.
+ */
+export declare function slugifyProject(path: string): string;
+export declare class ClaudeAdapter implements Adapter {
+    kind: AgentKind;
+    label: string;
+    store(): string;
+    available(): boolean;
+    list(options: ListOptions): Promise<SessionRef[]>;
+    read(ref: SessionRef, options?: ReadOptions): Promise<SessionIR>;
+}

package/dist/adapters/claude.js

@@ -0,0 +1,361 @@
+/**
+ * Claude Code session adapter.
+ *
+ * The store is `~/.claude/projects/<slugified-cwd>/<session-uuid>.jsonl`, one
+ * JSON object per line. Two properties of that format decide this adapter's
+ * shape:
+ *
+ * 1. **It is a tree, not a log.** Every record carries `uuid` and `parentUuid`.
+ *    When a session is rewound or a message is edited, the file keeps the
+ *    abandoned branch. Replaying the file in line order would hand a successor
+ *    work the human explicitly walked away from, so the active branch is
+ *    resolved by walking parent pointers back from the newest record.
+ *
+ * 2. **The provider compacts its own context.** A `summary` record, or a user
+ *    turn that is the provider's continuation preamble, marks a boundary.
+ *    Everything before it was already summarised once; re-summarising a summary
+ *    is how meaning is lost, so the boundary is recorded and honoured downstream.
+ */
+import { existsSync } from 'node:fs';
+import { readdir, stat } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { basename, join, resolve } from 'node:path';
+import { readLines } from './types.js';
+export function claudeStore() {
+    return process.env['CLAUDE_ROOT'] ?? join(homedir(), '.claude', 'projects');
+}
+/**
+ * Claude Code encodes the project directory into the store path by replacing
+ * every non-alphanumeric character with `-`. It is not reversible — two
+ * different paths can produce the same slug — which is why the cwd recorded
+ * inside the transcript is preferred wherever it exists.
+ */
+export function slugifyProject(path) {
+    return path.replace(/[^a-zA-Z0-9]/g, '-');
+}
+export class ClaudeAdapter {
+    kind = 'claude';
+    label = 'Claude Code';
+    store() {
+        return claudeStore();
+    }
+    available() {
+        return existsSync(this.store());
+    }
+    async list(options) {
+        const root = this.store();
+        const wanted = options.project ? slugifyProject(resolve(options.project)) : undefined;
+        const dirs = options.project && !options.anyProject ? [wanted] : await safeReaddir(root);
+        const refs = [];
+        for (const dir of dirs) {
+            const dirPath = join(root, dir);
+            for (const entry of await safeReaddir(dirPath)) {
+                if (!entry.endsWith('.jsonl'))
+                    continue;
+                const path = join(dirPath, entry);
+                const info = await stat(path).catch(() => null);
+                if (!info || !info.isFile())
+                    continue;
+                if (options.maxBytes !== undefined && info.size > options.maxBytes)
+                    continue;
+                refs.push({
+                    agent: 'claude',
+                    id: basename(entry, '.jsonl'),
+                    path,
+                    projectPath: join(root, dir),
+                    mtime: info.mtimeMs,
+                    bytes: info.size,
+                });
+            }
+        }
+        return refs.sort((a, b) => b.mtime - a.mtime);
+    }
+    async read(ref, options = {}) {
+        const lines = await readLines(ref.path);
+        const diagnostics = [];
+        const records = [];
+        for (const [index, line] of lines.entries()) {
+            try {
+                records.push({ index, raw: JSON.parse(line) });
+            }
+            catch (error) {
+                // One bad line is a diagnostic, never a failed session. A truncated
+                // final line is common when a session is read while it is being written.
+                diagnostics.push({
+                    line: index + 1,
+                    message: `unparseable: ${error.message}`,
+                });
+            }
+        }
+        const byUuid = new Map();
+        for (const record of records) {
+            if (record.raw.uuid)
+                byUuid.set(record.raw.uuid, record);
+        }
+        const onBranch = resolveActiveBranch(records, byUuid, diagnostics);
+        const compactBoundaries = [];
+        const messages = [];
+        const metadata = {};
+        for (const { index, raw } of onBranch) {
+            if (raw.cwd && metadata['cwd'] === undefined)
+                metadata['cwd'] = raw.cwd;
+            if (raw.gitBranch && metadata['branch'] === undefined)
+                metadata['branch'] = raw.gitBranch;
+            if (raw.version && metadata['version'] === undefined)
+                metadata['version'] = raw.version;
+            if (raw.message?.model && metadata['model'] === undefined)
+                metadata['model'] = raw.message.model;
+            if (raw.isSidechain && !options.includeSidechains)
+                continue;
+            if (raw.type === 'summary') {
+                compactBoundaries.push(index);
+                messages.push({
+                    uuid: raw.uuid ?? `evt-${index}`,
+                    role: 'attachment',
+                    text: raw.summary ?? '',
+                    eventIndex: index,
+                    raw,
+                });
+                continue;
+            }
+            const message = toMessage(raw, index);
+            if (!message)
+                continue;
+            messages.push(message);
+            if (isCompactionPreamble(message))
+                compactBoundaries.push(index);
+        }
+        if (typeof metadata['cwd'] !== 'string') {
+            // Fall back to the slug only when the transcript recorded no cwd, and say
+            // so: the slug is lossy.
+            metadata['cwdGuessedFromSlug'] = ref.projectPath ? basename(ref.projectPath) : undefined;
+        }
+        metadata['keptPreBoundary'] = compactBoundaries.length > 0 && options.sinceCompact !== true;
+        return {
+            ref,
+            messages,
+            compactBoundaries,
+            metadata,
+            diagnostics,
+        };
+    }
+}
+function isCompactionPreamble(message) {
+    if (message.role !== 'user' || !message.text)
+        return false;
+    return message.text.includes('This session is being continued from a previous conversation');
+}
+function toMessage(raw, index) {
+    const uuid = raw.uuid ?? `evt-${index}`;
+    const base = {
+        uuid,
+        ...(raw.parentUuid ? { parentUuid: raw.parentUuid } : {}),
+        ...(raw.timestamp ? { timestamp: raw.timestamp } : {}),
+        eventIndex: index,
+        raw,
+    };
+    if (raw.type === 'assistant') {
+        const content = raw.message?.content;
+        const text = textOf(content);
+        const tool = firstToolUse(content);
+        if (tool) {
+            return {
+                ...base,
+                role: 'assistant',
+                text: text || undefined,
+                toolName: tool.name,
+                toolUseId: tool.id,
+                toolInput: tool.input,
+            };
+        }
+        return { ...base, role: 'assistant', text: text || undefined };
+    }
+    if (raw.type === 'user') {
+        const content = raw.message?.content;
+        const result = firstToolResult(content);
+        if (result) {
+            return {
+                ...base,
+                role: 'tool',
+                toolUseId: result.toolUseId,
+                toolResult: result.content,
+                isError: result.isError,
+                text: typeof result.content === 'string' ? result.content : undefined,
+            };
+        }
+        const text = typeof content === 'string' ? content : textOf(content);
+        const meta = raw.isMeta === true || isHarnessNoise(text);
+        return {
+            ...base,
+            role: 'user',
+            text: text || undefined,
+            isMeta: meta,
+            // The whole point of the flag: intent is what the human typed, and only that.
+            isHumanTurn: !meta && text.trim().length > 0,
+        };
+    }
+    if (raw.type === 'system') {
+        return { ...base, role: 'system', text: textOf(raw.message?.content) || undefined, isMeta: true };
+    }
+    return undefined;
+}
+/** Harness-injected user turns. Present in the file, never typed by a person. */
+function isHarnessNoise(text) {
+    const trimmed = text.trimStart();
+    return (trimmed.startsWith('<command-name>') ||
+        trimmed.startsWith('<command-message>') ||
+        trimmed.startsWith('<local-command') ||
+        trimmed.startsWith('<system-reminder') ||
+        trimmed.includes('<system-reminder>') ||
+        trimmed.startsWith('[Request interrupted'));
+}
+function textOf(content) {
+    if (typeof content === 'string')
+        return content;
+    if (!Array.isArray(content))
+        return '';
+    const parts = [];
+    for (const block of content) {
+        if (typeof block !== 'object' || block === null)
+            continue;
+        const b = block;
+        if (b['type'] === 'text' && typeof b['text'] === 'string')
+            parts.push(b['text']);
+        if (b['type'] === 'thinking' && typeof b['thinking'] === 'string')
+            parts.push(b['thinking']);
+    }
+    return parts.join('\n\n');
+}
+function firstToolUse(content) {
+    if (!Array.isArray(content))
+        return undefined;
+    for (const block of content) {
+        if (typeof block !== 'object' || block === null)
+            continue;
+        const b = block;
+        if (b['type'] === 'tool_use') {
+            return {
+                name: typeof b['name'] === 'string' ? b['name'] : undefined,
+                id: typeof b['id'] === 'string' ? b['id'] : undefined,
+                input: b['input'],
+            };
+        }
+    }
+    return undefined;
+}
+function firstToolResult(content) {
+    if (!Array.isArray(content))
+        return undefined;
+    for (const block of content) {
+        if (typeof block !== 'object' || block === null)
+            continue;
+        const b = block;
+        if (b['type'] === 'tool_result') {
+            return {
+                toolUseId: typeof b['tool_use_id'] === 'string' ? b['tool_use_id'] : undefined,
+                content: b['content'],
+                isError: b['is_error'] === true,
+            };
+        }
+    }
+    return undefined;
+}
+/**
+ * The records that make up the session, in source order.
+ *
+ * Three facts about this format decide the algorithm, and getting any of them
+ * wrong silently changes what the successor is told:
+ *
+ * 1. **It is a tree.** `uuid` / `parentUuid` let a rewind or an edit leave the
+ *    abandoned branch in the file. Replaying in line order would hand a
+ *    successor work the human explicitly walked away from, so the live branch is
+ *    resolved by walking parent pointers back from the newest record.
+ *
+ * 2. **A compaction starts a new root.** `/compact` writes a summary and
+ *    continues with records whose `parentUuid` is null; the chain genuinely does
+ *    not cross that boundary. Measured on a real 103,757-event session, walking
+ *    parents from the last record reached 1,770 records and 7 user turns — the
+ *    walk stopped at the boundary and discarded every earlier turn, which are
+ *    the record of what the human actually asked for.
+ *
+ * 3. **The roots cannot be recognised by looking at them.** In that session the
+ *    boundary record was `type: system`, and 39,754 records carry a null parent
+ *    without starting anything. Classifying roots by type was the first attempt
+ *    and it silently dropped the session back to 853 events.
+ *
+ * So there is no classification: walk the newest record's parent chain; when the
+ * walk stops, take the record immediately *before* the oldest one it reached and
+ * walk that chain; repeat. Each pass recovers the tip of one earlier segment.
+ * Branch resolution is preserved wherever a rewind happened, history survives
+ * every boundary, and a malformed file terminates because the cursor strictly
+ * decreases. `--since-compact` keeps the first pass only.
+ */
+function resolveActiveBranch(records, byUuid, diagnostics) {
+    if (records.length === 0)
+        return [];
+    const byIndex = new Map(records.map((r) => [r.index, r]));
+    const kept = new Map();
+    let failedWalks = 0;
+    let cursor = records[records.length - 1];
+    while (cursor) {
+        const chain = new Map();
+        const guard = new Set();
+        let node = cursor;
+        while (node) {
+            if (chain.has(node.index))
+                break;
+            chain.set(node.index, node);
+            const parentUuid = node.raw.parentUuid;
+            if (!parentUuid)
+                break;
+            // A cycle would hang the process on a corrupt file.
+            if (guard.has(parentUuid)) {
+                diagnostics.push({ line: node.index + 1, message: 'parentUuid cycle; walk stopped' });
+                break;
+            }
+            guard.add(parentUuid);
+            const parent = byUuid.get(parentUuid);
+            if (!parent) {
+                // A dangling parent is common when a session is read mid-write or when
+                // the provider rewrote the head. Keep what was found and say so.
+                failedWalks += 1;
+                break;
+            }
+            node = parent;
+        }
+        for (const record of chain.values())
+            kept.set(record.index, record);
+        const oldest = Math.min(...chain.keys());
+        const previous = byIndex.get(oldest - 1);
+        if (!previous || oldest === 0)
+            break;
+        diagnostics.push({
+            line: 0,
+            message: `continuation at record ${oldest + 1}: recovered ${chain.size} record(s) before it and continued`,
+        });
+        cursor = previous;
+    }
+    const off = records.length - kept.size;
+    if (off > 0) {
+        diagnostics.push({
+            line: 0,
+            message: `${off} record(s) are not on any active branch (rewound or edited) and were skipped`,
+        });
+    }
+    if (failedWalks > 0) {
+        diagnostics.push({
+            line: 0,
+            message: `${failedWalks} parent pointer(s) were dangling; ${kept.size} record(s) kept`,
+        });
+    }
+    return [...kept.values()].sort((a, b) => a.index - b.index);
+}
+async function safeReaddir(path) {
+    try {
+        return await readdir(path);
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=claude.js.map

package/dist/adapters/claude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../src/adapters/claude.ts"],"names":[],"mappings":"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"}

package/dist/adapters/codex.d.ts

@@ -0,0 +1,11 @@
+import type { AgentKind, SessionIR, SessionRef } from '../ir/types.js';
+import type { Adapter, ListOptions, ReadOptions } from './types.js';
+export declare function codexStore(): string;
+export declare class CodexAdapter implements Adapter {
+    kind: AgentKind;
+    label: string;
+    store(): string;
+    available(): boolean;
+    list(options: ListOptions): Promise<SessionRef[]>;
+    read(ref: SessionRef, _options?: ReadOptions): Promise<SessionIR>;
+}