dsh-config-manager 0.1.69 → 0.1.71

package/lib/foreign/truth-table.js

@@ -0,0 +1,333 @@
+import { joinFor } from './platform-paths.js';
+export const TRUTH_PROBES = {
+    win32: {
+        homeDir: joinFor('win32', 'C:', 'probe'),
+        appdata: joinFor('win32', 'C:', 'probe', 'AppData', 'Roaming'),
+        xdgdata: joinFor('win32', 'C:', 'probe', 'AppData', 'Local'),
+    },
+    darwin: {
+        homeDir: '/Users/probe',
+        appdata: '/Users/probe/Library/Application Support',
+        xdgdata: '/Users/probe/Library/Application Support',
+    },
+    linux: {
+        homeDir: '/home/probe',
+        appdata: '/home/probe/.config',
+        xdgdata: '/home/probe/.local/share',
+    },
+};
+/** **空环境**（平台默认根的真值；环境变量覆盖由 envKeys 单独断言） */
+export const TRUTH_PROBE_ENV = {};
+/** 展开一个令牌模板（未识别的令牌原样保留 —— 那样护栏会立刻红，不会静默给出错路径） */
+export function expandTruthTemplate(platform, template) {
+    const probe = TRUTH_PROBES[platform];
+    let out = template;
+    out = out.split('<home>').join(probe.homeDir);
+    out = out.split('<appdata>').join(probe.appdata);
+    out = out.split('<xdgdata>').join(probe.xdgdata);
+    return out;
+}
+export function expandTruthList(platform, templates) {
+    return templates.map((t) => expandTruthTemplate(platform, t));
+}
+/* ---------------- 构造小工具（保持条目紧凑、可读） ---------------- */
+/** 三平台同形 */
+function all3(...paths) {
+    return { win32: paths, darwin: paths, linux: paths };
+}
+function perPlatform(win32, darwin, linux) {
+    return { win32, darwin, linux };
+}
+/* ---------------- 真值表本体（**顺序 = FORMATS 清单顺序 + 既有六来源在前**） ---------------- */
+export const FOREIGN_TRUTH_TABLES = [
+    /* ============ 配置类（v1 既有六个；本次**只补 probePaths/evidence**，路径表不动） ============ */
+    {
+        id: 'claude-code',
+        defaults: all3('<home>/.claude', '<home>/.claude.json', '<home>/.claude/settings.json', '<home>/.claude/CLAUDE.md', '<home>/.claude/skills', '<home>/.claude/commands', '<home>/.claude/projects'),
+        envKeys: [],
+        autoRoots: true,
+        evidence: 'measured',
+        refs: 'chat-import §3.1 claude 行（projects + Claude-3p 第二根）；本仓本机实测（~/.claude、~/.claude.json 存在）',
+        dynamic: '会话在 ~/.claude/projects/<slug>/<uuid>.jsonl（v1 已实现会话转码）',
+    },
+    {
+        id: 'hermes',
+        defaults: perPlatform([
+            '<xdgdata>/Hermes/config.yaml', '<xdgdata>/Hermes/SOUL.md', '<xdgdata>/Hermes/skills',
+            '<xdgdata>/Hermes/memories', '<xdgdata>/Hermes/.env', '<xdgdata>/Hermes/state.db',
+            '<xdgdata>/Hermes/sessions',
+        ], [
+            '<home>/.hermes/config.yaml', '<home>/.hermes/SOUL.md', '<home>/.hermes/skills',
+            '<home>/.hermes/memories', '<home>/.hermes/.env', '<home>/.hermes/state.db',
+            '<home>/.hermes/sessions',
+        ], [
+            '<home>/.hermes/config.yaml', '<home>/.hermes/SOUL.md', '<home>/.hermes/skills',
+            '<home>/.hermes/memories', '<home>/.hermes/.env', '<home>/.hermes/state.db',
+            '<home>/.hermes/sessions',
+        ]),
+        envKeys: [{ key: 'HERMES_HOME', mode: 'replace', note: '整体替换数据目录' }],
+        autoRoots: true,
+        evidence: 'measured',
+        refs: '本仓本机实测 %LOCALAPPDATA%/Hermes（state.db 84 MiB / 88 会话 / 12324 条消息）；chat-import discovery.mjs:135 只给 ~/.hermes（差异见文件头 ①）',
+        dynamic: '会话在 state.db 的 sessions + messages 两表（只读 SQLite，列名变体自适应）；回退 sessions/*.jsonl（**只认 .jsonl**：真机同目录的 request_dump_*.json 是请求转储，不是会话）',
+    },
+    {
+        id: 'cursor',
+        defaults: all3('<home>/.cursor/mcp.json', '<home>/.cursor/rules', '<home>/.cursor/skills', '<home>/.cursorrules', '<home>/.cursor/projects'),
+        envKeys: [],
+        autoRoots: true,
+        evidence: 'fixture',
+        refs: 'chat-import discovery.mjs:111（~/.cursor/projects）；cursor.com/help/customization/{mcp,rules}.md；会话层对照 convert/cursor.mjs + cwd-map.mjs（**真机无 ~/.cursor，未经真机验证**）',
+        dynamic: '会话在 ~/.cursor/projects/<slug>/agent-transcripts/<composer-uuid>/<composer-uuid>.jsonl（逐行 {role, message:{content:[…]}}；首问包在 <user_query>/<timestamp> 里）；cwd 由 <slug> 的**存在性贪心解码**还原（解不出即 session-missing-cwd，绝不伪造；posix slug 未取证故不解码）；转录不含 tool_result → 只发 tool/call',
+    },
+    {
+        id: 'codex',
+        defaults: all3('<home>/.codex/config.toml', '<home>/.codex/AGENTS.override.md', '<home>/.codex/AGENTS.md', '<home>/.agents/skills', '<home>/.codex/sessions', '<home>/.codex/archived_sessions'),
+        envKeys: [{ key: 'CODEX_HOME', mode: 'replace' }],
+        autoRoots: true,
+        evidence: 'fixture',
+        refs: 'chat-import discovery.mjs:108-110（双根 sessions + archived_sessions）；夹具 src/foreign/fixtures/codex/',
+        dynamic: '会话在 <CODEX_HOME>/sessions/YYYY/MM/DD/rollout-*.jsonl 与 <CODEX_HOME>/archived_sessions/**',
+    },
+    {
+        id: 'copilot',
+        defaults: all3('<home>/.copilot/mcp-config.json', '<home>/.copilot/copilot-instructions.md', '<home>/.copilot/instructions', '<home>/.copilot/skills'),
+        envKeys: [{ key: 'COPILOT_HOME', mode: 'replace' }],
+        autoRoots: true,
+        evidence: 'documented',
+        refs: 'GitHub Copilot CLI 文档（v1 既有；不在 chat-import 的 FORMATS 内 = 我方额外来源）',
+    },
+    {
+        id: 'antigravity',
+        defaults: all3('<home>/.gemini/config/mcp_config.json', '<home>/.gemini/antigravity/mcp_config.json', '<home>/.gemini/antigravity/mcp_oauth_tokens.json', '<home>/.gemini/antigravity', '<home>/.gemini/antigravity-cli', '<home>/.gemini/antigravity-ide'),
+        envKeys: [],
+        autoRoots: true,
+        evidence: 'measured',
+        refs: 'chat-import discovery.mjs:113-121（三根并列 antigravity/-cli/-ide）；本仓本机实测 ~/.gemini/**（两个 mcp_config.json 都是 0 字节；会话在三根的 brain/<id>/.system_generated/logs/）',
+        dynamic: '会话在三根各自的 brain/<convId>/.system_generated/logs/{transcript.jsonl,overview.txt}（逐行 JSON 转录）；标题取 annotations/<id>.pbtxt；conversations/*.pb|.db 是 protobuf，**不读**',
+    },
+    /* =================== 会话类：JSONL / 目录源（档 B 补齐） =================== */
+    {
+        id: 'gemini',
+        defaults: all3('<home>/.gemini/history'),
+        envKeys: [],
+        autoRoots: true,
+        evidence: 'fixture',
+        refs: 'chat-import discovery.mjs:112 + :940-968；convert/gemini.mjs:21-30（**单对象 JSON，非 JSONL**）',
+        dynamic: '<slot>/chats/session-*.json（顶层 {sessionId,projectHash,startTime,directories[],messages[]}）',
+    },
+    {
+        id: 'reasonix',
+        defaults: perPlatform(['<home>/.reasonix/sessions', '<appdata>/reasonix'], ['<home>/.reasonix/sessions'], ['<home>/.reasonix/sessions']),
+        envKeys: [{ key: 'APPDATA', mode: 'append', platforms: ['win32'], note: 'Windows 桌面端第二根' }],
+        autoRoots: true,
+        evidence: 'fixture',
+        refs: 'chat-import discovery.mjs:99,122-124（桌面端根仅在 $APPDATA 存在时加入）',
+        dynamic: '<stem>.jsonl + 伴生 sidecar（新版 <stem>.jsonl.meta 的 topic_title/workspace_root/scope；旧版 <stem>.meta.json）与 WAL <stem>.events.jsonl（合并进会话）；桌面布局 projects/<slug>/sessions/** + .titles.json；sidecar 缺席时按 stem 内嵌时间兜底 createdAt；subagent-sub-* 剔除',
+    },
+    {
+        id: 'opencode',
+        defaults: all3('<home>/.local/share/opencode/opencode.db'),
+        envKeys: [],
+        autoRoots: true,
+        evidence: 'fixture',
+        refs: 'chat-import discovery.mjs:125 + sources/opencode.mjs:33-117（**Windows 同样 ~/.local/share**；read-claude-move 的 %APPDATA% 说法冲突 → 取 chat-import）',
+        dynamic: 'V1 表 session/message/part；V2 表 session_v2/session_message（按 PRAGMA 自适应）',
+    },
+    {
+        id: 'mimocode',
+        defaults: all3('<home>/.local/share/mimocode/mimocode.db'),
+        envKeys: [],
+        autoRoots: true,
+        evidence: 'fixture',
+        refs: 'chat-import discovery.mjs:126 + sources/mimocode.mjs（opencode fork，三表同构）',
+    },
+    {
+        id: 'zcode',
+        defaults: all3('<home>/.zcode/cli/db/db.sqlite'),
+        envKeys: [],
+        autoRoots: true,
+        evidence: 'fixture',
+        refs: 'chat-import discovery.mjs:131 + sources/zcode.mjs:27-30,37,65（session/message/part）',
+    },
+    {
+        id: 'grokbuild',
+        defaults: all3('<home>/.grok/sessions', '<home>/.grok/archived_sessions'),
+        envKeys: [{ key: 'GROK_HOME', mode: 'replace', note: '非空即替代 ~/.grok' }],
+        autoRoots: true,
+        evidence: 'fixture',
+        refs: 'chat-import discovery.mjs:101-103,132（**双根** sessions + archived_sessions）',
+        dynamic: '以「含 summary.json 的目录」递归识别（不再固定两层）；summary.json 取 info.id/info.cwd 与 generated_title|session_summary；chat_history.jsonl 按 {type,…} 解析并把顶层 tool_calls 与 type:"tool_result" 按 callId 配对；synthetic_reason 注入行不进正文',
+    },
+    {
+        id: 'openclaw',
+        defaults: all3('<home>/.openclaw/agents'),
+        envKeys: [],
+        autoRoots: true,
+        evidence: 'fixture',
+        refs: 'chat-import discovery.mjs:133 + convert/openclaw.mjs:3-19',
+        dynamic: 'agents/<agent>/sessions/*.jsonl + 同目录 sessions.json 索引（displayName）',
+    },
+    {
+        id: 'pi',
+        defaults: all3('<home>/.pi/agent/sessions'),
+        envKeys: [],
+        autoRoots: true,
+        evidence: 'fixture',
+        refs: 'chat-import discovery.mjs:134 + convert/pi.mjs:14-27（首行 session 头，其余 id/parentId 成树）',
+        dynamic: '--<cwd>--/<timestamp>_<uuid>.jsonl（目录名携带 cwd）',
+    },
+    {
+        id: 'kimi',
+        defaults: all3('<home>/.kimi/sessions', '<home>/.kimi/kimi.json', '<home>/.kimi-code/sessions', '<home>/.kimi-code/workspaces.json'),
+        envKeys: [],
+        autoRoots: true,
+        evidence: 'fixture',
+        refs: 'chat-import discovery.mjs:136 + convert/kimi.mjs:3-11（**双根两代布局**；旧目录名 = md5(workdir)，靠 kimi.json 反解）',
+        dynamic: '旧：<md5(workdir)>/<sid>/{wire.jsonl,context.jsonl,state.json}；新：<workspaceId>/<sid>/agents/main/wire.jsonl + state.json',
+    },
+    {
+        id: 'kilocode',
+        defaults: all3('<home>/.local/share/kilo/kilo.db'),
+        envKeys: [],
+        autoRoots: true,
+        evidence: 'fixture',
+        refs: 'chat-import discovery.mjs:130 + sources/kilocode.mjs:24,34,36,63,65',
+    },
+    {
+        id: 'qoder',
+        defaults: all3('<home>/.qoder/projects'),
+        envKeys: [],
+        autoRoots: true,
+        evidence: 'fixture',
+        refs: 'chat-import discovery.mjs:137 + convert/qoder.mjs:3-16（目录名 = cwd 的 /→- 编码）',
+        dynamic: '<encoded-project>/<sessionId>.jsonl（子代理在 <sessionId>/subagents/*.jsonl）',
+    },
+    {
+        id: 'chatgpt',
+        defaults: all3(),
+        envKeys: [],
+        autoRoots: false,
+        evidence: 'documented',
+        refs: 'chat-import discovery.mjs:164（defaultRoots.chatgpt = null）+ :1861 + convert/chatgpt.mjs:12-15',
+        dynamic: '**只能显式给路径**：本机自动探测永远为 0 命中（如实报 source-needs-explicit-path）',
+    },
+    {
+        id: 'workbuddy',
+        defaults: all3('<home>/.workbuddy/projects'),
+        envKeys: [],
+        autoRoots: true,
+        evidence: 'fixture',
+        refs: 'chat-import discovery.mjs:138 + convert/workbuddy.mjs:3-18（目录名 = cwd 哈希，**不可逆**）',
+        dynamic: '<project-hash>/<session-uuid>.jsonl（cwd 只能取记录字段；没有就如实跳过，绝不猜）',
+    },
+    {
+        id: 'qwen',
+        defaults: all3('<home>/.qwenworkcn/projects'),
+        envKeys: [],
+        autoRoots: true,
+        evidence: 'fixture',
+        refs: 'chat-import discovery.mjs:139 + convert/qwen.mjs:1-21（千问办公）',
+        dynamic: '<slug>/<session-uuid>.jsonl',
+    },
+    {
+        id: 'continue',
+        defaults: all3('<home>/.continue/sessions'),
+        envKeys: [{ key: 'CONTINUE_GLOBAL_DIR', mode: 'replace', note: '**整体替换**默认根（→ <dir>/sessions）' }],
+        autoRoots: true,
+        evidence: 'fixture',
+        refs: 'chat-import discovery.mjs:142-147（VS Code / JetBrains / CLI 共用同一份）',
+        dynamic: '<sessionId>.json（单对象）+ 同目录 sessions.json 索引',
+    },
+    {
+        id: 'cline',
+        defaults: all3('<home>/.cline/data/sessions', '<appdata>/Code/User/globalStorage/saoudrizwan.claude-dev', '<appdata>/Code - Insiders/User/globalStorage/saoudrizwan.claude-dev', '<appdata>/VSCodium/User/globalStorage/saoudrizwan.claude-dev'),
+        envKeys: [
+            { key: 'CLINE_SESSION_DATA_DIR', mode: 'replace' },
+            { key: 'CLINE_DATA_DIR', mode: 'replace', note: '→ <dir>/sessions' },
+            { key: 'CLINE_DIR', mode: 'replace', note: '→ <dir>/data/sessions' },
+            { key: 'CLINE_LEGACY_GLOBAL_STORAGE_DIR', mode: 'replace', note: '命中即**只返回该一个** legacy 根' },
+            { key: 'CLINE_VSCODE_GLOBAL_STORAGE_DIR', mode: 'replace', note: '同上（低优先级）' },
+        ],
+        autoRoots: true,
+        evidence: 'fixture',
+        refs: 'chat-import discovery.mjs:47-78,148-154 + :2094（legacy tasks/<id>/{api_conversation_history,ui_messages}.json）',
+        dynamic: '现代 <sessionId>/{<id>.json,<id>.messages.json,<id>.compaction.json}；legacy 三个 VS Code globalStorage',
+    },
+    {
+        id: 'goose',
+        defaults: perPlatform(['<appdata>/Block/goose/data/sessions/sessions.db'], ['<home>/Library/Application Support/Block/goose/sessions/sessions.db'], ['<home>/.local/share/goose/sessions/sessions.db']),
+        envKeys: [{ key: 'GOOSE_PATH_ROOT', mode: 'replace', absoluteOnly: true, note: '**仅绝对路径**生效 → <root>/data' }],
+        autoRoots: true,
+        evidence: 'fixture',
+        refs: 'read-vault §10.1 goose 行 + chat-import convert/goose.mjs:58-75/sources/goose.mjs:92-123（旧 sessions/*.jsonl 刻意不读）',
+        dynamic: '表 sessions{id,session_type,working_dir} + messages{session_id,content_json}',
+    },
+    {
+        id: 'dsh4',
+        defaults: all3('<home>/.dsh/sessions'),
+        envKeys: [{ key: 'DSH_HOME', mode: 'replace', note: '→ <home>/sessions' }],
+        autoRoots: true,
+        evidence: 'measured',
+        refs: 'chat-import discovery.mjs:165-169 + sources/dsh.mjs:8-25（dsh/dsh4 同根，按日志代次过滤：dsh4 = V4）',
+        dynamic: '<projectKey>/<session>/session.v4.jsonl.zstd（**逐字节直通**，不重新编码）',
+    },
+    {
+        id: 'zed',
+        defaults: perPlatform(['<xdgdata>/Zed/threads/threads.db'], ['<home>/Library/Application Support/Zed/threads/threads.db'], ['<xdgdata>/zed/threads/threads.db']),
+        envKeys: [{ key: 'XDG_DATA_HOME', mode: 'replace', absoluteOnly: true, platforms: ['linux'], note: '仅 linux 列生效' }],
+        autoRoots: true,
+        evidence: 'fixture',
+        refs: 'read-vault §10.1 zed 行 + chat-import convert/zed.mjs:63-84（win32 目录名**大写 Zed**；data BLOB 恒 zstd）',
+        dynamic: '单表 threads(id,summary,updated_at,data_type,data,parent_id,folder_paths,created_at)',
+    },
+    {
+        id: 'crush',
+        defaults: all3('<xdgdata>/crush/projects.json'),
+        envKeys: [
+            { key: 'CRUSH_GLOBAL_DATA', mode: 'replace', absoluteOnly: true },
+            { key: 'XDG_DATA_HOME', mode: 'replace', absoluteOnly: true, platforms: ['linux'] },
+        ],
+        autoRoots: true,
+        evidence: 'fixture',
+        refs: 'read-vault §10.1 crush 行 + chat-import convert/crush.mjs:54-76/sources/crush.mjs:43-76（**库在项目里**）',
+        dynamic: '用户级只放 projects.json；库 = <项目>/.crush/crush.db（每项目一个库，靠注册表 + 显式 projectDir 探测）',
+    },
+    {
+        id: 'teleagent',
+        defaults: all3('<home>/.local/share/TeleAgent/users'),
+        envKeys: [{ key: 'TELEAGENT_HOME', mode: 'replace', note: '→ <home>/users/<account>/teleagent.db' }],
+        autoRoots: true,
+        evidence: 'fixture',
+        refs: 'chat-import discovery.mjs:127-129,1211-1223 + sources/teleagent.mjs:23-42（**每账户一个库**）',
+        dynamic: 'users/<account>/teleagent.db（枚举账户目录；opencode 三表同构）',
+    },
+    {
+        id: 'trae',
+        defaults: all3('<appdata>/Trae/User', '<appdata>/Trae CN/User', '<appdata>/TRAE SOLO CN/User', '<appdata>/TRAE SOLO/User'),
+        envKeys: [{ key: 'XDG_CONFIG_HOME', mode: 'replace', absoluteOnly: true, platforms: ['linux'] }],
+        autoRoots: true,
+        evidence: 'fixture',
+        refs: 'read-vault §10.1 trae 行 + chat-import discovery.mjs:80-93,140,2386（**4 个发行版** × 三分支；$APPDATA 缺失即跳过）',
+        dynamic: '<User>/{workspaceStorage,globalStorage}/**/state.vscdb（SQLite ItemTable；键 memento/icube-ai-agent-storage + 4 回退键）',
+    },
+    {
+        id: 'vibe',
+        defaults: all3('<home>/.vibe/logs/session'),
+        envKeys: [{ key: 'VIBE_HOME', mode: 'append', note: '**追加**（不是替换）：env 根与 ~/.vibe 根并存' }],
+        autoRoots: true,
+        evidence: 'fixture',
+        refs: 'read-vault §10.1 vibe 行 + chat-import sources/vibe.mjs:37-49（**多根叠加**）',
+        dynamic: 'session_<ts>_<shortId>/{meta.json, messages.jsonl}',
+    },
+    {
+        id: 'dsh',
+        defaults: all3('<home>/.dsh/sessions'),
+        envKeys: [{ key: 'DSH_HOME', mode: 'replace', note: '→ <home>/sessions' }],
+        autoRoots: true,
+        evidence: 'measured',
+        refs: 'chat-import discovery.mjs:165-169 + sources/dsh.mjs:8-25（dsh = V3，含 v0–v3 代次）',
+        dynamic: '<projectKey>/<session>/session.jsonl.zstd（v0 无后缀；vN 带 .vN）；**逐字节直通**',
+    },
+];
+//# sourceMappingURL=truth-table.js.map

