dsh-claude-move 0.2.1

package/lib/agmd-section.mjs

@@ -0,0 +1,144 @@
+// SPDX-License-Identifier: Apache-2.0
+// lib/agmd-section.mjs — $DSH_HOME/AGENTS.md 管理段读写（零 DSH 依赖）。
+//
+// 迁移记忆/指令文件到 DSH 全局 AGENTS.md：每个条目一个带标记注释的管理段，
+// 追加写、幂等替换、冲突 diff。绝不重写管理段之外的既有内容。
+//
+// 段格式：
+//   <!-- dsh-move:managed:start <key> -->
+//   <content>
+//   <!-- source: <sourceFile> -->
+//   <!-- dsh-move:managed:end <key> -->
+
+import path from 'node:path'
+import { homedir } from 'node:os'
+import { digestText } from './sources/contract.mjs'
+
+/**
+ * DSH 全局 AGENTS.md 默认路径：$DSH_HOME/AGENTS.md，DSH_HOME 缺失时 ~/.dsh/AGENTS.md。
+ * @param env - 环境对象，缺省 process.env。
+ * @returns 绝对路径。
+ */
+export function defaultAgentsMdPath(env = process.env) {
+  const base = env.DSH_HOME || path.join(homedir(), '.dsh')
+  return path.join(base, 'AGENTS.md')
+}
+
+/** 段渲染：内容 + 来源行 + 首尾标记（行间无多余空行，摘要比较稳定）。 */
+export function renderSection(key, content, sourceFile) {
+  const src = sourceFile ? `<!-- source: ${sourceFile} -->\n` : ''
+  return `<!-- dsh-move:managed:start ${key} -->\n${String(content ?? '').trim()}\n${src}<!-- dsh-move:managed:end ${key} -->`
+}
+
+/** 段内文本（与 renderSection 的标记间内容一致，供摘要比较）。 */
+export function sectionInner(content, sourceFile) {
+  return String(content ?? '').trim() + (sourceFile ? `\n<!-- source: ${sourceFile} -->` : '')
+}
+
+/**
+ * 解析现有 AGENTS.md：定位全部管理段（含未闭合段容错）。
+ * @param text - 全文。
+ * @returns `{ sections: Map<key, {startLine, endLine, raw}>, ordered: string[] }`。
+ */
+export function parseSections(text) {
+  const raw = String(text ?? '')
+  const lines = raw.split(/\r?\n/)
+  const sections = new Map()
+  const ordered = []
+  for (let i = 0; i < lines.length; i++) {
+    const m = lines[i].match(/^<!--\s*dsh-move:managed:start\s+([\w:./\\-]+)\s*-->$/)
+    if (!m) continue
+    const key = m[1]
+    const startLine = i
+    let endLine = -1
+    for (let j = i + 1; j < lines.length; j++) {
+      if (lines[j].trim() === `<!-- dsh-move:managed:end ${key} -->`) {
+        endLine = j
+        break
+      }
+    }
+    if (endLine < 0) continue // 未闭合：按普通文本处理，不吞掉。
+    sections.set(key, { startLine, endLine, raw: lines.slice(startLine + 1, endLine).join('\n') })
+    ordered.push(key)
+    i = endLine
+  }
+  return { sections, ordered, lines }
+}
+
+/**
+ * 计算把某段写入 AGENTS.md 的计划。
+ * @param current - 现有全文（可为空）。
+ * @param key - 段 key。
+ * @param content - 新段内容。
+ * @param sourceFile - 来源文件（渲染进段内）。
+ * @returns 无既有段 → `{ status: 'new', text }`；同摘要 → `{ status: 'unchanged' }`；
+ *          有既有段且不同 → `{ status: 'replace', text, oldContent, newContent, diff }`。
+ */
+export function planSection(current, key, content, sourceFile) {
+  const rendered = renderSection(key, content, sourceFile)
+  const { sections, lines } = parseSections(current)
+  const existing = sections.get(key)
+  if (!existing) {
+    const base = current && current.trim().length > 0
+      ? current.replace(/\s+$/, '') + '\n\n'
+      : ''
+    return { status: 'new', text: base + rendered + '\n' }
+  }
+  if (digestText(existing.raw) === digestText(sectionInner(content, sourceFile))) {
+    return { status: 'unchanged' }
+  }
+  const rebuilt = []
+  for (let i = 0; i < lines.length; i++) {
+    const hit = [...sections.values()].find((s) => s.startLine === i)
+    if (hit) {
+      rebuilt.push(hit.startLine === existing.startLine && hit.endLine === existing.endLine
+        ? rendered
+        : lines.slice(hit.startLine, hit.endLine + 1).join('\n'))
+      i = hit.endLine
+      continue
+    }
+    rebuilt.push(lines[i])
+  }
+  const text = rebuilt.join('\n').replace(/\n{3,}/g, '\n\n').replace(/\s+$/, '') + '\n'
+  return {
+    status: 'replace',
+    text,
+    oldContent: existing.raw,
+    newContent: content.trim(),
+    diff: lineDiff(existing.raw, rendered),
+  }
+}
+
+/** 段合并（merge 冲突解法）：旧段内容后接新内容（记忆条目追加语义）。 */
+export function mergedSection(current, key, content, sourceFile) {
+  const { sections } = parseSections(current)
+  const existing = sections.get(key)
+  const merged = existing
+    ? existing.raw.replace(/<!-- source: .* -->\s*$/, '').trimEnd() + '\n\n' + String(content ?? '').trim()
+    : String(content ?? '').trim()
+  return planSection(current, key, merged, sourceFile)
+}
+
+/**
+ * 计算两个文本的简化行级 diff（预览用，不含上下文行）。
+ * @param oldText - 旧内容。
+ * @param newText - 新内容。
+ * @returns `- 旧行` / `+ 新行` 数组（上限 200 行）。
+ */
+export function lineDiff(oldText, newText, cap = 200) {
+  const a = String(oldText ?? '').split(/\r?\n/)
+  const b = String(newText ?? '').split(/\r?\n/)
+  const diff = []
+  const len = Math.max(a.length, b.length)
+  for (let i = 0; i < len && diff.length < cap; i++) {
+    if (i >= a.length) {
+      diff.push('+ ' + b[i])
+    } else if (i >= b.length) {
+      diff.push('- ' + a[i])
+    } else if (a[i] !== b[i]) {
+      diff.push('- ' + a[i])
+      if (diff.length < cap) diff.push('+ ' + b[i])
+    }
+  }
+  return diff
+}

