@henteko/ccdigest 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 henteko
+
+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/README.md

@@ -0,0 +1,85 @@
+# ccdigest
+
+Format [Claude Code](https://docs.anthropic.com/en/docs/claude-code) session data into readable Markdown for team sharing and code review.
+
+Claude Code stores session logs as JSONL files under `~/.claude/projects/`. ccdigest reads these files and converts them into clean, human-readable Markdown.
+
+## Installation
+
+```bash
+npm install -g @henteko/ccdigest
+```
+
+Or run directly with npx:
+
+```bash
+npx @henteko/ccdigest list
+```
+
+## Usage
+
+### List sessions
+
+```bash
+ccdigest list
+ccdigest list --branch main
+ccdigest list --json
+```
+
+### Show session as Markdown
+
+```bash
+ccdigest show <session-id>
+ccdigest show <session-id-1> <session-id-2>  # merge multiple sessions
+```
+
+### Export to file
+
+```bash
+ccdigest export <session-id> -o output.md
+ccdigest export <id-1> <id-2> -o combined.md
+```
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `--project <path>` | Project path (defaults to cwd) |
+| `--no-thinking` | Hide thinking blocks |
+| `--show-thinking` | Show thinking blocks expanded |
+| `--no-tools` | Hide tool calls |
+| `--max-tool-lines <n>` | Max lines for tool results (default: 50) |
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+```
+
+## Release
+
+1. Update version in `package.json`:
+
+```bash
+npm version patch  # or minor, major
+```
+
+2. Push the tag:
+
+```bash
+git push origin main --tags
+```
+
+3. Publish to npm:
+
+```bash
+npm publish --access public
+```
+
+`prepublishOnly` hook will automatically run build and tests before publishing.
+
+## License
+
+[MIT](LICENSE)

package/dist/cli/commands/export.d.ts

@@ -0,0 +1,5 @@
+import { type ShowOptions } from '../options.js';
+export declare function runExport(sessionIds: string[], options: ShowOptions & {
+    project?: string;
+    output: string;
+}): Promise<void>;

package/dist/cli/commands/export.js

@@ -0,0 +1,27 @@
+import fs from 'node:fs';
+import { findSession } from '../../core/session-store.js';
+import { parseSession } from '../../core/parser.js';
+import { mergeSessions } from '../../core/merger.js';
+import { formatSession } from '../../formatter/markdown.js';
+import { resolveFormatOptions } from '../options.js';
+export async function runExport(sessionIds, options) {
+    const projectPath = options.project || process.cwd();
+    try {
+        const parsedSessions = await Promise.all(sessionIds.map(async (id) => {
+            const session = findSession(projectPath, id);
+            return parseSession(session.filePath);
+        }));
+        const merged = parsedSessions.length > 1
+            ? mergeSessions(parsedSessions)
+            : parsedSessions[0];
+        const formatOpts = resolveFormatOptions(options);
+        const markdown = formatSession(merged, formatOpts);
+        fs.writeFileSync(options.output, markdown, 'utf-8');
+        console.error(`Exported to ${options.output}`);
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=export.js.map

package/dist/cli/commands/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../../src/cli/commands/export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAoB,MAAM,eAAe,CAAC;AAEvE,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,UAAoB,EACpB,OAA2D;IAE3D,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAErD,IAAI,CAAC;QACH,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,GAAG,CACtC,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;YAC1B,MAAM,OAAO,GAAG,WAAW,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YAC7C,OAAO,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACxC,CAAC,CAAC,CACH,CAAC;QAEF,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,GAAG,CAAC;YACtC,CAAC,CAAC,aAAa,CAAC,cAAc,CAAC;YAC/B,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;QAEtB,MAAM,UAAU,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAEnD,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QACpD,OAAO,CAAC,KAAK,CAAC,eAAe,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,UAAW,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/cli/commands/list.d.ts

@@ -0,0 +1,6 @@
+export interface ListOptions {
+    project?: string;
+    json?: boolean;
+    branch?: string;
+}
+export declare function runList(options: ListOptions): void;

package/dist/cli/commands/list.js

@@ -0,0 +1,41 @@
+import { listSessions } from '../../core/session-store.js';
+export function runList(options) {
+    const projectPath = options.project || process.cwd();
+    let sessions = listSessions(projectPath);
+    if (options.branch) {
+        sessions = sessions.filter((s) => s.branch === options.branch);
+    }
+    if (sessions.length === 0) {
+        console.error('No sessions found.');
+        process.exit(1);
+    }
+    if (options.json) {
+        console.log(JSON.stringify(sessions.map((s) => ({
+            sessionId: s.sessionId,
+            modifiedAt: s.modifiedAt.toISOString(),
+            sizeBytes: s.sizeBytes,
+            branch: s.branch,
+        })), null, 2));
+        return;
+    }
+    // Table format
+    const maxIdLen = Math.max(...sessions.map((s) => s.sessionId.length), 10);
+    const maxBranchLen = Math.max(...sessions.map((s) => s.branch.length), 6);
+    console.log(`${'SESSION ID'.padEnd(maxIdLen)}  ${'BRANCH'.padEnd(maxBranchLen)}  ${'MODIFIED'.padEnd(19)}  ${'SIZE'.padStart(10)}`);
+    console.log('-'.repeat(maxIdLen + 2 + maxBranchLen + 2 + 19 + 2 + 10));
+    for (const s of sessions) {
+        const date = s.modifiedAt.toISOString().replace('T', ' ').substring(0, 19);
+        const size = formatBytes(s.sizeBytes);
+        console.log(`${s.sessionId.padEnd(maxIdLen)}  ${s.branch.padEnd(maxBranchLen)}  ${date}  ${size.padStart(10)}`);
+    }
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    const kb = bytes / 1024;
+    if (kb < 1024)
+        return `${kb.toFixed(1)} KB`;
+    const mb = kb / 1024;
+    return `${mb.toFixed(1)} MB`;
+}
+//# sourceMappingURL=list.js.map

package/dist/cli/commands/list.js.map

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

package/dist/cli/commands/show.d.ts

@@ -0,0 +1,4 @@
+import { type ShowOptions } from '../options.js';
+export declare function runShow(sessionIds: string[], options: ShowOptions & {
+    project?: string;
+}): Promise<void>;

package/dist/cli/commands/show.js

@@ -0,0 +1,25 @@
+import { findSession } from '../../core/session-store.js';
+import { parseSession } from '../../core/parser.js';
+import { mergeSessions } from '../../core/merger.js';
+import { formatSession } from '../../formatter/markdown.js';
+import { resolveFormatOptions } from '../options.js';
+export async function runShow(sessionIds, options) {
+    const projectPath = options.project || process.cwd();
+    try {
+        const parsedSessions = await Promise.all(sessionIds.map(async (id) => {
+            const session = findSession(projectPath, id);
+            return parseSession(session.filePath);
+        }));
+        const merged = parsedSessions.length > 1
+            ? mergeSessions(parsedSessions)
+            : parsedSessions[0];
+        const formatOpts = resolveFormatOptions(options);
+        const markdown = formatSession(merged, formatOpts);
+        process.stdout.write(markdown);
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=show.js.map

package/dist/cli/commands/show.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.js","sourceRoot":"","sources":["../../../src/cli/commands/show.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAoB,MAAM,eAAe,CAAC;AAEvE,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,UAAoB,EACpB,OAA2C;IAE3C,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAErD,IAAI,CAAC;QACH,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,GAAG,CACtC,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;YAC1B,MAAM,OAAO,GAAG,WAAW,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YAC7C,OAAO,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACxC,CAAC,CAAC,CACH,CAAC;QAEF,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,GAAG,CAAC;YACtC,CAAC,CAAC,aAAa,CAAC,cAAc,CAAC;YAC/B,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;QAEtB,MAAM,UAAU,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAEnD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,UAAW,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/cli/options.d.ts

@@ -0,0 +1,8 @@
+import type { FormatOptions } from '../core/types.js';
+export interface ShowOptions {
+    thinking?: boolean;
+    showThinking?: boolean;
+    tools?: boolean;
+    maxToolLines?: string;
+}
+export declare function resolveFormatOptions(opts: ShowOptions): FormatOptions;

package/dist/cli/options.js

@@ -0,0 +1,13 @@
+export function resolveFormatOptions(opts) {
+    let showThinking = 'collapsed';
+    if (opts.thinking === false)
+        showThinking = 'hidden';
+    if (opts.showThinking)
+        showThinking = 'expanded';
+    return {
+        showThinking,
+        showTools: opts.tools !== false,
+        maxToolLines: opts.maxToolLines ? parseInt(opts.maxToolLines, 10) : 50,
+    };
+}
+//# sourceMappingURL=options.js.map

package/dist/cli/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/cli/options.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,oBAAoB,CAAC,IAAiB;IACpD,IAAI,YAAY,GAAkC,WAAW,CAAC;IAC9D,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK;QAAE,YAAY,GAAG,QAAQ,CAAC;IACrD,IAAI,IAAI,CAAC,YAAY;QAAE,YAAY,GAAG,UAAU,CAAC;IAEjD,OAAO;QACL,YAAY;QACZ,SAAS,EAAE,IAAI,CAAC,KAAK,KAAK,KAAK;QAC/B,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;KACvE,CAAC;AACJ,CAAC"}

package/dist/core/merger.d.ts

@@ -0,0 +1,6 @@
+import type { ParsedSession } from './types.js';
+/**
+ * Merge multiple parsed sessions into a single session with turns sorted by timestamp.
+ * If only one session is provided, it is returned as-is.
+ */
+export declare function mergeSessions(sessions: ParsedSession[]): ParsedSession;

package/dist/core/merger.js

@@ -0,0 +1,55 @@
+/**
+ * Merge multiple parsed sessions into a single session with turns sorted by timestamp.
+ * If only one session is provided, it is returned as-is.
+ */
+export function mergeSessions(sessions) {
+    if (sessions.length === 0) {
+        throw new Error('At least one session is required');
+    }
+    if (sessions.length === 1) {
+        return sessions[0];
+    }
+    // Collect all turns from all sessions
+    const allTurns = sessions.flatMap((s) => s.turns);
+    // Sort by timestamp (turns without timestamp go to the end)
+    allTurns.sort((a, b) => {
+        if (!a.timestamp && !b.timestamp)
+            return 0;
+        if (!a.timestamp)
+            return 1;
+        if (!b.timestamp)
+            return -1;
+        return a.timestamp.localeCompare(b.timestamp);
+    });
+    // Re-number turns
+    for (let i = 0; i < allTurns.length; i++) {
+        allTurns[i].turnNumber = i + 1;
+    }
+    // Merge metadata
+    const first = sessions[0].metadata;
+    const sessionId = sessions.map((s) => s.metadata.sessionId).join(',');
+    let startTime = first.startTime;
+    let endTime = first.endTime;
+    for (const s of sessions) {
+        const m = s.metadata;
+        if (m.startTime && (!startTime || m.startTime < startTime)) {
+            startTime = m.startTime;
+        }
+        if (m.endTime && (!endTime || m.endTime > endTime)) {
+            endTime = m.endTime;
+        }
+    }
+    return {
+        metadata: {
+            sessionId,
+            project: first.project,
+            branch: first.branch,
+            claudeVersion: first.claudeVersion,
+            startTime,
+            endTime,
+            model: first.model,
+        },
+        turns: allTurns,
+    };
+}
+//# sourceMappingURL=merger.js.map

package/dist/core/merger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merger.js","sourceRoot":"","sources":["../../src/core/merger.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,QAAyB;IACrD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IAED,sCAAsC;IACtC,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAElD,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACrB,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,SAAS;YAAE,OAAO,CAAC,CAAC;QAC3C,IAAI,CAAC,CAAC,CAAC,SAAS;YAAE,OAAO,CAAC,CAAC;QAC3B,IAAI,CAAC,CAAC,CAAC,SAAS;YAAE,OAAO,CAAC,CAAC,CAAC;QAC5B,OAAO,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,kBAAkB;IAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,QAAQ,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,iBAAiB;IACjB,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACnC,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEtE,IAAI,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IAChC,IAAI,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC5B,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;QACrB,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS,GAAG,SAAS,CAAC,EAAE,CAAC;YAC3D,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC;QAC1B,CAAC;QACD,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,GAAG,OAAO,CAAC,EAAE,CAAC;YACnD,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO;QACL,QAAQ,EAAE;YACR,SAAS;YACT,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,SAAS;YACT,OAAO;YACP,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB;QACD,KAAK,EAAE,QAAQ;KAChB,CAAC;AACJ,CAAC"}

package/dist/core/parser.d.ts

@@ -0,0 +1,9 @@
+import type { SessionEvent, ParsedSession } from './types.js';
+/**
+ * Read all events from a JSONL file.
+ */
+export declare function readEvents(filePath: string): Promise<SessionEvent[]>;
+/**
+ * Parse events into a structured session with conversation turns.
+ */
+export declare function parseSession(filePath: string): Promise<ParsedSession>;

package/dist/core/parser.js

@@ -0,0 +1,190 @@
+import fs from 'node:fs';
+import readline from 'node:readline';
+/**
+ * Read all events from a JSONL file.
+ */
+export async function readEvents(filePath) {
+    const events = [];
+    const fileStream = fs.createReadStream(filePath, { encoding: 'utf-8' });
+    const rl = readline.createInterface({ input: fileStream, crlfDelay: Infinity });
+    for await (const line of rl) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            events.push(JSON.parse(trimmed));
+        }
+        catch {
+            // Skip malformed lines
+        }
+    }
+    return events;
+}
+/**
+ * Extract session metadata from the events.
+ */
+function extractMetadata(events) {
+    let sessionId = '';
+    let project = '';
+    let branch = '';
+    let version = '';
+    let model = '';
+    let startTime = '';
+    let endTime = '';
+    for (const event of events) {
+        if ('sessionId' in event && event.sessionId) {
+            sessionId = event.sessionId;
+        }
+        if ('cwd' in event && event.cwd) {
+            project = event.cwd;
+        }
+        if ('gitBranch' in event && event.gitBranch) {
+            branch = event.gitBranch;
+        }
+        if ('version' in event && event.version) {
+            version = event.version;
+        }
+        if (event.type === 'assistant') {
+            const ae = event;
+            if (ae.message?.model) {
+                model = ae.message.model;
+            }
+        }
+        // Track time range
+        const ts = 'timestamp' in event ? event.timestamp : undefined;
+        if (ts) {
+            if (!startTime || ts < startTime)
+                startTime = ts;
+            if (!endTime || ts > endTime)
+                endTime = ts;
+        }
+    }
+    return { sessionId, project, branch, claudeVersion: version, startTime, endTime, model };
+}
+/**
+ * Extract text from a tool result content (string or array).
+ */
+function extractToolResultText(content) {
+    if (typeof content === 'string')
+        return content;
+    if (Array.isArray(content)) {
+        return content
+            .filter((item) => item.type === 'text' && item.text)
+            .map((item) => item.text)
+            .join('\n');
+    }
+    return '';
+}
+/**
+ * Parse events into a structured session with conversation turns.
+ */
+export async function parseSession(filePath) {
+    const events = await readEvents(filePath);
+    const metadata = extractMetadata(events);
+    const turns = [];
+    let currentTurn = null;
+    // Accumulate assistant message fragments by message.id
+    // Each streaming chunk for the same message.id gets merged
+    const pendingAssistantChunks = new Map();
+    // Map tool_use id -> ToolCall for filling in results later
+    const toolCallMap = new Map();
+    function flushAssistantMessages() {
+        const messages = [];
+        for (const [messageId, data] of pendingAssistantChunks) {
+            messages.push({
+                messageId,
+                model: data.model,
+                thinkingBlocks: data.thinkingBlocks,
+                textBlocks: data.textBlocks,
+                toolCalls: data.toolCalls,
+            });
+        }
+        pendingAssistantChunks.clear();
+        return messages;
+    }
+    for (const event of events) {
+        if (event.type === 'user') {
+            const ue = event;
+            const content = ue.message.content;
+            if (typeof content === 'string') {
+                // New user prompt → new turn
+                if (currentTurn) {
+                    currentTurn.assistantMessages = flushAssistantMessages();
+                    turns.push(currentTurn);
+                }
+                currentTurn = {
+                    turnNumber: turns.length + 1,
+                    userMessage: content,
+                    assistantMessages: [],
+                    timestamp: ue.timestamp,
+                };
+            }
+            else if (Array.isArray(content)) {
+                // tool_result → same turn, fill in tool results
+                for (const block of content) {
+                    if (block.type === 'tool_result') {
+                        const tr = block;
+                        const tc = toolCallMap.get(tr.tool_use_id);
+                        if (tc) {
+                            tc.result = extractToolResultText(tr.content);
+                        }
+                    }
+                }
+            }
+        }
+        else if (event.type === 'assistant') {
+            const ae = event;
+            const msgId = ae.message.id;
+            if (!msgId)
+                continue;
+            let accumulated = pendingAssistantChunks.get(msgId);
+            if (!accumulated) {
+                accumulated = {
+                    model: ae.message.model,
+                    thinkingBlocks: [],
+                    textBlocks: [],
+                    toolCalls: [],
+                };
+                pendingAssistantChunks.set(msgId, accumulated);
+            }
+            for (const block of ae.message.content) {
+                switch (block.type) {
+                    case 'thinking':
+                        if (block.thinking) {
+                            accumulated.thinkingBlocks.push(block.thinking);
+                        }
+                        break;
+                    case 'text':
+                        if (block.text && block.text.trim()) {
+                            accumulated.textBlocks.push(block.text);
+                        }
+                        break;
+                    case 'tool_use': {
+                        const tc = {
+                            name: block.name,
+                            input: block.input,
+                            result: '',
+                        };
+                        accumulated.toolCalls.push(tc);
+                        toolCallMap.set(block.id, tc);
+                        break;
+                    }
+                }
+            }
+        }
+        else if (event.type === 'system') {
+            const se = event;
+            if (se.subtype === 'turn_duration' && se.durationMs && currentTurn) {
+                currentTurn.durationMs = se.durationMs;
+            }
+        }
+        // Skip progress and file-history-snapshot events
+    }
+    // Flush the last turn
+    if (currentTurn) {
+        currentTurn.assistantMessages = flushAssistantMessages();
+        turns.push(currentTurn);
+    }
+    return { metadata, turns };
+}
+//# sourceMappingURL=parser.js.map

package/dist/core/parser.js.map

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

package/dist/core/session-store.d.ts

@@ -0,0 +1,35 @@
+export interface SessionInfo {
+    sessionId: string;
+    filePath: string;
+    modifiedAt: Date;
+    sizeBytes: number;
+    branch: string;
+}
+/**
+ * Encode a filesystem path to the directory name format used by Claude Code.
+ * e.g. "/Users/alice/dev/myproject" → "-Users-alice-dev-myproject"
+ */
+export declare function encodeProjectPath(projectPath: string): string;
+/**
+ * Decode a Claude Code project directory name back to a filesystem path.
+ * e.g. "-Users-alice-dev-myproject" → "/Users/alice/dev/myproject"
+ */
+export declare function decodeProjectPath(encoded: string): string;
+/**
+ * Get the Claude Code project data directory for a given project path.
+ */
+export declare function getProjectDir(projectPath: string): string;
+/**
+ * Extract the git branch from a JSONL session file by reading the first few lines.
+ * Returns an empty string if no gitBranch is found.
+ */
+export declare function extractBranch(filePath: string): string;
+/**
+ * List all session JSONL files for a project, sorted by modification time (newest first).
+ */
+export declare function listSessions(projectPath: string): SessionInfo[];
+/**
+ * Find a session by exact ID or prefix match.
+ * Returns the matching session, or throws if no match or ambiguous.
+ */
+export declare function findSession(projectPath: string, idOrPrefix: string): SessionInfo;

package/dist/core/session-store.js

@@ -0,0 +1,104 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+const CLAUDE_PROJECTS_DIR = path.join(os.homedir(), '.claude', 'projects');
+/**
+ * Encode a filesystem path to the directory name format used by Claude Code.
+ * e.g. "/Users/alice/dev/myproject" → "-Users-alice-dev-myproject"
+ */
+export function encodeProjectPath(projectPath) {
+    return projectPath.replace(/\//g, '-');
+}
+/**
+ * Decode a Claude Code project directory name back to a filesystem path.
+ * e.g. "-Users-alice-dev-myproject" → "/Users/alice/dev/myproject"
+ */
+export function decodeProjectPath(encoded) {
+    // The encoded string starts with '-' which represents the leading '/'
+    // Then each '-' represents a '/'
+    return encoded.replace(/-/g, '/');
+}
+/**
+ * Get the Claude Code project data directory for a given project path.
+ */
+export function getProjectDir(projectPath) {
+    const encoded = encodeProjectPath(projectPath);
+    return path.join(CLAUDE_PROJECTS_DIR, encoded);
+}
+/**
+ * Extract the git branch from a JSONL session file by reading the first few lines.
+ * Returns an empty string if no gitBranch is found.
+ */
+export function extractBranch(filePath) {
+    const MAX_BYTES = 4096;
+    const fd = fs.openSync(filePath, 'r');
+    try {
+        const buf = Buffer.alloc(MAX_BYTES);
+        const bytesRead = fs.readSync(fd, buf, 0, MAX_BYTES, 0);
+        const chunk = buf.toString('utf8', 0, bytesRead);
+        const lines = chunk.split('\n');
+        for (const line of lines) {
+            if (!line.trim())
+                continue;
+            try {
+                const event = JSON.parse(line);
+                if (event.gitBranch) {
+                    return event.gitBranch;
+                }
+            }
+            catch {
+                // skip malformed lines
+            }
+        }
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+    return '';
+}
+/**
+ * List all session JSONL files for a project, sorted by modification time (newest first).
+ */
+export function listSessions(projectPath) {
+    const projectDir = getProjectDir(projectPath);
+    if (!fs.existsSync(projectDir)) {
+        return [];
+    }
+    const entries = fs.readdirSync(projectDir, { withFileTypes: true });
+    const sessions = [];
+    for (const entry of entries) {
+        if (!entry.isFile() || !entry.name.endsWith('.jsonl')) {
+            continue;
+        }
+        const filePath = path.join(projectDir, entry.name);
+        const stat = fs.statSync(filePath);
+        const sessionId = entry.name.replace('.jsonl', '');
+        sessions.push({
+            sessionId,
+            filePath,
+            modifiedAt: stat.mtime,
+            sizeBytes: stat.size,
+            branch: extractBranch(filePath),
+        });
+    }
+    // Sort newest first
+    sessions.sort((a, b) => b.modifiedAt.getTime() - a.modifiedAt.getTime());
+    return sessions;
+}
+/**
+ * Find a session by exact ID or prefix match.
+ * Returns the matching session, or throws if no match or ambiguous.
+ */
+export function findSession(projectPath, idOrPrefix) {
+    const sessions = listSessions(projectPath);
+    const matches = sessions.filter((s) => s.sessionId.startsWith(idOrPrefix));
+    if (matches.length === 0) {
+        throw new Error(`No session found matching "${idOrPrefix}"`);
+    }
+    if (matches.length > 1) {
+        const ids = matches.map((s) => s.sessionId).join('\n  ');
+        throw new Error(`Ambiguous session prefix "${idOrPrefix}". Matches:\n  ${ids}`);
+    }
+    return matches[0];
+}
+//# sourceMappingURL=session-store.js.map

package/dist/core/session-store.js.map

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

package/dist/core/types.d.ts

@@ -0,0 +1,133 @@
+/** Common fields present on most JSONL events */
+export interface BaseEvent {
+    type: string;
+    uuid: string;
+    timestamp: string;
+    parentUuid: string | null;
+    isSidechain: boolean;
+    userType: string;
+    cwd: string;
+    sessionId: string;
+    version: string;
+    gitBranch: string;
+}
+export interface TextBlock {
+    type: 'text';
+    text: string;
+}
+export interface ThinkingBlock {
+    type: 'thinking';
+    thinking: string;
+    signature?: string;
+}
+export interface ToolUseBlock {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+export interface ToolResultBlock {
+    type: 'tool_result';
+    tool_use_id: string;
+    content: string | ToolResultContentItem[];
+}
+export interface ToolResultContentItem {
+    type: 'text' | 'image';
+    text?: string;
+    source?: unknown;
+}
+export type ContentBlock = TextBlock | ThinkingBlock | ToolUseBlock | ToolResultBlock;
+export interface UserEvent extends BaseEvent {
+    type: 'user';
+    message: {
+        role: 'user';
+        content: string | ContentBlock[];
+    };
+}
+export interface AssistantEvent extends BaseEvent {
+    type: 'assistant';
+    message: {
+        role: 'assistant';
+        id: string;
+        model: string;
+        stop_reason: string | null;
+        content: ContentBlock[];
+        usage?: {
+            input_tokens: number;
+            output_tokens: number;
+            cache_creation_input_tokens?: number;
+            cache_read_input_tokens?: number;
+        };
+    };
+    requestId?: string;
+}
+export interface ProgressEvent extends BaseEvent {
+    type: 'progress';
+    data: {
+        type: string;
+        [key: string]: unknown;
+    };
+    toolUseID: string;
+    parentToolUseID: string;
+}
+export interface SystemEvent extends BaseEvent {
+    type: 'system';
+    subtype: string;
+    durationMs?: number;
+    hookCount?: number;
+    hookInfos?: Array<{
+        command: string;
+    }>;
+    hookErrors?: unknown[];
+    stopReason?: string;
+    level?: string;
+    [key: string]: unknown;
+}
+export interface FileHistorySnapshotEvent {
+    type: 'file-history-snapshot';
+    messageId: string;
+    snapshot: {
+        messageId: string;
+        trackedFileBackups: Record<string, unknown>;
+        timestamp: string;
+    };
+    isSnapshotUpdate: boolean;
+}
+export type SessionEvent = UserEvent | AssistantEvent | ProgressEvent | SystemEvent | FileHistorySnapshotEvent;
+export interface SessionMetadata {
+    sessionId: string;
+    project: string;
+    branch: string;
+    claudeVersion: string;
+    startTime: string;
+    endTime: string;
+    model: string;
+}
+export interface ToolCall {
+    name: string;
+    input: Record<string, unknown>;
+    result: string;
+}
+export interface AssistantMessage {
+    messageId: string;
+    model: string;
+    thinkingBlocks: string[];
+    textBlocks: string[];
+    toolCalls: ToolCall[];
+}
+export interface ConversationTurn {
+    turnNumber: number;
+    userMessage: string;
+    assistantMessages: AssistantMessage[];
+    durationMs?: number;
+    timestamp?: string;
+}
+export interface ParsedSession {
+    metadata: SessionMetadata;
+    turns: ConversationTurn[];
+}
+export interface FormatOptions {
+    showThinking: 'collapsed' | 'expanded' | 'hidden';
+    showTools: boolean;
+    maxToolLines: number;
+}

package/dist/core/types.js

@@ -0,0 +1,5 @@
+// ============================================================
+// Raw JSONL Event Types (as stored by Claude Code)
+// ============================================================
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,mDAAmD;AACnD,+DAA+D"}

package/dist/formatter/markdown.d.ts

@@ -0,0 +1,5 @@
+import type { ParsedSession, FormatOptions } from '../core/types.js';
+/**
+ * Format a parsed session into Markdown.
+ */
+export declare function formatSession(session: ParsedSession, options?: Partial<FormatOptions>): string;

package/dist/formatter/markdown.js

@@ -0,0 +1,120 @@
+import { formatDuration, formatTimestamp, truncateLines, details, formatToolInput, } from './templates.js';
+const DEFAULT_OPTIONS = {
+    showThinking: 'collapsed',
+    showTools: true,
+    maxToolLines: 50,
+};
+/**
+ * Format a parsed session into Markdown.
+ */
+export function formatSession(session, options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    const parts = [];
+    parts.push(renderHeader(session));
+    for (const turn of session.turns) {
+        parts.push(renderTurn(turn, opts));
+    }
+    return parts.join('\n\n---\n\n') + '\n';
+}
+function renderHeader(session) {
+    const { metadata } = session;
+    const lines = [];
+    const isMerged = metadata.sessionId.includes(',');
+    if (isMerged) {
+        lines.push('# Merged Session Report');
+        lines.push('');
+        const ids = metadata.sessionId.split(',');
+        lines.push(`- **Sessions** (${ids.length}):`);
+        for (const id of ids) {
+            lines.push(`  - \`${id}\``);
+        }
+    }
+    else {
+        lines.push('# Session Report');
+        lines.push('');
+        lines.push(`- **Session ID**: \`${metadata.sessionId}\``);
+    }
+    lines.push(`- **Project**: \`${metadata.project}\``);
+    if (metadata.branch) {
+        lines.push(`- **Branch**: \`${metadata.branch}\``);
+    }
+    if (metadata.model) {
+        lines.push(`- **Model**: \`${metadata.model}\``);
+    }
+    if (metadata.startTime && metadata.endTime) {
+        const start = formatTimestamp(metadata.startTime);
+        const end = formatTimestamp(metadata.endTime);
+        const durationMs = new Date(metadata.endTime).getTime() - new Date(metadata.startTime).getTime();
+        const duration = formatDuration(durationMs);
+        if (start === end) {
+            lines.push(`- **Date**: ${start}`);
+        }
+        else {
+            lines.push(`- **Date**: ${start} - ${end} (${duration})`);
+        }
+    }
+    if (session.turns.length > 0) {
+        lines.push(`- **Turns**: ${session.turns.length}`);
+    }
+    return lines.join('\n');
+}
+function renderTurn(turn, opts) {
+    const parts = [];
+    // Turn header
+    let turnHeader = `## Turn ${turn.turnNumber}`;
+    if (turn.durationMs) {
+        turnHeader += ` (${formatDuration(turn.durationMs)})`;
+    }
+    parts.push(turnHeader);
+    // User message
+    parts.push('### User');
+    parts.push(turn.userMessage
+        .split('\n')
+        .map((line) => `> ${line}`)
+        .join('\n'));
+    // Assistant messages
+    for (const msg of turn.assistantMessages) {
+        parts.push(renderAssistantMessage(msg, opts));
+    }
+    return parts.join('\n\n');
+}
+function renderAssistantMessage(msg, opts) {
+    const parts = [];
+    parts.push('### Assistant');
+    // Thinking blocks
+    if (opts.showThinking !== 'hidden' && msg.thinkingBlocks.length > 0) {
+        const thinking = msg.thinkingBlocks.join('\n\n');
+        if (opts.showThinking === 'expanded') {
+            parts.push(details('Thinking', thinking, true));
+        }
+        else {
+            parts.push(details('Thinking', thinking, false));
+        }
+    }
+    // Text blocks
+    for (const text of msg.textBlocks) {
+        parts.push(text);
+    }
+    // Tool calls
+    if (opts.showTools) {
+        for (const tc of msg.toolCalls) {
+            parts.push(renderToolCall(tc, opts));
+        }
+    }
+    return parts.join('\n\n');
+}
+function renderToolCall(tc, opts) {
+    const inputDisplay = formatToolInput(tc.name, tc.input);
+    const header = inputDisplay
+        ? `**Tool: ${tc.name}** (${inputDisplay})`
+        : `**Tool: ${tc.name}**`;
+    if (!tc.result) {
+        return header;
+    }
+    const { text, truncated, totalLines } = truncateLines(tc.result, opts.maxToolLines);
+    const summaryExtra = truncated
+        ? ` (${totalLines} lines, showing first ${opts.maxToolLines})`
+        : ` (${totalLines} lines)`;
+    return `${header}\n\n${details(`Result${summaryExtra}`, '```\n' + text + (truncated ? '\n...' : '') + '\n```', false)}`;
+}
+//# sourceMappingURL=markdown.js.map

