dsh-claude-move 0.2.1

package/lib/sources/hermes/parser.mjs

@@ -0,0 +1,152 @@
+// SPDX-License-Identifier: Apache-2.0
+// lib/sources/hermes/parser.mjs — Hermes 源解析器（四合一迁移向导）。
+//
+// Hermes 范围 = skills 与记忆目录（不含会话）：`~/.hermes/state.db` 不在范围，
+// 永不读取。skills/ 是嵌套类别目录（skills/<category>/<name>/SKILL.md，类别
+// 层数不定）；memories/ 下 MEMORY.md / USER.md 是 `§` 分隔的记忆条目文件，内容
+// 原样迁移。只读白名单只含这两个目录：config.yaml / .env / state.db / pending/ /
+// skill-bundles/ / journey 数据等凭据与内部状态永不出现在白名单里。
+
+import { existsSync } from 'node:fs'
+import { readdir, readFile } from 'node:fs/promises'
+import { homedir } from 'node:os'
+import path from 'node:path'
+import { assertAllowedRead, digestText, emptyDetection, recordError } from '../contract.mjs'
+import { classifySkill, skipSkillEntry } from '../../skill-migrate.mjs'
+
+export const source = 'hermes'
+
+/** 目录/文件缺失（ENOENT/ENOTDIR）→ 视为空，不记错误。 */
+function isMissingError(err) {
+  return err && (err.code === 'ENOENT' || err.code === 'ENOTDIR')
+}
+
+/** Hermes 数据根定位（$HERMES_HOME / ~/.hermes）。 */
+export function locateHome(env = process.env, home = homedir()) {
+  const raw = env.HERMES_HOME
+  if (typeof raw === 'string' && raw.trim().length > 0) {
+    return path.resolve(raw)
+  }
+  return path.join(home, '.hermes')
+}
+
+/** 只读白名单：仅 skills 与 memories 两个目录。 */
+export function whitelist(home) {
+  return [
+    path.join(home, 'skills'),
+    path.join(home, 'memories'),
+  ]
+}
+
+/**
+ * 读取单个 SKILL.md，产出技能条目（name 缺 frontmatter 时取叶目录名）。
+ * @param skillsRoot - skills 根目录（id 以其为相对基准）。
+ * @param file - SKILL.md 绝对路径。
+ * @param roots - 白名单根列表。
+ * @param detection - 用于 recordError。
+ * @param signal - 可选 AbortSignal。
+ * @returns 技能条目；读取失败记错误并返回 null。
+ */
+async function readSkill(skillsRoot, file, roots, detection, signal) {
+  let content
+  try {
+    content = await readFile(assertAllowedRead(roots, file), { encoding: 'utf8', ...(signal ? { signal } : {}) })
+  } catch (err) {
+    if (signal?.aborted) throw err
+    recordError(detection, 'skill:' + file, err)
+    return null
+  }
+  const { compatible, name, description } = classifySkill(content)
+  const dir = path.dirname(file)
+  const id = path.relative(skillsRoot, dir).split(path.sep).join('/')
+  return {
+    id,
+    dir,
+    file,
+    name: name || path.basename(dir),
+    description,
+    compatible,
+    digest: digestText(content),
+  }
+}
+
+/**
+ * 递归遍历 skills/，跳过 `.` 开头目录/文件与 README.md/MEMORY.md（skipSkillEntry）。
+ * @returns SKILL.md 条目数组；目录缺失返回空数组。
+ */
+async function walkSkills(skillsRoot, dir, roots, out, detection, signal) {
+  if (signal?.aborted) return
+  let entries
+  try {
+    entries = await readdir(dir, { withFileTypes: true, ...(signal ? { signal } : {}) })
+  } catch (err) {
+    if (isMissingError(err)) return
+    throw err
+  }
+  entries.sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0))
+  for (const entry of entries) {
+    if (signal?.aborted) return
+    if (skipSkillEntry(entry.name)) continue
+    const full = path.join(dir, entry.name)
+    if (entry.isDirectory()) {
+      await walkSkills(skillsRoot, full, roots, out, detection, signal)
+    } else if (entry.isFile() && entry.name === 'SKILL.md') {
+      const skill = await readSkill(skillsRoot, full, roots, detection, signal)
+      if (skill) out.push(skill)
+    }
+  }
+}
+
+/** 扫描 skills/ 目录（缺失→空数组；读目录失败记错误）。 */
+async function scanSkills(skillsRoot, detection, roots, signal) {
+  const out = []
+  try {
+    await walkSkills(skillsRoot, skillsRoot, roots, out, detection, signal)
+  } catch (err) {
+    if (signal?.aborted) throw err
+    recordError(detection, 'skills', err)
+  }
+  return out
+}
+
+/** 扫描 memories/MEMORY.md 与 memories/USER.md（§ 分隔条目，缺失→跳过）。 */
+async function scanMemories(memoriesRoot, detection, roots, signal) {
+  const out = []
+  for (const [id, kind] of [['MEMORY.md', 'hermes-memory'], ['USER.md', 'hermes-user']]) {
+    if (signal?.aborted) return out
+    const file = path.join(memoriesRoot, id)
+    let content
+    try {
+      content = await readFile(assertAllowedRead(roots, file), { encoding: 'utf8', ...(signal ? { signal } : {}) })
+    } catch (err) {
+      if (signal?.aborted) throw err
+      if (isMissingError(err)) continue
+      recordError(detection, 'memories/' + id, err)
+      continue
+    }
+    out.push({
+      id,
+      file,
+      kind,
+      bytes: Buffer.byteLength(content, 'utf8'),
+      digest: digestText(content),
+    })
+  }
+  return out
+}
+
+/**
+ * 扫描 Hermes 数据根（skills + memories，不含会话）。
+ * @param home - 数据根目录。
+ * @param opts - `{ signal }`。
+ * @returns 统一 Detection；目录缺失返回空数组。
+ */
+export async function detect(home, { signal } = {}) {
+  const detection = emptyDetection(source, home)
+  const roots = whitelist(home)
+  const [skillsRoot, memoriesRoot] = roots
+  detection.homeExists = existsSync(home)
+  detection.skills = await scanSkills(skillsRoot, detection, roots, signal)
+  detection.memories = await scanMemories(memoriesRoot, detection, roots, signal)
+  return detection
+}