package/lib/commands-migrate.mjs

@@ -0,0 +1,85 @@
+// SPDX-License-Identifier: Apache-2.0
+// lib/commands-migrate.mjs — 四源钩子/命令 → DSH 命令/不支持清单（零 DSH 依赖）。
+//
+// 映射规则：
+//   - 纯提示词命令（无 shell/脚本执行）→ DSH 命令：迁移后把提示词注入当前会话
+//     （与一期 /resume-claude 的注入机制一致），绝不自动执行任何脚本。
+//   - 含 shell 的命令、事件/权限钩子 → 明确「不支持」清单：报告列出原因与建议，
+//     绝不静默丢弃，也绝不把未审查脚本注册成可执行命令。
+//   - DSH 事件面（tools/post-execute 等）不能由插件给宿主补挂钩子，因此
+//     Codex hooks / Claude settings.json hooks 一律进不支持清单并附建议。
+
+import { kebabName } from './skill-migrate.mjs'
+
+/** 命令名 → DSH 命令名（kebab-case）。 */
+export function toDshCommandName(raw) {
+  return kebabName(raw, 'migrated-command')
+}
+
+/**
+ * 分类一个命令/钩子文件：
+ * @param content - 文件原文。
+ * @param name - 命令名。
+ * @returns `{ promptOnly, prompt, hasShell }`。
+ *   OpenCode 命令的 ` ```!...``` ` 围栏 = 终端命令；Codex command.md 含 shebang
+ *   或 `#!/` 行视为 shell；其余视为纯提示词。
+ */
+export function classifyCommand(content, name = 'command') {
+  const text = String(content ?? '')
+  const hasShell = /```![^\n]*[\s\S]*?```/.test(text) || /^\s*#![^\n]*\n/.test(text)
+  return {
+    promptOnly: !hasShell,
+    prompt: text.trim(),
+    hasShell,
+    name: toDshCommandName(name),
+  }
+}
+
+/**
+ * 生成命令迁移计划（纯提示词 → register-command；含 shell → unsupported）。
+ * @param source - 源标识。
+ * @param kind - 'command'。
+ * @param id - 命令 id（文件路径或名称）。
+ * @param entry - classifyCommand 结果 + 源文件。
+ * @returns 迁移计划对象。
+ */
+export function commandPlan(source, kind, id, entry) {
+  const base = {
+    source: { file: entry.file, name: entry.name },
+    digest: entry.digest,
+  }
+  if (entry.promptOnly) {
+    return {
+      key: `${source}:${kind}:${id}`,
+      from: source,
+      kind,
+      action: 'register-command',
+      target: { commandName: entry.name },
+      content: entry.prompt,
+      ...base,
+    }
+  }
+  return {
+    key: `${source}:${kind}:${id}`,
+    from: source,
+    kind,
+    action: 'unsupported',
+    target: { commandName: entry.name },
+    content: entry.prompt,
+    reason: '命令含 shell 脚本：迁移器不注册可执行命令（安全边界），请人工审查后在 DSH 中重建',
+    ...base,
+  }
+}
+
+/** 钩子 → 不支持清单条目的统一文案（附 DSH 对应面建议）。 */
+export function hookUnsupportedPlan(source, id, file, reason) {
+  return {
+    key: `${source}:hook:${id}`,
+    from: source,
+    kind: 'hook',
+    action: 'unsupported',
+    source: { file },
+    reason: reason
+      ?? '事件/权限钩子在 DSH 无插件级等价 seam（宿主 tools/post-execute 瀑布需 composition 级接入），未自动迁移',
+  }
+}