package/dist/formatter/markdown.js.map

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

package/dist/formatter/templates.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Format a duration in milliseconds to a human-readable string.
+ */
+export declare function formatDuration(ms: number): string;
+/**
+ * Format an ISO timestamp to a localized date-time string.
+ */
+export declare function formatTimestamp(iso: string): string;
+/**
+ * Truncate text to a maximum number of lines, with a note if truncated.
+ */
+export declare function truncateLines(text: string, maxLines: number): {
+    text: string;
+    truncated: boolean;
+    totalLines: number;
+};
+/**
+ * Wrap content in a collapsible <details> block.
+ */
+export declare function details(summary: string, content: string, open?: boolean): string;
+/**
+ * Format a tool input for display. Extracts the most relevant parameter.
+ */
+export declare function formatToolInput(name: string, input: Record<string, unknown>): string;

package/dist/formatter/templates.js

@@ -0,0 +1,80 @@
+/**
+ * Format a duration in milliseconds to a human-readable string.
+ */
+export function formatDuration(ms) {
+    const seconds = Math.floor(ms / 1000);
+    if (seconds < 60)
+        return `${seconds}秒`;
+    const minutes = Math.floor(seconds / 60);
+    const remainingSeconds = seconds % 60;
+    if (minutes < 60) {
+        return remainingSeconds > 0 ? `${minutes}分${remainingSeconds}秒` : `${minutes}分`;
+    }
+    const hours = Math.floor(minutes / 60);
+    const remainingMinutes = minutes % 60;
+    return remainingMinutes > 0 ? `${hours}時間${remainingMinutes}分` : `${hours}時間`;
+}
+/**
+ * Format an ISO timestamp to a localized date-time string.
+ */
+export function formatTimestamp(iso) {
+    const d = new Date(iso);
+    const pad = (n) => String(n).padStart(2, '0');
+    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}`;
+}
+/**
+ * Truncate text to a maximum number of lines, with a note if truncated.
+ */
+export function truncateLines(text, maxLines) {
+    const lines = text.split('\n');
+    if (lines.length <= maxLines) {
+        return { text, truncated: false, totalLines: lines.length };
+    }
+    return {
+        text: lines.slice(0, maxLines).join('\n'),
+        truncated: true,
+        totalLines: lines.length,
+    };
+}
+/**
+ * Wrap content in a collapsible <details> block.
+ */
+export function details(summary, content, open = false) {
+    const openAttr = open ? ' open' : '';
+    return `<details${openAttr}><summary>${summary}</summary>\n\n${content}\n\n</details>`;
+}
+/**
+ * Format a tool input for display. Extracts the most relevant parameter.
+ */
+export function formatToolInput(name, input) {
+    // Show the most relevant parameter based on tool name
+    switch (name) {
+        case 'Read':
+            return input.file_path ? `\`${input.file_path}\`` : '';
+        case 'Write':
+            return input.file_path ? `\`${input.file_path}\`` : '';
+        case 'Edit':
+            return input.file_path ? `\`${input.file_path}\`` : '';
+        case 'Bash':
+            return input.command ? `\`${String(input.command).substring(0, 100)}\`` : '';
+        case 'Glob':
+            return input.pattern ? `\`${input.pattern}\`` : '';
+        case 'Grep':
+            return input.pattern ? `\`${input.pattern}\`` : '';
+        case 'Task':
+            return input.description ? `"${input.description}"` : '';
+        case 'WebFetch':
+            return input.url ? `\`${input.url}\`` : '';
+        case 'WebSearch':
+            return input.query ? `"${input.query}"` : '';
+        default:
+            // Generic: show first string parameter
+            for (const [, val] of Object.entries(input)) {
+                if (typeof val === 'string' && val.length > 0) {
+                    return `\`${val.substring(0, 80)}\``;
+                }
+            }
+            return '';
+    }
+}
+//# sourceMappingURL=templates.js.map