package/lib/sources/opencode/convert.mjs

@@ -0,0 +1,236 @@
+// SPDX-License-Identifier: Apache-2.0
+// lib/sources/opencode/convert.mjs — OpenCode 会话 → DSH 会话事件（零 DSH 依赖）。
+//
+// OpenCode message/part 行 → 统一回合中间结构 → synthesizeSession（与
+// Claude/Codex 共用事件纪律：turn/step 配对、tool/call 恰好一条结果、seq 连续）。
+// 兼容两条存储路径：opencode.db（node:sqlite 只读）与旧版 storage JSON 文件。
+//
+// 映射（据 OpenCode message-v2 契约，2026 实测）：
+//   - 用户 message（text parts，跳过 synthetic/ignored）→ 新回合提问；
+//   - assistant message → 一个或多个 step：step-start 开新步，text → text 块，
+//     reasoning → reasoning 块（明文，保留为日志内容、不进摘要），
+//     tool part（state.status=completed → 调用+结果；error → isError 结果；
+//     pending/running → 仅声明调用，合成错误结果兜底）；
+//   - 标题：session.title 或首条提问截断。
+
+import path from 'node:path'
+import { DatabaseSync } from 'node:sqlite'
+import { readFile, readdir } from 'node:fs/promises'
+import { synthesizeSession, appendTitleEvent, mintSessionId, SESSION_FORMAT_VERSION } from '../../convert.mjs'
+import { truncateText } from '../contract.mjs'
+
+/**
+ * 从数据库读取一个会话的全部 message/part 行（按 (time_created,id) 排序）。
+ * @param dbPath - opencode.db 绝对路径。
+ * @param sessionId - session.id。
+ * @returns `{ session, messages }`；messages = [{ id, data, parts: [...] }]。
+ */
+export function loadDbSessionRows(dbPath, sessionId) {
+  const db = new DatabaseSync(dbPath, { readOnly: true })
+  try {
+    const session = db.prepare(
+      'SELECT id, title, directory, time_created FROM session WHERE id = ?',
+    ).get(sessionId)
+    if (!session) return null
+    const rows = db.prepare(
+      'SELECT id, data FROM message WHERE session_id = ? ORDER BY time_created ASC, id ASC',
+    ).all(sessionId)
+    const partStmt = db.prepare(
+      'SELECT message_id, data FROM part WHERE session_id = ? ORDER BY time_created ASC, id ASC',
+    )
+    const partsByMessage = new Map()
+    for (const row of partStmt.all(sessionId)) {
+      if (!partsByMessage.has(row.message_id)) partsByMessage.set(row.message_id, [])
+      partsByMessage.get(row.message_id).push(row.data)
+    }
+    return {
+      session,
+      messages: rows.map((row) => ({
+        id: row.id,
+        data: safeJson(row.data),
+        parts: (partsByMessage.get(row.id) ?? []).map(safeJson).filter(Boolean),
+      })),
+    }
+  } finally {
+    try { db.close() } catch { /* 关闭失败无碍 */ }
+  }
+}
+
+/** 旧版 JSON 布局读取：session 元数据 + message/part 文件。 */
+export async function loadLegacySessionRows(dataHome, sessionId) {
+  const sessionFile = path.join(dataHome, 'storage', 'session', 'global', `${sessionId}.json`)
+  const messageDir = path.join(dataHome, 'storage', 'message', sessionId)
+  let session
+  try {
+    session = JSON.parse(await readFile(sessionFile, 'utf8'))
+  } catch {
+    return null
+  }
+  const rows = []
+  let names = []
+  try {
+    names = (await readdir(messageDir)).filter((n) => n.startsWith('msg_') && n.endsWith('.json')).sort()
+  } catch {
+    names = []
+  }
+  for (const name of names) {
+    try {
+      const msg = JSON.parse(await readFile(path.join(messageDir, name), 'utf8'))
+      const parts = []
+      const partDir = path.join(dataHome, 'storage', 'part', msg.id ?? name.replace(/\.json$/, ''))
+      let partNames = []
+      try {
+        partNames = (await readdir(partDir)).filter((n) => n.startsWith('prt_') && n.endsWith('.json')).sort()
+      } catch {
+        partNames = []
+      }
+      for (const pn of partNames) {
+        try {
+          parts.push(JSON.parse(await readFile(path.join(partDir, pn), 'utf8')))
+        } catch {
+          // 畸形 part 文件：跳过（转换期容忍）。
+        }
+      }
+      rows.push({ id: msg.id, data: { role: msg.role ?? 'assistant', modelID: msg.modelID, providerID: msg.providerID }, parts })
+    } catch {
+      // 畸形 message 文件：跳过。
+    }
+  }
+  return { session, messages: rows }
+}
+
+function safeJson(text) {
+  try {
+    const parsed = JSON.parse(String(text ?? ''))
+    return parsed && typeof parsed === 'object' ? parsed : null
+  } catch {
+    return null
+  }
+}
+
+/** 文本块是否可作提问内容（排除 synthetic/ignored 与空文本）。 */
+function usableText(part) {
+  return part
+    && part.type === 'text'
+    && typeof part.text === 'string'
+    && part.synthetic !== true
+    && part.ignored !== true
+    && part.text.trim().length > 0
+}
+
+/**
+ * 把 message/part 行合成为平衡的 DSH 会话事件日志。
+ * @param loaded - loadDbSessionRows / loadLegacySessionRows 的输出。
+ * @param args - `{ sessionId? }`（目标 id 覆盖）。
+ * @returns convertXxxJsonl 同构输出 `{ meta, events, turns, title, messages, toolCalls, skipped, skippedLines, typeCounts, repaired, sourceId }`。
+ */
+export function convertOpencodeRows(loaded, args = {}) {
+  if (!loaded) {
+    return {
+      meta: { version: SESSION_FORMAT_VERSION, id: args.sessionId ?? 'import-opencode', createdAt: Date.now() },
+      events: [], turns: [], title: null, messages: 0, toolCalls: 0,
+      skipped: 0, skippedLines: [], typeCounts: {}, repaired: { synthesized: 0, duplicateResults: 0, orphanResults: 0 }, sourceId: null,
+    }
+  }
+  const { session, messages } = loaded
+  const sourceId = session?.id ?? null
+  const createdAt = typeof session?.time_created === 'number' && session.time_created > 0
+    ? session.time_created
+    : undefined
+  const title = session?.title ? truncateText(session.title, 120) : null
+
+  const turns = []
+  let cur = null
+  let model = null
+  let firstPrompt = null
+
+  const openTurn = (prompt) => {
+    cur = { prompt, steps: [] }
+    turns.push(cur)
+  }
+  const openStep = () => {
+    const step = { content: [], toolCalls: [], toolResults: [] }
+    cur.steps.push(step)
+    return step
+  }
+
+  for (const row of messages) {
+    const data = row.data ?? {}
+    const role = data.role
+    const parts = row.parts ?? []
+    if (role === 'user') {
+      const prompt = parts.filter(usableText).map((p) => p.text).join('\n').trim()
+      if (prompt) {
+        if (firstPrompt === null) firstPrompt = prompt
+        openTurn(prompt)
+      }
+      continue
+    }
+    if (role !== 'assistant' || !cur) continue
+    if (typeof data.modelID === 'string' && !model) model = data.modelID
+
+    let step = null
+    for (const part of parts) {
+      if (!part || typeof part !== 'object') continue
+      if (part.type === 'step-start') {
+        step = openStep()
+        continue
+      }
+      if (part.type === 'step-finish') {
+        step = null
+        continue
+      }
+      if (!step) step = openStep()
+      if (part.type === 'text' && typeof part.text === 'string') {
+        step.content.push({ type: 'text', text: part.text })
+      } else if (part.type === 'reasoning' && typeof part.text === 'string') {
+        step.content.push({ type: 'reasoning', text: part.text })
+      } else if (part.type === 'tool') {
+        const state = part.state ?? {}
+        const callId = String(part.callID ?? `opencode-${part.id ?? 'call'}`)
+        step.toolCalls.push({
+          id: callId,
+          name: part.tool ?? 'unknown',
+          arguments: typeof state.input === 'string' ? state.input : JSON.stringify(state.input ?? {}),
+        })
+        if (state.status === 'completed') {
+          step.toolResults.push({
+            toolCallId: callId,
+            content: [{ type: 'text', text: typeof state.output === 'string' ? state.output : JSON.stringify(state.output ?? '') }],
+            isError: false,
+          })
+        } else if (state.status === 'error') {
+          step.toolResults.push({
+            toolCallId: callId,
+            content: [{ type: 'text', text: typeof state.error === 'string' ? state.error : JSON.stringify(state.error ?? '') }],
+            isError: true,
+          })
+        }
+        // pending/running：仅声明调用 → synthesizeTurnEvents 补合成错误结果。
+      }
+      // step 之后不再回到 null：同一 assistant message 内未标 step-start 的内容
+      // 归入当前步（上游会反复 step-start/step-finish，容错起见保持单调）。
+    }
+  }
+
+  const meta = {
+    version: SESSION_FORMAT_VERSION,
+    id: args.sessionId ?? mintSessionId(sourceId ?? 'opencode'),
+    createdAt: createdAt ?? Date.now(),
+  }
+  if (session?.directory) meta.cwd = session.directory
+
+  const synthesized = synthesizeSession({
+    meta,
+    turns,
+    title: null, // 标题统一由 appendTitleEvent 追加一次（避免重复标题事件）
+    provider: 'opencode',
+    model,
+    skipped: 0,
+    records: messages.length,
+    skippedLines: [],
+    typeCounts: {},
+  })
+  appendTitleEvent(synthesized, title ?? truncateText(firstPrompt ?? '', 120))
+  return { ...synthesized, sourceId }
+}

