codexmate 0.0.31 → 0.0.32

package/cli/session-convert-args.js

@@ -1,69 +1,69 @@
-const fs = require('fs');
-const path = require('path');
-
-const { parseMaxMessagesValue } = require('../lib/cli-session-utils');
-
-function ensureDir(dirPath) {
-    if (!dirPath) return;
-    if (fs.existsSync(dirPath)) return;
-    fs.mkdirSync(dirPath, { recursive: true });
-}
-
-function resolveOutputPath(outputPath, defaultFileName) {
-    const fallback = path.resolve(process.cwd(), defaultFileName);
-    if (typeof outputPath !== 'string' || !outputPath.trim()) return fallback;
-    const trimmed = outputPath.trim();
-    const resolved = path.resolve(trimmed);
-    if (/[\\\/]$/.test(trimmed)) {
-        ensureDir(resolved);
-        return path.join(resolved, defaultFileName);
-    }
-    if (fs.existsSync(resolved)) {
-        try { if (fs.statSync(resolved).isDirectory()) return path.join(resolved, defaultFileName); } catch (_) {}
-    }
-    return resolved;
-}
-
-function parseArgs(args = []) {
-    const options = { from: '', to: '', sessionId: '', filePath: '', output: '', outputDir: 'native', maxMessages: undefined };
-    const errors = [];
-    for (let i = 0; i < args.length; i += 1) {
-        const arg = String(args[i] || '');
-        const next = args[i + 1] || '';
-        if (!arg) continue;
-        if (arg === '--from') { options.from = next; i += 1; continue; }
-        if (arg.startsWith('--from=')) { options.from = arg.slice(7); continue; }
-        if (arg === '--to') { options.to = next; i += 1; continue; }
-        if (arg.startsWith('--to=')) { options.to = arg.slice(5); continue; }
-        if (arg === '--session-id') { options.sessionId = next; i += 1; continue; }
-        if (arg.startsWith('--session-id=')) { options.sessionId = arg.slice(13); continue; }
-        if (arg === '--file') { options.filePath = next; i += 1; continue; }
-        if (arg.startsWith('--file=')) { options.filePath = arg.slice(7); continue; }
-        if (arg === '--output') { options.output = next; i += 1; continue; }
-        if (arg.startsWith('--output=')) { options.output = arg.slice(9); continue; }
-        if (arg === '--output-dir') { options.outputDir = next; i += 1; continue; }
-        if (arg.startsWith('--output-dir=')) { options.outputDir = arg.slice(13); continue; }
-        if (arg === '--max-messages') { options.maxMessages = next; i += 1; continue; }
-        if (arg.startsWith('--max-messages=')) { options.maxMessages = arg.slice(15); continue; }
-        errors.push(`未知参数: ${arg}`);
-    }
-    options.from = String(options.from || '').trim().toLowerCase();
-    options.to = String(options.to || '').trim().toLowerCase();
-    if (options.from !== 'codex' && options.from !== 'claude') errors.push('参数 --from 仅支持 codex 或 claude');
-    if (options.to !== 'codex' && options.to !== 'claude') errors.push('参数 --to 仅支持 codex 或 claude');
-    if (options.from && options.to && options.from === options.to) errors.push('--from 与 --to 不能相同');
-    options.outputDir = String(options.outputDir || 'native').trim().toLowerCase();
-    if (options.outputDir !== 'native' && options.outputDir !== 'derived') errors.push('参数 --output-dir 仅支持 native 或 derived');
-    if (!options.from) errors.push('缺少 --from');
-    if (!options.to) errors.push('缺少 --to');
-    if (!options.sessionId && !options.filePath) errors.push('必须指定 --session-id 或 --file');
-    if (options.maxMessages !== undefined) {
-        const parsed = parseMaxMessagesValue(options.maxMessages);
-        if (parsed === null) errors.push('参数 --max-messages 无效');
-        else options.maxMessages = parsed === Infinity ? Infinity : Math.max(1, Math.floor(parsed));
-    }
-    return { options, error: errors.length ? errors.join('；') : '' };
-}
-
-module.exports = { ensureDir, resolveOutputPath, parseArgs };
-
+const fs = require('fs');
+const path = require('path');
+
+const { parseMaxMessagesValue } = require('../lib/cli-session-utils');
+
+function ensureDir(dirPath) {
+    if (!dirPath) return;
+    if (fs.existsSync(dirPath)) return;
+    fs.mkdirSync(dirPath, { recursive: true });
+}
+
+function resolveOutputPath(outputPath, defaultFileName) {
+    const fallback = path.resolve(process.cwd(), defaultFileName);
+    if (typeof outputPath !== 'string' || !outputPath.trim()) return fallback;
+    const trimmed = outputPath.trim();
+    const resolved = path.resolve(trimmed);
+    if (/[\\\/]$/.test(trimmed)) {
+        ensureDir(resolved);
+        return path.join(resolved, defaultFileName);
+    }
+    if (fs.existsSync(resolved)) {
+        try { if (fs.statSync(resolved).isDirectory()) return path.join(resolved, defaultFileName); } catch (_) {}
+    }
+    return resolved;
+}
+
+function parseArgs(args = []) {
+    const options = { from: '', to: '', sessionId: '', filePath: '', output: '', outputDir: 'native', maxMessages: undefined };
+    const errors = [];
+    for (let i = 0; i < args.length; i += 1) {
+        const arg = String(args[i] || '');
+        const next = args[i + 1] || '';
+        if (!arg) continue;
+        if (arg === '--from') { options.from = next; i += 1; continue; }
+        if (arg.startsWith('--from=')) { options.from = arg.slice(7); continue; }
+        if (arg === '--to') { options.to = next; i += 1; continue; }
+        if (arg.startsWith('--to=')) { options.to = arg.slice(5); continue; }
+        if (arg === '--session-id') { options.sessionId = next; i += 1; continue; }
+        if (arg.startsWith('--session-id=')) { options.sessionId = arg.slice(13); continue; }
+        if (arg === '--file') { options.filePath = next; i += 1; continue; }
+        if (arg.startsWith('--file=')) { options.filePath = arg.slice(7); continue; }
+        if (arg === '--output') { options.output = next; i += 1; continue; }
+        if (arg.startsWith('--output=')) { options.output = arg.slice(9); continue; }
+        if (arg === '--output-dir') { options.outputDir = next; i += 1; continue; }
+        if (arg.startsWith('--output-dir=')) { options.outputDir = arg.slice(13); continue; }
+        if (arg === '--max-messages') { options.maxMessages = next; i += 1; continue; }
+        if (arg.startsWith('--max-messages=')) { options.maxMessages = arg.slice(15); continue; }
+        errors.push(`未知参数: ${arg}`);
+    }
+    options.from = String(options.from || '').trim().toLowerCase();
+    options.to = String(options.to || '').trim().toLowerCase();
+    if (options.from !== 'codex' && options.from !== 'claude') errors.push('参数 --from 仅支持 codex 或 claude');
+    if (options.to !== 'codex' && options.to !== 'claude') errors.push('参数 --to 仅支持 codex 或 claude');
+    if (options.from && options.to && options.from === options.to) errors.push('--from 与 --to 不能相同');
+    options.outputDir = String(options.outputDir || 'native').trim().toLowerCase();
+    if (options.outputDir !== 'native' && options.outputDir !== 'derived') errors.push('参数 --output-dir 仅支持 native 或 derived');
+    if (!options.from) errors.push('缺少 --from');
+    if (!options.to) errors.push('缺少 --to');
+    if (!options.sessionId && !options.filePath) errors.push('必须指定 --session-id 或 --file');
+    if (options.maxMessages !== undefined) {
+        const parsed = parseMaxMessagesValue(options.maxMessages);
+        if (parsed === null) errors.push('参数 --max-messages 无效');
+        else options.maxMessages = parsed === Infinity ? Infinity : Math.max(1, Math.floor(parsed));
+    }
+    return { options, error: errors.length ? errors.join('；') : '' };
+}
+
+module.exports = { ensureDir, resolveOutputPath, parseArgs };
+

