session-recovery

session-recovery — починка битых JSONL транскриптов Claude Code

Ты — хирург битых Claude Code сессий. Твоя задача — найти повреждённую картинку (или другой artifact) в .jsonl транскрипте и заменить на placeholder, чтобы сессия снова могла отправлять запросы в API без 400 ошибки.

Где живут транскрипты

~/.claude/projects/<sanitized-project-path>/<session-uuid>.jsonl

<sanitized-project-path> — путь проекта где работала сессия, заменены : \ на -. Например:

• C:\my-workspace\projects\my-project\ → C--my-workspace-projects-my-project
• C:\my-workspace\ → C--my-workspace
• /home/user/code/ → -home-user-code

Workflow

Phase 1 — Найти сессию

Если user указал какой проект — иди в соответствующую папку. Если нет — ищи самые свежие .jsonl:

# Все сессии, отсортированные по mtime
find ~/.claude/projects -name "*.jsonl" -not -name "*.backup-*" \
  2>/dev/null | xargs ls -lt 2>/dev/null | head -20

# Также можно по имени проекта
ls ~/.claude/projects/ | grep -i "<keyword>"

Спроси user какая именно сессия если несколько кандидатов.

Phase 2 — Backup ОБЯЗАТЕЛЬНО

ПЕРЕД любыми правками:

JSONL=<path-to-target-jsonl>
cp "$JSONL" "${JSONL}.backup-$(date +%Y-%m-%d-%H%M%S)"
echo "Backup: ${JSONL}.backup-$(date +%Y-%m-%d-%H%M%S)"

Phase 3 — Diagnose

Найди битые image entries через Python:

import json
import base64
import sys, io
sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')

JSONL = '<path>'

PNG_SIG = b'\x89PNG\r\n\x1a\n'
JPEG_SOI = b'\xff\xd8\xff'

bad_lines = []
total_imgs = 0
errors = 0

with open(JSONL, 'r', encoding='utf-8') as f:
    for i, line in enumerate(f, 1):
        try:
            obj = json.loads(line)
        except json.JSONDecodeError as e:
            errors += 1
            print(f'JSON error line {i}: {e}')
            continue

        def walk(node):
            if isinstance(node, dict):
                if node.get('type') == 'image':
                    src = node.get('source', {})
                    data = src.get('data', '')
                    mtype = src.get('media_type', '')
                    if data:
                        # Try base64 decode + magic byte check
                        try:
                            decoded = base64.b64decode(data, validate=True)
                            if mtype == 'image/png' and not decoded.startswith(PNG_SIG):
                                yield ('bad_magic_png', i, data[:30])
                            elif mtype == 'image/jpeg' and not decoded.startswith(JPEG_SOI):
                                yield ('bad_magic_jpg', i, data[:30])
                        except Exception as e:
                            yield ('bad_b64', i, f'{e}: {data[:30]}')
                for v in node.values(): yield from walk(v)
            elif isinstance(node, list):
                for v in node: yield from walk(v)

        for issue in walk(obj):
            bad_lines.append(issue)
            total_imgs += 1

print(f'Issues: {len(bad_lines)}, JSON errors: {errors}')
for b in bad_lines[:20]:
    print(b)