package/lib/context.mjs

@@ -0,0 +1,156 @@
+// SPDX-License-Identifier: Apache-2.0
+// lib/context.mjs — memory 与 CLAUDE.md 的同步注入核心（F11/F13，零 DSH 依赖）。
+//
+// rc.6 的 systemPrompt 提供者是同步签名且组装不 await（实测），因此本模块
+// 只使用 statSync/readFileSync + mtime 缓存：每次请求按 mtime 重读变化文件，
+// 新记忆即时生效且不阻塞事件循环超过毫秒级。注入思路沿用
+// YYTbit/dsh-plugin-claude-bridge（MIT，见 THIRD_PARTY_NOTICES.md）。
+
+import { statSync, readFileSync, existsSync } from 'node:fs'
+import { readdirSync } from 'node:fs'
+import path from 'node:path'
+import { parseFrontmatter, extractMetadataType } from './frontmatter.mjs'
+
+/** memory 类型优先级（F11）：feedback > project > reference > user。 */
+export const MEMORY_TYPE_PRIORITY = Object.freeze({
+  feedback: 0,
+  project: 1,
+  reference: 2,
+  user: 3,
+})
+
+/** 默认 memory 注入字节上限（F11）。 */
+export const DEFAULT_MEMORY_MAX_BYTES = 8192
+
+/** 默认 memory 注入范围（B3）：只注入当前会话 cwd 对应项目的记忆。 */
+export const DEFAULT_MEMORY_SCOPE = 'current-project'
+
+/**
+ * 选择参与注入的 memory 目录（B3）：'current-project' 只取当前项目目录
+ * （无对应项目时回退全部目录保底，避免非 Claude 项目会话丢失记忆）；
+ * 'all' 取全部目录、当前项目排最前。
+ * @param dirs - 全部 memory 目录（memoryDirsSync 输出）。
+ * @param currentDir - 当前会话 cwd 对应的 memory 目录（可为 null）。
+ * @param scope - 'current-project' | 'all'。
+ * @returns 排序后的目录数组。
+ */
+export function selectMemoryDirs(dirs, currentDir, scope = DEFAULT_MEMORY_SCOPE) {
+  const current = currentDir !== null && currentDir !== undefined && dirs.includes(currentDir)
+    ? currentDir
+    : null
+  if (scope === 'all') {
+    return current ? [current, ...dirs.filter((d) => d !== current)] : [...dirs]
+  }
+  return current ? [current] : [...dirs]
+}
+
+/**
+ * 同步文件缓存：path → { mtimeMs, ctimeMs, size, text }。
+ * mtime+ctime+size 全部未变才复用（ctime 覆盖同毫秒等尺寸重写）。
+ * @returns `{ read(file) }`；文件不存在/不可读返回 null。
+ */
+export function makeFileCache() {
+  const cache = new Map()
+  return {
+    read(file) {
+      try {
+        const st = statSync(file)
+        if (!st.isFile()) return null
+        const prev = cache.get(file)
+        if (prev && prev.mtimeMs === st.mtimeMs && prev.ctimeMs === st.ctimeMs && prev.size === st.size) {
+          return prev.text
+        }
+        const text = readFileSync(file, 'utf8')
+        cache.set(file, { mtimeMs: st.mtimeMs, ctimeMs: st.ctimeMs, size: st.size, text })
+        return text
+      } catch {
+        // 缺失/不可读：按不存在处理，不抛（注入层容错）。
+        return null
+      }
+    },
+  }
+}
+
+/**
+ * 同步读取一个 memory 目录的全部条目（frontmatter 解析、空体跳过）。
+ * @param dir - `~/.claude/projects/<slug>/memory`。
+ * @param cache - makeFileCache 实例。
+ * @returns `[{ name, type, content, path }]`；目录缺失返回空数组。
+ */
+export function readMemoriesSync(dir, cache) {
+  let entries
+  try {
+    entries = readdirSync(dir)
+  } catch {
+    return []
+  }
+  const memories = []
+  for (const file of entries) {
+    if (!file.endsWith('.md') || file === 'MEMORY.md') continue
+    const filePath = path.join(dir, file)
+    const content = cache.read(filePath)
+    if (content === null) continue
+    const { meta, body } = parseFrontmatter(content)
+    if (body.trim().length === 0) continue
+    memories.push({
+      name: meta.name || file.replace(/\.md$/, ''),
+      type: extractMetadataType(meta),
+      content: body,
+      path: filePath,
+    })
+  }
+  return memories
+}
+
+/**
+ * 渲染记忆上下文段（F11）：按类型优先级排序，字节上限内保留完整条目。
+ * @param memories - readMemoriesSync 输出。
+ * @param maxBytes - 默认 DEFAULT_MEMORY_MAX_BYTES。
+ * @returns 渲染文本；无记忆返回 ''。
+ */
+export function renderMemories(memories, maxBytes = DEFAULT_MEMORY_MAX_BYTES) {
+  if (memories.length === 0) return ''
+  const sorted = [...memories].sort((a, b) => (
+    (MEMORY_TYPE_PRIORITY[a.type] ?? 99) - (MEMORY_TYPE_PRIORITY[b.type] ?? 99)
+  ))
+  const lines = ['# Agent Memory (from Claude Code)', '']
+  let bytes = 0
+  for (const memory of sorted) {
+    const block = [
+      `## ${memory.name} (${memory.type})`,
+      '',
+      memory.content,
+      '',
+    ].join('\n')
+    if (bytes + Buffer.byteLength(block, 'utf8') > maxBytes) break
+    lines.push(...block.split('\n'))
+    bytes += Buffer.byteLength(block, 'utf8')
+  }
+  return lines.join('\n').trimEnd()
+}
+
+/**
+ * 渲染 CLAUDE.md 指令段（F13）：项目级在前（当前项目优先），全局在后。
+ * @param projectText - 项目 `.claude/CLAUDE.md` 文本（可为 null）。
+ * @param globalText - 全局 `~/.claude/CLAUDE.md` 文本（可为 null）。
+ * @returns 渲染文本；两者皆空返回 ''。
+ */
+export function renderClaudeMd(projectText, globalText) {
+  const parts = []
+  if (projectText && projectText.trim().length > 0) {
+    parts.push('# Project Instructions (from Claude Code)\n\n' + projectText.trim())
+  }
+  if (globalText && globalText.trim().length > 0) {
+    parts.push('# Global Instructions (from Claude Code)\n\n' + globalText.trim())
+  }
+  return parts.join('\n\n')
+}
+
+/**
+ * 判断一个路径是否存在（同步，供提供者内联判断）。
+ * @param file - 绝对路径。
+ * @returns boolean。
+ */
+export function fileExists(file) {
+  return typeof file === 'string' && file.length > 0 && existsSync(file)
+}