package/cli/session-convert-io.js

@@ -1,82 +1,82 @@
-const fs = require('fs');
-const readline = require('readline');
-
-const {
-    toIsoTime,
-    extractMessageText,
-    normalizeRole,
-    resolveMaxMessagesValue
-} = require('../lib/cli-session-utils');
-
-const { removeLeadingSystemMessage } = require('../lib/cli-sessions');
-
-async function readSessionMessages(filePath, source, maxMessages) {
-    const limit = resolveMaxMessagesValue(maxMessages, 200);
-    const state = { sessionId: '', cwd: '', updatedAt: '', messages: [], truncated: false };
-    const stream = fs.createReadStream(filePath, { encoding: 'utf-8' });
-    const rl = readline.createInterface({ input: stream, crlfDelay: Infinity });
-    for await (const line of rl) {
-        const trimmed = String(line || '').trim();
-        if (!trimmed) continue;
-        let record;
-        try { record = JSON.parse(trimmed); } catch (_) { continue; }
-        const timestamp = toIsoTime(record.timestamp, '');
-        if (timestamp) state.updatedAt = timestamp;
-        if (source === 'codex' && record.type === 'session_meta' && record.payload) {
-            if (!state.sessionId && record.payload.id) state.sessionId = String(record.payload.id || '');
-            if (!state.cwd && record.payload.cwd) state.cwd = String(record.payload.cwd || '');
-            continue;
-        }
-        if (source === 'claude') {
-            if (!state.sessionId && record.sessionId) state.sessionId = String(record.sessionId || '');
-            if (!state.cwd && record.cwd) state.cwd = String(record.cwd || '');
-        }
-        let role = '';
-        let text = '';
-        if (source === 'codex' && record.type === 'response_item' && record.payload && record.payload.type === 'message') {
-            role = normalizeRole(record.payload.role);
-            text = extractMessageText(record.payload.content);
-        } else if (source === 'claude') {
-            role = normalizeRole(record.type);
-            text = extractMessageText(record.message ? record.message.content : '');
-        }
-        if (!role || !text) continue;
-        state.messages.push({ role, text, timestamp });
-        if (limit !== Infinity && state.messages.length > limit) {
-            state.messages.shift();
-            state.truncated = true;
-        }
-    }
-    state.messages = removeLeadingSystemMessage(state.messages);
-    return state;
-}
-
-function buildTargetRecords(target, payload) {
-    const now = Date.now();
-    const sessionId = String(payload.sessionId || '').trim();
-    const cwd = String(payload.cwd || '').trim();
-    const messages = Array.isArray(payload.messages) ? payload.messages : [];
-    if (target === 'codex') {
-        const records = [{ type: 'session_meta', timestamp: new Date(now).toISOString(), payload: { id: sessionId, cwd } }];
-        for (let i = 0; i < messages.length; i += 1) {
-            const m = messages[i] || {};
-            const role = normalizeRole(m.role);
-            const text = typeof m.text === 'string' ? m.text : '';
-            if (!role || !text) continue;
-            records.push({ type: 'response_item', timestamp: m.timestamp || new Date(now + i).toISOString(), payload: { type: 'message', role, content: text } });
-        }
-        return records;
-    }
-    const records = [];
-    for (let i = 0; i < messages.length; i += 1) {
-        const m = messages[i] || {};
-        const role = normalizeRole(m.role);
-        const text = typeof m.text === 'string' ? m.text : '';
-        if (!role || !text) continue;
-        records.push({ type: role, timestamp: m.timestamp || new Date(now + i).toISOString(), sessionId, cwd, message: { content: text } });
-    }
-    return records;
-}
-
-module.exports = { readSessionMessages, buildTargetRecords };
-
+const fs = require('fs');
+const readline = require('readline');
+
+const {
+    toIsoTime,
+    extractMessageText,
+    normalizeRole,
+    resolveMaxMessagesValue
+} = require('../lib/cli-session-utils');
+
+const { removeLeadingSystemMessage } = require('../lib/cli-sessions');
+
+async function readSessionMessages(filePath, source, maxMessages) {
+    const limit = resolveMaxMessagesValue(maxMessages, 200);
+    const state = { sessionId: '', cwd: '', updatedAt: '', messages: [], truncated: false };
+    const stream = fs.createReadStream(filePath, { encoding: 'utf-8' });
+    const rl = readline.createInterface({ input: stream, crlfDelay: Infinity });
+    for await (const line of rl) {
+        const trimmed = String(line || '').trim();
+        if (!trimmed) continue;
+        let record;
+        try { record = JSON.parse(trimmed); } catch (_) { continue; }
+        const timestamp = toIsoTime(record.timestamp, '');
+        if (timestamp) state.updatedAt = timestamp;
+        if (source === 'codex' && record.type === 'session_meta' && record.payload) {
+            if (!state.sessionId && record.payload.id) state.sessionId = String(record.payload.id || '');
+            if (!state.cwd && record.payload.cwd) state.cwd = String(record.payload.cwd || '');
+            continue;
+        }
+        if (source === 'claude') {
+            if (!state.sessionId && record.sessionId) state.sessionId = String(record.sessionId || '');
+            if (!state.cwd && record.cwd) state.cwd = String(record.cwd || '');
+        }
+        let role = '';
+        let text = '';
+        if (source === 'codex' && record.type === 'response_item' && record.payload && record.payload.type === 'message') {
+            role = normalizeRole(record.payload.role);
+            text = extractMessageText(record.payload.content);
+        } else if (source === 'claude') {
+            role = normalizeRole(record.type);
+            text = extractMessageText(record.message ? record.message.content : '');
+        }
+        if (!role || !text) continue;
+        state.messages.push({ role, text, timestamp });
+        if (limit !== Infinity && state.messages.length > limit) {
+            state.messages.shift();
+            state.truncated = true;
+        }
+    }
+    state.messages = removeLeadingSystemMessage(state.messages);
+    return state;
+}
+
+function buildTargetRecords(target, payload) {
+    const now = Date.now();
+    const sessionId = String(payload.sessionId || '').trim();
+    const cwd = String(payload.cwd || '').trim();
+    const messages = Array.isArray(payload.messages) ? payload.messages : [];
+    if (target === 'codex') {
+        const records = [{ type: 'session_meta', timestamp: new Date(now).toISOString(), payload: { id: sessionId, cwd } }];
+        for (let i = 0; i < messages.length; i += 1) {
+            const m = messages[i] || {};
+            const role = normalizeRole(m.role);
+            const text = typeof m.text === 'string' ? m.text : '';
+            if (!role || !text) continue;
+            records.push({ type: 'response_item', timestamp: m.timestamp || new Date(now + i).toISOString(), payload: { type: 'message', role, content: text } });
+        }
+        return records;
+    }
+    const records = [];
+    for (let i = 0; i < messages.length; i += 1) {
+        const m = messages[i] || {};
+        const role = normalizeRole(m.role);
+        const text = typeof m.text === 'string' ? m.text : '';
+        if (!role || !text) continue;
+        records.push({ type: role, timestamp: m.timestamp || new Date(now + i).toISOString(), sessionId, cwd, message: { content: text } });
+    }
+    return records;
+}
+
+module.exports = { readSessionMessages, buildTargetRecords };
+

