@alexgsdev/claude-code-transcript-export 0.1.0

package/dist/cli/probe.js

@@ -0,0 +1,83 @@
+import { readLogFile } from '../discover.js';
+import { isHumanTurn } from '../turns.js';
+/** Record types this package knows how to do something with. */
+const HANDLED_RECORDS = new Set([
+    'user',
+    'assistant',
+    'ai-title',
+    'custom-title',
+    'agent-name',
+    'continued-in',
+    'relocated',
+]);
+const HANDLED_BLOCKS = new Set([
+    'text',
+    'thinking',
+    'tool_use',
+    'tool_result',
+    'image',
+]);
+export function probeRecords(files) {
+    const recordTypes = new Map();
+    const blockTypes = new Map();
+    let userRecords = 0;
+    let humanTurns = 0;
+    for (const file of files) {
+        for (const record of file.records) {
+            const type = record.type ?? '(untyped)';
+            recordTypes.set(type, (recordTypes.get(type) ?? 0) + 1);
+            if (type === 'user') {
+                userRecords += 1;
+                if (isHumanTurn(record))
+                    humanTurns += 1;
+            }
+            const content = record.message?.content;
+            if (Array.isArray(content)) {
+                for (const block of content) {
+                    const blockType = block?.type ?? '(untyped)';
+                    blockTypes.set(blockType, (blockTypes.get(blockType) ?? 0) + 1);
+                }
+            }
+        }
+    }
+    const sorted = (map) => Object.fromEntries([...map.entries()].sort((a, b) => b[1] - a[1]));
+    return {
+        files: files.length,
+        recordTypes: sorted(recordTypes),
+        blockTypes: sorted(blockTypes),
+        userRecords,
+        humanTurns,
+        unhandledRecords: [...recordTypes.keys()]
+            .filter((t) => !HANDLED_RECORDS.has(t))
+            .sort(),
+        unhandledBlocks: [...blockTypes.keys()]
+            .filter((t) => !HANDLED_BLOCKS.has(t))
+            .sort(),
+    };
+}
+export function probe(paths) {
+    return probeRecords(paths.map((path) => ({ path, records: readLogFile(path) })));
+}
+export function formatProbe(report) {
+    const lines = [`session logs: ${report.files}`];
+    if (report.files === 0)
+        return lines.join('\n');
+    const table = (counts) => Object.entries(counts).map(([key, value]) => `  ${key}: ${value}`);
+    lines.push('', 'record types:', ...table(report.recordTypes));
+    lines.push('', 'content block types:', ...table(report.blockTypes));
+    const ratio = report.userRecords === 0
+        ? '0'
+        : ((report.humanTurns / report.userRecords) * 100).toFixed(1);
+    lines.push('', `user records: ${report.userRecords}, of which human turns: ${report.humanTurns} (${ratio}%)`, '(the difference is tool results and injected context, which are not turns)');
+    // The reason this command exists: the schema is observed, not documented.
+    if (report.unhandledRecords.length > 0) {
+        lines.push('', `record types this version does not handle:`);
+        lines.push(...report.unhandledRecords.map((t) => `  ${t}`));
+    }
+    if (report.unhandledBlocks.length > 0) {
+        lines.push('', `content blocks this version does not handle:`);
+        lines.push(...report.unhandledBlocks.map((t) => `  ${t}`));
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=probe.js.map

package/dist/cli/probe.js.map

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

package/dist/commits.d.ts

@@ -0,0 +1,31 @@
+import type { Session } from './types.js';
+/** One commit, as `readCommits` parses it out of `git log`. */
+export interface Commit {
+    hash: string;
+    /** Author date. Stable across a rebase; committer date is not. */
+    at: string;
+    subject: string;
+}
+/**
+ * The repository's commits, for pairing each session with work done during it.
+ *
+ * Failure is silent and returns nothing: extraction must not depend on git
+ * being present, on the tree being a repository, or on any commit existing.
+ */
+export declare function readCommits(cwd: string, runGit?: (cwd: string) => string): Commit[];
+/**
+ * Commits authored between a session's first and last record, oldest first.
+ *
+ * Read as "committed while this session was open", which is not the same claim
+ * as "committed by this session" — a commit made by hand mid-session lands here
+ * too, and two concurrent sessions both list what falls in the overlap.
+ *
+ * A window rather than the `Claude-Session` commit trailer, which looks like
+ * the exact key for this: that id appears nowhere structural in a log. It shows
+ * up only inside conversation content — in the text of a commit command, in
+ * `git log` output pasted back as a tool result, in prose discussing it — so a
+ * session quoting another session's id offers two candidates and no way to
+ * choose. A window is less precise and does not lie about its precision.
+ */
+export declare function commitsInWindow(commits: Commit[], session: Session): Commit[];
+//# sourceMappingURL=commits.d.ts.map

package/dist/commits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commits.d.ts","sourceRoot":"","sources":["../src/commits.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,+DAA+D;AAC/D,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;CACjB;AAID;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAKrB,GACH,MAAM,EAAE,CAgBV;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CAc7E"}

package/dist/commits.js

@@ -0,0 +1,59 @@
+import { execFileSync } from 'node:child_process';
+const FORMAT = '%h%x1f%aI%x1f%s';
+/**
+ * The repository's commits, for pairing each session with work done during it.
+ *
+ * Failure is silent and returns nothing: extraction must not depend on git
+ * being present, on the tree being a repository, or on any commit existing.
+ */
+export function readCommits(cwd, runGit = (dir) => execFileSync('git', ['log', `--format=${FORMAT}`], {
+    cwd: dir,
+    encoding: 'utf8',
+    maxBuffer: 32 * 1024 * 1024,
+})) {
+    let out;
+    try {
+        out = runGit(cwd);
+    }
+    catch {
+        return [];
+    }
+    return out
+        .split('\n')
+        .filter((line) => line.trim() !== '')
+        .map((line) => {
+        const [hash, at, ...rest] = line.split('\x1f');
+        return { hash: hash ?? '', at: at ?? '', subject: rest.join('\x1f') };
+    })
+        .filter((commit) => commit.hash !== '' && commit.at !== '');
+}
+/**
+ * Commits authored between a session's first and last record, oldest first.
+ *
+ * Read as "committed while this session was open", which is not the same claim
+ * as "committed by this session" — a commit made by hand mid-session lands here
+ * too, and two concurrent sessions both list what falls in the overlap.
+ *
+ * A window rather than the `Claude-Session` commit trailer, which looks like
+ * the exact key for this: that id appears nowhere structural in a log. It shows
+ * up only inside conversation content — in the text of a commit command, in
+ * `git log` output pasted back as a tool result, in prose discussing it — so a
+ * session quoting another session's id offers two candidates and no way to
+ * choose. A window is less precise and does not lie about its precision.
+ */
+export function commitsInWindow(commits, session) {
+    const { startedAt, endedAt } = session;
+    if (startedAt === undefined || endedAt === undefined)
+        return [];
+    const start = Date.parse(startedAt);
+    const end = Date.parse(endedAt);
+    if (Number.isNaN(start) || Number.isNaN(end))
+        return [];
+    return commits
+        .filter((commit) => {
+        const at = Date.parse(commit.at);
+        return !Number.isNaN(at) && at >= start && at <= end;
+    })
+        .sort((a, b) => Date.parse(a.at) - Date.parse(b.at));
+}
+//# sourceMappingURL=commits.js.map

package/dist/commits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commits.js","sourceRoot":"","sources":["../src/commits.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAWlD,MAAM,MAAM,GAAG,iBAAiB,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CACzB,GAAW,EACX,SAAkC,CAAC,GAAG,EAAE,EAAE,CACxC,YAAY,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,YAAY,MAAM,EAAE,CAAC,EAAE;IACjD,GAAG,EAAE,GAAG;IACR,QAAQ,EAAE,MAAM;IAChB,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;CAC5B,CAAC;IAEJ,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,GAAG;SACP,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;SACpC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC/C,OAAO,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;IACxE,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,EAAE,IAAI,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAChE,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAAC,OAAiB,EAAE,OAAgB;IACjE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IACvC,IAAI,SAAS,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAEhE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAExD,OAAO,OAAO;SACX,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE;QACjB,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,EAAE,IAAI,GAAG,CAAC;IACvD,CAAC,CAAC;SACD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,65 @@
+import type { ContentPolicy, ImagePolicy, ThinkingPolicy, ToolPolicy } from './types.js';
+/** A bad flag, a bad config, a missing directory — anything the user can fix. */
+export declare class UsageError extends Error {
+}
+/** Config filenames, in precedence order. First match wins. */
+export declare const CONFIG_NAMES: readonly [".claude-export.yaml", ".claude-export.json"];
+export interface IndexConfig {
+    enabled: boolean;
+    /** Project-specific prose, inserted verbatim. */
+    preamble: string | null;
+    listExcluded: 'count' | 'ids' | 'none';
+}
+export interface Config {
+    out: string;
+    include: string[];
+    exclude: string[];
+    tools: ToolPolicy;
+    thinking: ThinkingPolicy;
+    images: ImagePolicy;
+    imageDir: string;
+    subagents: 'ignore' | 'capture';
+    skipEmpty: boolean;
+    skipActive: boolean;
+    activeGraceMinutes: number;
+    commits: boolean;
+    index: IndexConfig;
+}
+export declare const DEFAULT_CONFIG: Config;
+export interface ResolvedConfig {
+    /** The directory holding the config file. This is the project root. */
+    root: string;
+    /** Absolute path of the config file, or null when defaults were used. */
+    configPath: string | null;
+    config: Config;
+}
+/**
+ * The nearest config file at or above `from`.
+ *
+ * The directory containing it is the project root, which is what makes `cctx`
+ * work from any subdirectory. The walk stops at the filesystem root; a config
+ * in an unexpected parent silently claiming a nested repo is the one failure
+ * mode of walk-up discovery, which is why every run prints the root it
+ * resolved.
+ */
+export declare function findConfig(from: string): string | null;
+/**
+ * Merges a parsed config object over the defaults.
+ *
+ * Unknown keys are an error naming the key, not a silent ignore: a typo in
+ * `exclude` that quietly does nothing is how a session you meant to withhold
+ * ends up in a committed transcript.
+ */
+export declare function mergeConfig(raw: unknown): Config;
+/** Parses a config file by extension. */
+export declare function parseConfigFile(path: string, contents: string): Config;
+/**
+ * Discovers and loads the config, or reports that there is none.
+ *
+ * `projectOverride` skips discovery entirely, for `--project`: a root without a
+ * config file, using defaults.
+ */
+export declare function loadConfig(from: string, projectOverride?: string): ResolvedConfig | null;
+/** The content policy a config implies. */
+export declare function contentPolicy(config: Config): ContentPolicy;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EACX,cAAc,EACd,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,iFAAiF;AACjF,qBAAa,UAAW,SAAQ,KAAK;CAAG;AAExC,+DAA+D;AAC/D,eAAO,MAAM,YAAY,yDAA0D,CAAC;AAEpF,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;CACxC;AAED,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,QAAQ,GAAG,SAAS,CAAC;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,eAAO,MAAM,cAAc,EAAE,MAgB5B,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYtD;AAyBD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CA4EhD;AAED,yCAAyC;AACzC,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAYtE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,eAAe,CAAC,EAAE,MAAM,GACvB,cAAc,GAAG,IAAI,CAiBvB;AAED,2CAA2C;AAC3C,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAE3D"}

package/dist/config.js

@@ -0,0 +1,189 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+/** A bad flag, a bad config, a missing directory — anything the user can fix. */
+export class UsageError extends Error {
+}
+/** Config filenames, in precedence order. First match wins. */
+export const CONFIG_NAMES = ['.claude-export.yaml', '.claude-export.json'];
+export const DEFAULT_CONFIG = {
+    out: 'docs/sessions',
+    include: [],
+    exclude: [],
+    tools: 'strip',
+    thinking: 'drop',
+    images: 'extract',
+    imageDir: 'images',
+    subagents: 'ignore',
+    skipEmpty: true,
+    // Capturing an in-progress session is the default: a partial transcript
+    // beats no transcript, and it self-heals on the next run. See spec §9.3.
+    skipActive: false,
+    activeGraceMinutes: 30,
+    commits: false,
+    index: { enabled: true, preamble: null, listExcluded: 'count' },
+};
+/**
+ * The nearest config file at or above `from`.
+ *
+ * The directory containing it is the project root, which is what makes `cctx`
+ * work from any subdirectory. The walk stops at the filesystem root; a config
+ * in an unexpected parent silently claiming a nested repo is the one failure
+ * mode of walk-up discovery, which is why every run prints the root it
+ * resolved.
+ */
+export function findConfig(from) {
+    let dir = resolve(from);
+    for (;;) {
+        for (const name of CONFIG_NAMES) {
+            const candidate = join(dir, name);
+            if (existsSync(candidate))
+                return candidate;
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+const ENUMS = {
+    tools: ['strip', 'keep'],
+    thinking: ['drop', 'keep'],
+    images: ['extract', 'marker'],
+    subagents: ['ignore', 'capture'],
+};
+function assertEnum(key, value) {
+    const allowed = ENUMS[key];
+    if (typeof value !== 'string' || !allowed.includes(value)) {
+        throw new UsageError(`\`${key}\` must be one of ${allowed.join(' | ')}, got ${JSON.stringify(value)}.`);
+    }
+}
+function assertStringArray(key, value) {
+    if (!Array.isArray(value) || value.some((v) => typeof v !== 'string')) {
+        throw new UsageError(`\`${key}\` must be a list of session UUIDs.`);
+    }
+    return value;
+}
+/**
+ * Merges a parsed config object over the defaults.
+ *
+ * Unknown keys are an error naming the key, not a silent ignore: a typo in
+ * `exclude` that quietly does nothing is how a session you meant to withhold
+ * ends up in a committed transcript.
+ */
+export function mergeConfig(raw) {
+    if (raw === null || raw === undefined)
+        return { ...DEFAULT_CONFIG };
+    if (typeof raw !== 'object' || Array.isArray(raw)) {
+        throw new UsageError('config must be a mapping of options.');
+    }
+    const source = raw;
+    const config = { ...DEFAULT_CONFIG, index: { ...DEFAULT_CONFIG.index } };
+    for (const [key, value] of Object.entries(source)) {
+        if (value === undefined)
+            continue;
+        switch (key) {
+            case 'out':
+            case 'imageDir':
+                if (typeof value !== 'string' || value === '') {
+                    throw new UsageError(`\`${key}\` must be a non-empty path.`);
+                }
+                config[key] = value;
+                break;
+            case 'include':
+            case 'exclude':
+                config[key] = assertStringArray(key, value);
+                break;
+            case 'tools':
+            case 'thinking':
+            case 'images':
+            case 'subagents':
+                assertEnum(key, value);
+                config[key] = value;
+                break;
+            case 'skipEmpty':
+            case 'skipActive':
+            case 'commits':
+                if (typeof value !== 'boolean')
+                    throw new UsageError(`\`${key}\` must be true or false.`);
+                config[key] = value;
+                break;
+            case 'activeGraceMinutes':
+                if (typeof value !== 'number' || !Number.isFinite(value) || value < 0) {
+                    throw new UsageError('`activeGraceMinutes` must be a non-negative number.');
+                }
+                config.activeGraceMinutes = value;
+                break;
+            case 'index': {
+                if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+                    throw new UsageError('`index` must be a mapping.');
+                }
+                for (const [k, v] of Object.entries(value)) {
+                    if (k === 'enabled') {
+                        if (typeof v !== 'boolean')
+                            throw new UsageError('`index.enabled` must be true or false.');
+                        config.index.enabled = v;
+                    }
+                    else if (k === 'preamble') {
+                        if (v !== null && typeof v !== 'string') {
+                            throw new UsageError('`index.preamble` must be a string or null.');
+                        }
+                        config.index.preamble = v;
+                    }
+                    else if (k === 'listExcluded') {
+                        if (v !== 'count' && v !== 'ids' && v !== 'none') {
+                            throw new UsageError('`index.listExcluded` must be one of count | ids | none.');
+                        }
+                        config.index.listExcluded = v;
+                    }
+                    else {
+                        throw new UsageError(`unknown config key \`index.${k}\`.`);
+                    }
+                }
+                break;
+            }
+            default:
+                throw new UsageError(`unknown config key \`${key}\`.`);
+        }
+    }
+    return config;
+}
+/** Parses a config file by extension. */
+export function parseConfigFile(path, contents) {
+    let raw;
+    try {
+        raw = path.endsWith('.json') ? JSON.parse(contents) : parseYaml(contents);
+    }
+    catch (cause) {
+        throw new UsageError(`${path} is not valid ${path.endsWith('.json') ? 'JSON' : 'YAML'}: ${cause instanceof Error ? cause.message : String(cause)}`);
+    }
+    return mergeConfig(raw);
+}
+/**
+ * Discovers and loads the config, or reports that there is none.
+ *
+ * `projectOverride` skips discovery entirely, for `--project`: a root without a
+ * config file, using defaults.
+ */
+export function loadConfig(from, projectOverride) {
+    if (projectOverride !== undefined) {
+        return {
+            root: resolve(projectOverride),
+            configPath: null,
+            config: { ...DEFAULT_CONFIG, index: { ...DEFAULT_CONFIG.index } },
+        };
+    }
+    const configPath = findConfig(from);
+    if (configPath === null)
+        return null;
+    return {
+        root: dirname(configPath),
+        configPath,
+        config: parseConfigFile(configPath, readFileSync(configPath, 'utf8')),
+    };
+}
+/** The content policy a config implies. */
+export function contentPolicy(config) {
+    return { tools: config.tools, thinking: config.thinking, images: config.images };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/content.d.ts

@@ -0,0 +1,50 @@
+import type { ContentPolicy, RawBlock, RawRecord, SessionImage } from './types.js';
+/**
+ * Text with harness scaffolding removed, contents and all.
+ *
+ * The command *name* goes with the rest, deliberately. Leaving it behind turns
+ * `/clear` into a one-word human turn — something the author never said — and
+ * shifts every turn number after it.
+ */
+export declare function stripHarnessTags(text: string): string;
+/**
+ * Wraps content in a fence long enough to contain it. Tool payloads carry
+ * markdown, which carries its own fences; a fixed ``` would let one break out.
+ */
+export declare function fence(content: string, info: string): string;
+/** Title lowercased, non-alphanumerics collapsed to hyphens, truncated to 60. */
+export declare function slugify(title: string): string;
+export interface RenderContext {
+    policy?: ContentPolicy;
+    /** First 8 characters of the session id, for naming extracted images. */
+    sessionId8?: string;
+    /** Images found while rendering are pushed here for the writer to persist. */
+    collected?: SessionImage[];
+}
+/**
+ * One image block as either a link to an extracted file or a marker.
+ *
+ * Naming by content hash is what keeps reruns stable: identical bytes always
+ * produce an identical filename, so the same screenshot pasted twice is stored
+ * once and a rerun rewrites nothing. An unrecognized media type falls back to
+ * a marker rather than guessing an extension.
+ */
+export declare function renderImage(block: RawBlock, context: RenderContext): string;
+/**
+ * One content block as markdown, or `null` when policy drops it.
+ *
+ * - `text` — verbatim.
+ * - `thinking` — dropped by default. Exploratory reasoning misleads a later
+ *   reader: a hypothesis the assistant talked itself out of reads like a
+ *   proposal if you find it out of context.
+ * - `tool_use` / `tool_result` — dropped by default. Anything authored in a
+ *   Claude Code session lands in the working tree and is captured by the
+ *   commit, so the payload is redundant with git while making up most of the
+ *   raw bytes.
+ * - `image` — extracted to a file, or a marker.
+ * - anything else — a visible marker, never a silent drop.
+ */
+export declare function renderBlock(block: RawBlock, context?: RenderContext): string | null;
+/** The text of one record under the given policy. */
+export declare function recordText(record: RawRecord, context?: RenderContext): string;
+//# sourceMappingURL=content.d.ts.map

package/dist/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../src/content.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAoBnF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAK3D;AAED,iFAAiF;AACjF,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM7C;AAgBD,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAuB3E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,QAAQ,EACf,OAAO,GAAE,aAAkB,GAC1B,MAAM,GAAG,IAAI,CAiCf;AAED,qDAAqD;AACrD,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,CAUjF"}

package/dist/content.js

@@ -0,0 +1,141 @@
+import { createHash } from 'node:crypto';
+import { DEFAULT_CONTENT_POLICY } from './types.js';
+/**
+ * Harness scaffolding wrapped around a human turn — a slash command's
+ * expansion, the caveat block preceding it, an injected reminder. Not authored
+ * prose; a record that is only this is not a turn at all.
+ */
+const HARNESS_TAGS = [
+    'local-command-caveat',
+    'local-command-stdout',
+    'command-name',
+    'command-message',
+    'command-args',
+    'system-reminder',
+];
+const PAIRED = new RegExp(`<(${HARNESS_TAGS.join('|')})>[\\s\\S]*?</\\1>`, 'g');
+const UNPAIRED = new RegExp(`</?(${HARNESS_TAGS.join('|')})>`, 'g');
+/**
+ * Text with harness scaffolding removed, contents and all.
+ *
+ * The command *name* goes with the rest, deliberately. Leaving it behind turns
+ * `/clear` into a one-word human turn — something the author never said — and
+ * shifts every turn number after it.
+ */
+export function stripHarnessTags(text) {
+    return text.replace(PAIRED, '').replace(UNPAIRED, '').trim();
+}
+/**
+ * Wraps content in a fence long enough to contain it. Tool payloads carry
+ * markdown, which carries its own fences; a fixed ``` would let one break out.
+ */
+export function fence(content, info) {
+    let longest = 0;
+    for (const run of content.matchAll(/`+/g))
+        longest = Math.max(longest, run[0].length);
+    const ticks = '`'.repeat(Math.max(3, longest + 1));
+    return `${ticks}${info}\n${content}\n${ticks}`;
+}
+/** Title lowercased, non-alphanumerics collapsed to hyphens, truncated to 60. */
+export function slugify(title) {
+    const collapsed = title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    return collapsed.slice(0, 60).replace(/-+$/, '') || 'untitled';
+}
+const EXTENSIONS = {
+    'image/png': 'png',
+    'image/jpeg': 'jpg',
+    'image/gif': 'gif',
+    'image/webp': 'webp',
+};
+/** Bytes in a human-readable size, for the marker form. */
+function humanSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${Math.round(bytes / 1024)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+/**
+ * One image block as either a link to an extracted file or a marker.
+ *
+ * Naming by content hash is what keeps reruns stable: identical bytes always
+ * produce an identical filename, so the same screenshot pasted twice is stored
+ * once and a rerun rewrites nothing. An unrecognized media type falls back to
+ * a marker rather than guessing an extension.
+ */
+export function renderImage(block, context) {
+    const media = block.source?.media_type ?? 'unknown';
+    const data = block.source?.data;
+    if (typeof data !== 'string' || data === '') {
+        return `> [image: ${media}, no data]`;
+    }
+    const bytes = Buffer.from(data, 'base64');
+    const extension = EXTENSIONS[media];
+    if (context.policy?.images === 'marker' || extension === undefined) {
+        return `> [image: ${media}, ${humanSize(bytes.byteLength)}]`;
+    }
+    const hash = createHash('sha256').update(bytes).digest('hex').slice(0, 8);
+    const filename = `${context.sessionId8 ?? 'session'}-${hash}.${extension}`;
+    if (context.collected && !context.collected.some((i) => i.filename === filename)) {
+        context.collected.push({ filename, mediaType: media, data: bytes });
+    }
+    return `![pasted image](images/${filename})`;
+}
+/**
+ * One content block as markdown, or `null` when policy drops it.
+ *
+ * - `text` — verbatim.
+ * - `thinking` — dropped by default. Exploratory reasoning misleads a later
+ *   reader: a hypothesis the assistant talked itself out of reads like a
+ *   proposal if you find it out of context.
+ * - `tool_use` / `tool_result` — dropped by default. Anything authored in a
+ *   Claude Code session lands in the working tree and is captured by the
+ *   commit, so the payload is redundant with git while making up most of the
+ *   raw bytes.
+ * - `image` — extracted to a file, or a marker.
+ * - anything else — a visible marker, never a silent drop.
+ */
+export function renderBlock(block, context = {}) {
+    const policy = context.policy ?? DEFAULT_CONTENT_POLICY;
+    switch (block.type) {
+        case 'text':
+            return typeof block.text === 'string' ? block.text : '';
+        case 'thinking':
+            return policy.thinking === 'keep'
+                ? fence(typeof block.thinking === 'string' ? block.thinking : '', 'thinking')
+                : null;
+        case 'tool_use': {
+            if (policy.tools === 'strip')
+                return null;
+            const name = typeof block.name === 'string' ? block.name : 'unknown';
+            return fence(JSON.stringify(block.input ?? null, null, 2), `tool_use:${name}`);
+        }
+        case 'tool_result': {
+            if (policy.tools === 'strip')
+                return null;
+            const name = typeof block.name === 'string' ? block.name : 'unknown';
+            return fence(JSON.stringify(block.content ?? null, null, 2), `tool_result:${name}`);
+        }
+        case 'image':
+            return renderImage(block, context);
+        default:
+            return `> [unhandled block type: ${block.type ?? 'undefined'}]`;
+    }
+}
+/** The text of one record under the given policy. */
+export function recordText(record, context = {}) {
+    const content = record.message?.content;
+    if (typeof content === 'string')
+        return content.trim();
+    if (!Array.isArray(content))
+        return '';
+    return content
+        .map((block) => renderBlock(block, context))
+        .filter((part) => part !== null && part.trim() !== '')
+        .join('\n\n')
+        .trim();
+}
+//# sourceMappingURL=content.js.map