package/lib/foreign/types.d.ts

@@ -0,0 +1,272 @@
+/**
+ * 外部 agent 配置 → DSH bundle 的转换层（v1，2026-10-04）。
+ *
+ * 为什么单独一层，而不是再写一批 ConfigAdapter：
+ * `src/adapters/*` 的契约前提是「源机也是 DSH，只是 homeDir 不同」（读写都按 $DSH_HOME 布局、
+ * 路径可重定基）。第三方工具没有 $DSH_HOME、没有分区语义，硬套会污染 schema / section-registry /
+ * 版本契约 —— 所以本层的职责只有一件事：把外部格式**翻译成标准 bundle v1 的载荷**，
+ * 之后完全复用既有管道（Importer.analyzeImport → createImportPlan → executeImportPlan）：
+ * 冲突不默认覆盖、导入前强制快照、dry-run、逐条计划可见性全部自动生效。
+ *
+ * 本层必须自己守住的三条不变量：
+ *  ① **凭据值绝不进包**：外部配置里的 token/key（MCP 的 env/headers、settings.env）由
+ *     **导出侧同一个** defaultSecretScanner 剥离（命中字段值置空串），只保留字段名 + 一个引用名；
+ *     URL 里的 userinfo（https://user:pass@host）额外单独剥离（字段名扫描器看不到它）。
+ *  ② **不猜**：对不上的字段/格式一律进 skipped（带稳定机器码），绝不静默丢弃。
+ *  ③ **不产生用户可见字符串**：findings 只给机器码，文案由 UI 字典映射（i18n 铁律）。
+ */
+import type { SectionId } from '../schema/types.ts';
+import type { ParsedTranscript } from './session-source.ts';
+/**
+ * 外部来源 id（**契约冻结**，§8.1/§8.2，2026-10-04；档 B 全量补齐 2026-10-05）。
+ *
+ * 每个来源一个转换器 + 一个读盘层；id 是稳定机器标识（进 PlanItem 说明、CLI `--from`、宿主路由），
+ * **不随文案变化**。新增来源 = 向本 union 追加一个值（additive），既有值一字不改。
+ *
+ * 档 B（t6）一次补齐 dsh-chat-import 的 `FORMATS` 清单（`lib/discovery.mjs:33-39`，29 项）：
+ * 我方的 copilot 不在该清单内（额外来源），其余 29 项**逐项**对应到下面的 id
+ * （claude → claude-code、dsh/dsh4 → 同源两代次）。
+ *
+ * **取证强度逐来源如实标注**（见 registry.ts 的 ForeignSource.evidence 与
+ * docs/design/2026-10-04-foreign-import-v1.md §8.2 的真值表）：
+ *  - measured ：本机实测（目录/库确实存在过，且读盘层据此实现）
+ *  - fixture  ：真机未验证，但有**可复现取证方式**（夹具 + 单测端到端跑同一份布局）
+ *  - documented：只有四份调研报告的落点（尚未有可复现夹具时**必须**是这个值）
+ *  任何来源都**不得**在未取证的情况下被标成 measured —— 该字段由
+ *  `truth-table.test.ts` 与各来源单测共同钉住。
+ */
+export type ForeignSourceId = 'claude-code' | 'hermes' | 'cursor' | 'codex' | 'copilot' | 'antigravity' | 'gemini' | 'reasonix' | 'opencode' | 'mimocode' | 'zcode' | 'grokbuild' | 'openclaw' | 'pi' | 'kimi' | 'kilocode' | 'qoder' | 'chatgpt' | 'workbuddy' | 'qwen' | 'continue' | 'cline' | 'goose' | 'dsh4' | 'zed' | 'crush' | 'teleagent' | 'trae' | 'vibe' | 'dsh';
+/**
+ * 取证强度（**如实标注，不可美化**）。
+ *
+ * 为什么要有这个**类型化**字段：t5 的结论是 cursor / codex 长期处于「文档取证但被列出来」
+ * 的状态，而没有任何地方在界面上说明这件事 —— 用户以为「已支持 = 已验证」。
+ * 把它变成来源定义的必填字段后，「未验证却列出」在类型层就不可能悄悄发生：
+ * 新增来源必须显式回答「我凭什么」，答案落在真值表里并出现在 CLI 摘要里。
+ */
+export type ForeignEvidenceKind = 
+/** 本机实测：真机上确实存在过该布局/库，读盘层据此实现 */
+'measured'
+/** 有可复现取证方式：夹具 + 单测端到端跑同一份布局（真机未验证） */
+ | 'fixture'
+/** 只有调研报告的落点（真机与夹具都还没有） */
+ | 'documented';
+/** 未能迁移的外部内容（响亮失败：宁可在计划里报出来，也不静默丢） */
+export interface ForeignSkip {
+    /** 稳定机器码（UI 用它映射文案；禁止渲染裸枚举） */
+    code: ForeignSkipCode;
+    /** 外部侧位置（server 名 / skill 名 / 文件名；**不含任何值**） */
+    origin?: string;
+    /** 机器可读的细分原因（如 no-frontmatter / yaml-error），同样交给 UI 映射 */
+    detail?: string;
+    /** 同码聚合时的条数 */
+    count?: number;
+}
+export type ForeignSkipCode = 
+/** settings.json 的 hooks：DSH 无对等结构 */
+'unsupported-hooks'
+/** commands/*.md（斜杠命令）：与 DSH prompts 不是同一语义，本期不搬 */
+ | 'unsupported-commands'
+/** settings.json 的 env 里出现凭据名：只计数与记名，**值不读** */
+ | 'credentials-not-migrated'
+/** SKILL.md 缺失 */
+ | 'skill-missing-file'
+/** frontmatter 不是合法 YAML / 缺 name|description（DSH 会**静默丢弃**该 skill，这里必须报） */
+ | 'skill-invalid-frontmatter'
+/** 目录名/文件相对路径非法（含分隔符、.. 等），无法作为 skill 单元 */
+ | 'skill-invalid-name'
+/** MCP 条目既无 command 也无 url */
+ | 'mcp-server-empty'
+/** MCP type=sse（DSH 只支持 stdio / streamable-http）→ 按带 url 的 http 处理 */
+ | 'mcp-type-sse-coerced'
+/** MCP 值里发现凭据字段（值已丢弃，只留字段名与引用名） */
+ | 'mcp-credential-redacted'
+/** 外部文件读不到 / 超限 / 解析失败 */
+ | 'source-unreadable'
+/** 会话：目标机未提供 DSH 会话格式版本（不猜版本，宁可整批不转） */
+ | 'session-format-version-unknown'
+/** 会话：目标机格式版本不是本模块已实现的行式 */
+ | 'session-format-unsupported'
+/** 会话：记录里没有 cwd（DSH 要求「日志位置 == projectKey(cwd)/id」，没有 cwd 无法归位） */
+ | 'session-missing-cwd'
+/** 会话：文件名不能自证是安全路径段 */
+ | 'session-unsafe-id'
+/** 会话：没有任何可迁移的事件 */
+ | 'session-empty'
+/** 会话：存在解析不出来的行 */
+ | 'session-unparsable'
+/** 会话：某类 Claude 记录本期不迁移（sidechain / attachment / queue-operation / system …） */
+ | 'unsupported-session-record'
+/** 同 id 会话（包内重复 / 目标机已存在，含「另一 projectKey 下同 id」）：**不覆盖、跳过并报码**（用户决策，§8.4） */
+ | 'session-id-conflict'
+/** 外部技能重名（压平分类后同名，或两次来源同名）：先到先得，其余跳过并报码（§8.4） */
+ | 'skill-id-conflict'
+/** 该来源的对话存储形态本版不迁移（如 Hermes 的 SQLite state.db）：只报告，绝不产出 sessions 分区 */
+ | 'sessions-not-migrated'
+/** 记忆文件只报告不导入（如 Hermes memories/MEMORY.md、USER.md）：用户决策，正文绝不进包 */
+ | 'memory-report-only'
+/** 外部技能带分类层级（如 Hermes skills/<分类>/<技能>）：压平为 DSH 单层 <技能>/SKILL.md 并报码 */
+ | 'skill-category-flattened'
+/** 旧式规则文件（如 .cursorrules）：DSH 无对等结构，只报告 */
+ | 'legacy-rules-file'
+/** 多份指令源被合并为单个 AGENTS.md（DSH 只读一个全局指令文件）：如实报告合并来源数 */
+ | 'instructions-merged'
+/** 命中更高优先级的指令文件（如 Codex 的 AGENTS.override.md 优先于 AGENTS.md）：报告被选中的那一个 */
+ | 'instructions-override-selected'
+/** 配置文件存在但为 0 字节（如实测的 Antigravity mcp_config.json）：报码，绝不产出空分区 */
+ | 'source-empty-file'
+/** 配置目录位置被环境变量/命令行覆盖（CLAUDE_CONFIG_DIR / HERMES_HOME / CODEX_HOME / COPILOT_HOME） */
+ | 'source-location-overridden'
+/**
+ * 会话 cwd 由**源侧路径/编码目录名推导**（记录里没有 cwd 字段），且推导结果在本机**真实存在**
+ * —— 才允许落盘（存在性检查把「猜」变成「有证据的推断」）；不存在的推导一律按
+ * `session-missing-cwd` 跳过，绝不产出一条指向不存在目录的会话。
+ */
+ | 'session-cwd-derived'
+/**
+ * 该来源**没有自动根**（竞品 `defaultRoots.chatgpt = null`）—— 必须由用户显式给出导出文件
+ * 路径；本机自动探测永远不会命中，如实报码而不是假装「未安装」。
+ */
+ | 'source-needs-explicit-path';
+/**
+ * 冲突语义（**契约冻结**，§8.4）：同 id 会话恒「不覆盖、跳过并报码」。
+ *
+ * 该 union 只有一个取值是刻意的 —— 语义上**不存在覆盖分支**：外部来源导入不得打开
+ * `resolution: 'useImported'` / 全局 `replace` 策略这两条会写目标机既有会话的通道。
+ * 目标机已存在同 id 时，既有管道判为 `Conflict`（未决策 → 执行期不写），并在计划里可见。
+ */
+export type ForeignConflictPolicy = 'skip-no-overwrite';
+/** 一个分区的翻译结果：JSON 类给 data，文件类给 files */
+export interface ForeignSectionOut {
+    sectionId: SectionId;
+    data?: unknown;
+    files?: {
+        relativePath: string;
+        data: Uint8Array;
+    }[];
+}
+/** 一个外部 skill 单元：目录名 + 目录内文件（相对该目录） */
+export interface ClaudeSkillInput {
+    name: string;
+    files: {
+        relativePath: string;
+        data: Uint8Array;
+    }[];
+}
+/** Claude Code 用户目录的已读形态（纯数据；翻译层不做任何 fs 访问） */
+export interface ClaudeCodeInput {
+    /** ~/.claude.json（已解析；缺失或解析失败 = undefined） */
+    claudeJson?: unknown;
+    /** ~/.claude/settings.json（已解析） */
+    settings?: unknown;
+    /** ~/.claude/skills/* 的单元（frontmatter 校验在翻译层做） */
+    skills?: ClaudeSkillInput[];
+    /** ~/.claude/CLAUDE.md 原文（全局指令） */
+    memory?: string;
+    /** ~/.claude/commands/* 的普通文件数（本期只报不搬） */
+    commandCount?: number;
+    /** ~/.claude/projects/<项目>/<uuid>.jsonl 的原文（转码在翻译层做） */
+    sessions?: ClaudeSessionInput[];
+    /**
+     * 目标机 DSH 的 SESSION_FORMAT_VERSION（**必须由宿主解析后传入**，见 utils/session-format.ts）。
+     * 缺省 = 不转码任何会话并逐条报 session-format-version-unknown，绝不猜版本。
+     */
+    targetSessionFormatVersion?: number;
+}
+/** 一个待转码的 Claude Code 会话文件 */
+export interface ClaudeSessionInput {
+    /** 文件名（不含 .jsonl）；同时作为 DSH 侧会话 id */
+    id: string;
+    text: string;
+}
+/** 一个 Hermes skill 单元：**已压平**的叶子技能名 + 目录内文件（category 只用于报告，不参与命名） */
+export interface HermesSkillInput {
+    name: string;
+    files: {
+        relativePath: string;
+        data: Uint8Array;
+    }[];
+    /** 外部侧分类目录名（skills/<分类>/<技能>）——有值即报 skill-category-flattened */
+    category?: string;
+}
+/**
+ * 一个已读成**归一记录**的 Hermes 会话（读盘层产出；翻译层只负责装配）。
+ *
+ * 与 Claude 的 `ClaudeSessionInput`（原文进、翻译层再解析）刻意不同：Hermes 的会话在
+ * SQLite（state.db）里，解析**必须**发生在宿主侧的读盘层 —— 那是 `node:sqlite` 动态 import
+ * 的唯一边界（见 read-opencode.ts 文件头纪律 ①）。因此在读盘层就已经归一成型，
+ * 翻译层保持纯函数、零 fs、零 sqlite。
+ */
+export interface HermesSessionInput {
+    /** 会话 id（state.db 的 sessions.id；同时作为 DSH 侧会话 id） */
+    id: string;
+    /** 归一记录（读盘层已解析；parsed.raw = 消息行原始条数） */
+    parsed: ParsedTranscript;
+}
+/**
+ * Hermes 用户目录的已读形态（纯数据；翻译层不做任何 fs 访问）。
+ *
+ * 三条**结构性**保证（不是靠翻译层自觉）：
+ *  - memories/MEMORY.md、USER.md 的**正文根本不在本结构里**（只有文件名）→ 无从进包；
+ *  - .env 只有「存在与否」一个布尔 → 值无从进包；
+ *  - 会话只以**已归一记录**进本结构（原始 SQLite 行与库文件都留在宿主侧）。
+ */
+export interface HermesInput {
+    /** config.yaml（已解析；缺失 / 解析失败 / 0 字节 = undefined） */
+    config?: unknown;
+    /** skills/** 的单元（frontmatter 校验在翻译层做） */
+    skills?: HermesSkillInput[];
+    /** SOUL.md 原文（主身份 → agentInstructions） */
+    soul?: string;
+    /** memories/ 下的记忆文件名（**只报告不导入**） */
+    memoryFiles?: string[];
+    /** .env 是否存在（**只报告**；值绝不读） */
+    dotEnvPresent?: boolean;
+    /** 会话存储痕迹（state.db / sessions/）：**读不出来**时在这里如实报，绝不静默 */
+    sessionStore?: {
+        present: boolean;
+        detail?: string;
+    };
+    /** state.db（SQLite）里读出的会话（已归一记录；库读不到时回退 sessions/*.jsonl） */
+    sessions?: HermesSessionInput[];
+    /**
+     * 目标机 DSH 的 SESSION_FORMAT_VERSION（**必须由宿主解析后传入**，见 utils/session-format.ts）。
+     * 缺省 = 不转码任何会话并逐条报 session-format-version-unknown，绝不猜版本。
+     */
+    targetSessionFormatVersion?: number;
+    /** 读盘层发现的问题（0 字节 / 位置被覆盖 / 读不到）——由翻译层原样带出，调用方无需二次合并 */
+    readFindings?: ForeignSkip[];
+}
+/**
+ * 可选上限覆盖（t36）：宿主路由 / CLI **将来**放开上限时的**唯一通道**。
+ *
+ * 语义：缺省（不传）= 各来源读盘层的默认值**逐字不变**；只有显式给了某个键才覆盖它。
+ * 字段 = 各读盘层**已经存在**的可选上限（不新造语义）；装配层把上下文的 limits 原样透传进读器。
+ */
+export interface ForeignLimitOverrides {
+    /** 单文件读取上限（字节；超过即不读并报 source-unreadable/too-large） */
+    readonly maxFileBytes?: number;
+    /** 单个技能目录的文件数上限（超过即报 source-unreadable/max-skill-files-reached） */
+    readonly maxSkillFiles?: number;
+    /** 技能数上限（超过即报 source-unreadable/max-skills-reached） */
+    readonly maxSkills?: number;
+    /** instructions/*.instructions.md 的文件数上限（Copilot 专用） */
+    readonly maxInstructionFiles?: number;
+    /** 会话条数上限（超过即报 max-sessions-reached） */
+    readonly maxSessionFiles?: number;
+    /** 目录走盘的文件数上限（reasonix / trae 的会话遍历） */
+    readonly maxFiles?: number;
+    /** 单会话节点数上限（chatgpt / trae；超过即逐类计数） */
+    readonly maxNodes?: number;
+}
+export interface ForeignImportResult {
+    source: ForeignSourceId;
+    sections: ForeignSectionOut[];
+    skipped: ForeignSkip[];
+    /**
+     * 发现但**未搬运**的凭据引用名（形如 mcp:gitnexus:GITHUB_TOKEN / settings.env:ANTHROPIC_AUTH_TOKEN）。
+     * **只有名字，没有任何值** —— 导入后由用户在 DSH 里补录。
+     */
+    credentialRefs: string[];
+    counts: Record<string, number>;
+}