package/cli/session-convert.js

@@ -1,150 +1,150 @@
-const fs = require('fs');
-const path = require('path');
-
-const { parseArgs, ensureDir, resolveOutputPath } = require('./session-convert-args');
-const { readSessionMessages, buildTargetRecords } = require('./session-convert-io');
-
-function printUsage() {
-    console.log('\n用法:');
-    console.log('  codexmate convert-session --from <codex|claude> --to <codex|claude> (--session-id <ID>|--file <PATH>) [--output <PATH>] [--output-dir <native|derived>] [--max-messages <N|all|Infinity>]');
-}
-
-
-function resolveExistingDir(candidates, fallback) {
-    for (const candidate of candidates) {
-        if (!candidate) continue;
-        try {
-            if (fs.existsSync(candidate) && fs.statSync(candidate).isDirectory()) return candidate;
-        } catch (_) {}
-    }
-    return fallback;
-}
-
-function resolveCodexSessionsDir() {
-    const home = process.env.HOME || process.env.USERPROFILE || '';
-    const candidates = [];
-    if (process.env.CODEX_HOME) candidates.push(path.join(process.env.CODEX_HOME, 'sessions'));
-    if (process.env.XDG_CONFIG_HOME) candidates.push(path.join(process.env.XDG_CONFIG_HOME, 'codex', 'sessions'));
-    if (home) {
-        candidates.push(path.join(home, '.config', 'codex', 'sessions'));
-        candidates.push(path.join(home, '.codex', 'sessions'));
-    }
-    return resolveExistingDir(candidates, candidates[candidates.length - 1] || path.resolve('.codex/sessions'));
-}
-
-function resolveClaudeProjectsDir() {
-    const home = process.env.HOME || process.env.USERPROFILE || '';
-    const candidates = [];
-    const claudeHome = process.env.CLAUDE_HOME || process.env.CLAUDE_CONFIG_DIR || '';
-    if (claudeHome) candidates.push(path.join(claudeHome, 'projects'));
-    if (process.env.XDG_CONFIG_HOME) candidates.push(path.join(process.env.XDG_CONFIG_HOME, 'claude', 'projects'));
-    if (home) {
-        candidates.push(path.join(home, '.config', 'claude', 'projects'));
-        candidates.push(path.join(home, '.claude', 'projects'));
-    }
-    return resolveExistingDir(candidates, candidates[candidates.length - 1] || path.resolve('.claude/projects'));
-}
-
-function sanitizeClaudeProjectName(cwd) {
-    const value = typeof cwd === 'string' && cwd.trim() ? path.resolve(cwd.trim()) : 'codexmate-derived';
-    return value.replace(/[^a-zA-Z0-9._-]/g, '-').replace(/-+/g, '-').replace(/^-|-$/g, '') || 'codexmate-derived';
-}
-
-function buildSourceKey(from, sessionId, filePath) {
-    const seed = `${from}|${sessionId || ''}|${filePath || ''}`;
-    let hash = 0;
-    for (let i = 0; i < seed.length; i += 1) hash = ((hash << 5) - hash + seed.charCodeAt(i)) | 0;
-    return String(Math.abs(hash)).padStart(8, '0').slice(0, 8);
-}
-
-function resolveDefaultOutputPath(opt, sessionId, cwd) {
-    const safeSessionId = String(sessionId).replace(/[^a-zA-Z0-9_-]/g, '_') || 'session';
-    if (opt.output) return resolveOutputPath(opt.output, `${opt.to}-session-${safeSessionId}.jsonl`);
-    if (opt.outputDir === 'derived') {
-        const home = process.env.HOME || process.env.USERPROFILE || '';
-        const root = path.join(home || process.cwd(), '.codexmate', 'sessions', 'derived', opt.to, opt.from, buildSourceKey(opt.from, sessionId, opt.filePath));
-        return path.join(root, `${safeSessionId}.jsonl`);
-    }
-    if (opt.to === 'codex') return path.join(resolveCodexSessionsDir(), `${safeSessionId}.jsonl`);
-    return path.join(resolveClaudeProjectsDir(), sanitizeClaudeProjectName(cwd), `${safeSessionId}.jsonl`);
-}
-
-function getDerivedSessionMetaPath(filePath) {
-    if (!filePath) return '';
-    return filePath.toLowerCase().endsWith('.jsonl')
-        ? filePath.slice(0, -6) + '.meta.json'
-        : `${filePath}.meta.json`;
-}
-
-function writeJsonAtomic(filePath, value) {
-    const tmpPath = `${filePath}.tmp-${process.pid}-${Date.now()}`;
-    fs.writeFileSync(tmpPath, `${JSON.stringify(value, null, 2)}\n`, { encoding: 'utf-8', flag: 'wx' });
-    fs.renameSync(tmpPath, filePath);
-}
-
-async function cmdConvertSession(args = [], deps = {}) {
-    const parsed = parseArgs(args);
-    if (parsed.error) {
-        console.error('错误:', parsed.error);
-        printUsage();
-        process.exit(1);
-    }
-    if (!deps || typeof deps.resolveSessionFilePath !== 'function') {
-        console.error('错误: convert-session missing resolver');
-        process.exit(1);
-    }
-    const opt = parsed.options;
-    const filePath = deps.resolveSessionFilePath(opt.from, opt.filePath, opt.sessionId);
-    if (!filePath) {
-        console.error('转换失败: Session file not found');
-        process.exit(1);
-    }
-    const extracted = await readSessionMessages(filePath, opt.from, opt.maxMessages);
-    const sessionId = extracted.sessionId || opt.sessionId || path.basename(filePath, '.jsonl');
-    const records = buildTargetRecords(opt.to, { sessionId, cwd: extracted.cwd || '', messages: extracted.messages });
-    const jsonl = `${records.map(r => JSON.stringify(r)).join('\n')}\n`;
-    const outputPath = resolveDefaultOutputPath(opt, sessionId, extracted.cwd || '');
-    const metaPath = getDerivedSessionMetaPath(outputPath);
-    ensureDir(path.dirname(outputPath));
-    try {
-        if (fs.existsSync(metaPath)) {
-            const error = new Error(`target session metadata already exists: ${metaPath}`);
-            error.code = 'EEXIST';
-            throw error;
-        }
-        fs.writeFileSync(outputPath, jsonl, { encoding: 'utf-8', flag: 'wx' });
-        writeJsonAtomic(metaPath, {
-            version: 1,
-            createdAt: new Date().toISOString(),
-            source: {
-                type: opt.from,
-                sessionId,
-                filePath
-            },
-            target: {
-                type: opt.to,
-                sessionId,
-                filePath: outputPath
-            },
-            options: {
-                maxMessages: opt.maxMessages,
-                outputDir: opt.outputDir
-            }
-        });
-    } catch (error) {
-        if (error && error.code === 'EEXIST') {
-            console.error('转换失败: target session already exists:', outputPath);
-            process.exit(1);
-        }
-        try {
-            if (fs.existsSync(outputPath) && !fs.existsSync(metaPath)) fs.unlinkSync(outputPath);
-        } catch (_) {}
-        throw error;
-    }
-    console.log('\n✓ 会话已转换:', outputPath);
-    if (extracted.truncated) console.log('! 已截断: 可使用 --max-messages=all');
-    console.log();
-}
-
-module.exports = { cmdConvertSession };
-
+const fs = require('fs');
+const path = require('path');
+
+const { parseArgs, ensureDir, resolveOutputPath } = require('./session-convert-args');
+const { readSessionMessages, buildTargetRecords } = require('./session-convert-io');
+
+function printUsage() {
+    console.log('\n用法:');
+    console.log('  codexmate convert-session --from <codex|claude> --to <codex|claude> (--session-id <ID>|--file <PATH>) [--output <PATH>] [--output-dir <native|derived>] [--max-messages <N|all|Infinity>]');
+}
+
+
+function resolveExistingDir(candidates, fallback) {
+    for (const candidate of candidates) {
+        if (!candidate) continue;
+        try {
+            if (fs.existsSync(candidate) && fs.statSync(candidate).isDirectory()) return candidate;
+        } catch (_) {}
+    }
+    return fallback;
+}
+
+function resolveCodexSessionsDir() {
+    const home = process.env.HOME || process.env.USERPROFILE || '';
+    const candidates = [];
+    if (process.env.CODEX_HOME) candidates.push(path.join(process.env.CODEX_HOME, 'sessions'));
+    if (process.env.XDG_CONFIG_HOME) candidates.push(path.join(process.env.XDG_CONFIG_HOME, 'codex', 'sessions'));
+    if (home) {
+        candidates.push(path.join(home, '.config', 'codex', 'sessions'));
+        candidates.push(path.join(home, '.codex', 'sessions'));
+    }
+    return resolveExistingDir(candidates, candidates[candidates.length - 1] || path.resolve('.codex/sessions'));
+}
+
+function resolveClaudeProjectsDir() {
+    const home = process.env.HOME || process.env.USERPROFILE || '';
+    const candidates = [];
+    const claudeHome = process.env.CLAUDE_HOME || process.env.CLAUDE_CONFIG_DIR || '';
+    if (claudeHome) candidates.push(path.join(claudeHome, 'projects'));
+    if (process.env.XDG_CONFIG_HOME) candidates.push(path.join(process.env.XDG_CONFIG_HOME, 'claude', 'projects'));
+    if (home) {
+        candidates.push(path.join(home, '.config', 'claude', 'projects'));
+        candidates.push(path.join(home, '.claude', 'projects'));
+    }
+    return resolveExistingDir(candidates, candidates[candidates.length - 1] || path.resolve('.claude/projects'));
+}
+
+function sanitizeClaudeProjectName(cwd) {
+    const value = typeof cwd === 'string' && cwd.trim() ? path.resolve(cwd.trim()) : 'codexmate-derived';
+    return value.replace(/[^a-zA-Z0-9._-]/g, '-').replace(/-+/g, '-').replace(/^-|-$/g, '') || 'codexmate-derived';
+}
+
+function buildSourceKey(from, sessionId, filePath) {
+    const seed = `${from}|${sessionId || ''}|${filePath || ''}`;
+    let hash = 0;
+    for (let i = 0; i < seed.length; i += 1) hash = ((hash << 5) - hash + seed.charCodeAt(i)) | 0;
+    return String(Math.abs(hash)).padStart(8, '0').slice(0, 8);
+}
+
+function resolveDefaultOutputPath(opt, sessionId, cwd) {
+    const safeSessionId = String(sessionId).replace(/[^a-zA-Z0-9_-]/g, '_') || 'session';
+    if (opt.output) return resolveOutputPath(opt.output, `${opt.to}-session-${safeSessionId}.jsonl`);
+    if (opt.outputDir === 'derived') {
+        const home = process.env.HOME || process.env.USERPROFILE || '';
+        const root = path.join(home || process.cwd(), '.codexmate', 'sessions', 'derived', opt.to, opt.from, buildSourceKey(opt.from, sessionId, opt.filePath));
+        return path.join(root, `${safeSessionId}.jsonl`);
+    }
+    if (opt.to === 'codex') return path.join(resolveCodexSessionsDir(), `${safeSessionId}.jsonl`);
+    return path.join(resolveClaudeProjectsDir(), sanitizeClaudeProjectName(cwd), `${safeSessionId}.jsonl`);
+}
+
+function getDerivedSessionMetaPath(filePath) {
+    if (!filePath) return '';
+    return filePath.toLowerCase().endsWith('.jsonl')
+        ? filePath.slice(0, -6) + '.meta.json'
+        : `${filePath}.meta.json`;
+}
+
+function writeJsonAtomic(filePath, value) {
+    const tmpPath = `${filePath}.tmp-${process.pid}-${Date.now()}`;
+    fs.writeFileSync(tmpPath, `${JSON.stringify(value, null, 2)}\n`, { encoding: 'utf-8', flag: 'wx' });
+    fs.renameSync(tmpPath, filePath);
+}
+
+async function cmdConvertSession(args = [], deps = {}) {
+    const parsed = parseArgs(args);
+    if (parsed.error) {
+        console.error('错误:', parsed.error);
+        printUsage();
+        process.exit(1);
+    }
+    if (!deps || typeof deps.resolveSessionFilePath !== 'function') {
+        console.error('错误: convert-session missing resolver');
+        process.exit(1);
+    }
+    const opt = parsed.options;
+    const filePath = deps.resolveSessionFilePath(opt.from, opt.filePath, opt.sessionId);
+    if (!filePath) {
+        console.error('转换失败: Session file not found');
+        process.exit(1);
+    }
+    const extracted = await readSessionMessages(filePath, opt.from, opt.maxMessages);
+    const sessionId = extracted.sessionId || opt.sessionId || path.basename(filePath, '.jsonl');
+    const records = buildTargetRecords(opt.to, { sessionId, cwd: extracted.cwd || '', messages: extracted.messages });
+    const jsonl = `${records.map(r => JSON.stringify(r)).join('\n')}\n`;
+    const outputPath = resolveDefaultOutputPath(opt, sessionId, extracted.cwd || '');
+    const metaPath = getDerivedSessionMetaPath(outputPath);
+    ensureDir(path.dirname(outputPath));
+    try {
+        if (fs.existsSync(metaPath)) {
+            const error = new Error(`target session metadata already exists: ${metaPath}`);
+            error.code = 'EEXIST';
+            throw error;
+        }
+        fs.writeFileSync(outputPath, jsonl, { encoding: 'utf-8', flag: 'wx' });
+        writeJsonAtomic(metaPath, {
+            version: 1,
+            createdAt: new Date().toISOString(),
+            source: {
+                type: opt.from,
+                sessionId,
+                filePath
+            },
+            target: {
+                type: opt.to,
+                sessionId,
+                filePath: outputPath
+            },
+            options: {
+                maxMessages: opt.maxMessages,
+                outputDir: opt.outputDir
+            }
+        });
+    } catch (error) {
+        if (error && error.code === 'EEXIST') {
+            console.error('转换失败: target session already exists:', outputPath);
+            process.exit(1);
+        }
+        try {
+            if (fs.existsSync(outputPath) && !fs.existsSync(metaPath)) fs.unlinkSync(outputPath);
+        } catch (_) {}
+        throw error;
+    }
+    console.log('\n✓ 会话已转换:', outputPath);
+    if (extracted.truncated) console.log('! 已截断: 可使用 --max-messages=all');
+    console.log();
+}
+
+module.exports = { cmdConvertSession };
+