package/dist/formatter/templates.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { runList } from './cli/commands/list.js';
+import { runShow } from './cli/commands/show.js';
+import { runExport } from './cli/commands/export.js';
+const program = new Command();
+program
+    .name('ccdigest')
+    .description('Format Claude Code session data into readable Markdown')
+    .version('0.1.0');
+program
+    .command('list')
+    .description('List available sessions')
+    .option('--project <path>', 'Project path (defaults to cwd)')
+    .option('--branch <name>', 'Filter by git branch')
+    .option('--json', 'Output as JSON')
+    .action(runList);
+const showFormatOptions = (cmd) => cmd
+    .option('--no-thinking', 'Hide thinking blocks')
+    .option('--show-thinking', 'Show thinking blocks expanded')
+    .option('--no-tools', 'Hide tool calls')
+    .option('--max-tool-lines <n>', 'Max lines for tool results (default: 50)')
+    .option('--project <path>', 'Project path (defaults to cwd)');
+showFormatOptions(program
+    .command('show <session-ids...>')
+    .description('Display session(s) as Markdown (stdout). Multiple IDs are merged chronologically.')).action(runShow);
+showFormatOptions(program
+    .command('export <session-ids...>')
+    .description('Export session(s) to a Markdown file. Multiple IDs are merged chronologically.')
+    .requiredOption('-o, --output <file>', 'Output file path')).action(runExport);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,UAAU,CAAC;KAChB,WAAW,CAAC,wDAAwD,CAAC;KACrE,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,yBAAyB,CAAC;KACtC,MAAM,CAAC,kBAAkB,EAAE,gCAAgC,CAAC;KAC5D,MAAM,CAAC,iBAAiB,EAAE,sBAAsB,CAAC;KACjD,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;KAClC,MAAM,CAAC,OAAO,CAAC,CAAC;AAEnB,MAAM,iBAAiB,GAAG,CAAC,GAAY,EAAE,EAAE,CACzC,GAAG;KACA,MAAM,CAAC,eAAe,EAAE,sBAAsB,CAAC;KAC/C,MAAM,CAAC,iBAAiB,EAAE,+BAA+B,CAAC;KAC1D,MAAM,CAAC,YAAY,EAAE,iBAAiB,CAAC;KACvC,MAAM,CAAC,sBAAsB,EAAE,0CAA0C,CAAC;KAC1E,MAAM,CAAC,kBAAkB,EAAE,gCAAgC,CAAC,CAAC;AAElE,iBAAiB,CACf,OAAO;KACJ,OAAO,CAAC,uBAAuB,CAAC;KAChC,WAAW,CAAC,mFAAmF,CAAC,CACpG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAElB,iBAAiB,CACf,OAAO;KACJ,OAAO,CAAC,yBAAyB,CAAC;KAClC,WAAW,CAAC,gFAAgF,CAAC;KAC7F,cAAc,CAAC,qBAAqB,EAAE,kBAAkB,CAAC,CAC7D,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AAEpB,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@henteko/ccdigest",
+  "version": "0.1.0",
+  "description": "Format Claude Code session data into readable Markdown for team sharing and code review",
+  "license": "MIT",
+  "author": "henteko",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/henteko/ccdigest.git"
+  },
+  "keywords": [
+    "claude-code",
+    "session",
+    "markdown",
+    "export",
+    "cli"
+  ],
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "ccdigest": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "dependencies": {
+    "commander": "^13.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0",
+    "tsx": "^4.19.0",
+    "@types/node": "^22.0.0"
+  }
+}