package/lib/foreign/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/foreign/vibe.d.ts

@@ -0,0 +1,6 @@
+import type { SessionSourceWiring } from './session-source.ts';
+import type { VibeSessionFile } from './read-vibe.ts';
+import type { ForeignSource } from './registry.ts';
+export declare const vibeWiring: SessionSourceWiring<VibeSessionFile>;
+export declare function createVibeSource(): ForeignSource;
+export declare const vibeSource: ForeignSource;

package/lib/foreign/vibe.js

@@ -0,0 +1,23 @@
+/**
+ * Vibe 来源的翻译层（wiring + draftOf）。
+ *
+ * evidence 与 truth-table.ts 的 vibe 行一致（fixture：单测按同一份布局建夹具端到端跑；真机无 ~/.vibe）。
+ * 会话目录由「目录里有 messages.jsonl」自证并**递归**收集（不再只认 session_ 前缀、不只扫一层）；
+ * cwd 取 meta.environment.working_directory / origin_directory。probeEnvKeys 只登记
+ * **VIBE_HOME**（真正的来源位置覆盖）；report 期只回键名，绝不回值。
+ */
+import { draftFromTranscript, sessionSourceOf } from './session-source.js';
+import { readVibe, vibeSessionRoots } from './read-vibe.js';
+export const vibeWiring = {
+    id: 'vibe',
+    evidence: 'fixture',
+    probePaths: (opts) => vibeSessionRoots(opts),
+    probeEnvKeys: ['VIBE_HOME'],
+    read: (opts) => readVibe(opts),
+    draftOf: (file) => draftFromTranscript(file.id, file, 'vibe'),
+};
+export function createVibeSource() {
+    return sessionSourceOf(vibeWiring);
+}
+export const vibeSource = createVibeSource();
+//# sourceMappingURL=vibe.js.map

package/lib/foreign/workbuddy.d.ts

@@ -0,0 +1,7 @@
+import type { ForeignSource } from './registry.ts';
+/** 写进 DSH request/header 的 provider 名 */
+export declare const WORKBUDDY_PROVIDER = "workbuddy";
+/** 装配 WorkBuddy 来源（每次调用返回一份新定义；注册动作由 registrar 统一做） */
+export declare function createWorkbuddySource(): ForeignSource;
+/** 同一份定义的实例（宿主路由 / 单测可直接用） */
+export declare const workbuddySource: ForeignSource;