package/lib/sources/opencode/mapper.mjs

@@ -0,0 +1,102 @@
+// SPDX-License-Identifier: Apache-2.0
+// lib/sources/opencode/mapper.mjs — OpenCode 源映射器（四合一迁移向导，纯函数）。
+//
+// 清单 → 迁移计划：
+//   - sessions → import-session（provider 'opencode'；转换在 index.mjs 执行期经
+//     loadDbSessionRows / loadLegacySessionRows + convertOpencodeRows 完成；
+//     幂等走一期 imports.json，无 digest）。
+//   - agents（<configHome>/agent/*.md）→ convert-copy：转换为 DSH 技能
+//     （合成 name/description frontmatter；正文原样）。
+//   - commands（<configHome>/command/*.md）→ 纯提示词 → register-command；
+//     含 shell（```! 围栏/shebang）→ unsupported。
+//   - instructions（全局 AGENTS.md）→ append-section（项目级 AGENTS.md DSH
+//     原生读取，不迁移）。
+
+import { readFile } from 'node:fs/promises'
+import { planKey } from '../contract.mjs'
+import { defaultAgentsMdPath } from '../../agmd-section.mjs'
+import { skillTargetPath, kebabName } from '../../skill-migrate.mjs'
+import { commandPlan } from '../../commands-migrate.mjs'
+
+/**
+ * 映射 OpenCode 检测清单为迁移计划。
+ * @param source - 'opencode'。
+ * @param detection - opencode/parser.mjs 的 detect() 输出。
+ * @param opts - `{ skillsDir, agentsMdPath }`。
+ * @returns `{ plans, errors }`。
+ */
+export async function mapSource(source, detection, opts = {}) {
+  const plans = []
+  const errors = []
+  const agentsMdPath = opts.agentsMdPath ?? defaultAgentsMdPath()
+  const skillsDir = opts.skillsDir
+
+  for (const session of detection.sessions ?? []) {
+    plans.push({
+      key: planKey(source, 'session', `${session.format}:${session.sessionId ?? session.id}`),
+      from: source,
+      kind: 'session',
+      action: 'import-session',
+      source: {
+        file: session.file,
+        sessionId: session.sessionId ?? session.id,
+        storage: session.storage,
+        dataHome: detection.home,
+        title: session.title,
+        cwd: session.cwd,
+        format: session.format,
+        importKey: `${session.storage}:${session.sessionId ?? session.id}`,
+        turns: session.turns,
+      },
+      target: {},
+      provider: 'opencode',
+      title: session.title,
+    })
+  }
+
+  for (const skill of detection.skills ?? []) {
+    plans.push({
+      key: planKey(source, 'skill', skill.id),
+      from: source,
+      kind: 'skill',
+      action: 'convert-copy',
+      source: { file: skill.file, dir: skill.dir, name: skill.name },
+      target: skillsDir ? { path: skillTargetPath(skillsDir, kebabName(skill.name)) } : {},
+      digest: skill.digest,
+    })
+  }
+
+  for (const command of detection.commands ?? []) {
+    try {
+      const content = await readFile(command.file, 'utf8')
+      plans.push(commandPlan(source, 'command', command.id, {
+        file: command.file,
+        name: command.name,
+        promptOnly: command.promptOnly,
+        prompt: content,
+        digest: command.digest,
+      }))
+    } catch (err) {
+      errors.push(`command:${command.file}: ${String((err && err.message) || err)}`)
+    }
+  }
+
+  for (const instruction of detection.instructions ?? []) {
+    try {
+      const content = await readFile(instruction.file, 'utf8')
+      plans.push({
+        key: planKey(source, 'instruction', instruction.id),
+        from: source,
+        kind: 'instruction',
+        action: 'append-section',
+        source: { file: instruction.file, kind: instruction.kind },
+        target: { path: agentsMdPath },
+        content,
+        digest: instruction.digest,
+      })
+    } catch (err) {
+      errors.push(`instruction:${instruction.file}: ${String((err && err.message) || err)}`)
+    }
+  }
+  return { plans, ...(errors.length > 0 ? { errors } : {}) }
+}