@carljia/omd-dsh 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Carl Jia
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,72 @@
+# @carljia/omd-dsh
+
+OMD 理念的 DSH 插件：两个 cordis 行 + 7 个模式 preset + 同步 CLI。总览、模式矩阵与安装见仓库根 [README.md](../../README.md)。
+
+## 行：omd-mode
+
+按模式（agent preset）固定模型路由。仅限 preset 作用域内挂载（无作用域挂载直接报错）。
+
+| 配置字段 | 含义 |
+|---|---|
+| mode | 模式标识（横幅/诊断语义；不影响路由），必填 |
+| provider | 该模式的 provider；与 model 同时缺省时不固定路由（透传） |
+| model | 该模式的模型；与 provider 同时缺省时不固定路由（透传） |
+| reasoningEffort | 可选推理强度；缺省时清除继承值，交由 provider 默认 |
+
+机制：监听 system-prompt/assemble（注入 {{provider}}/{{model}} 提示词变量）与 agent/request（next() 后覆盖路由），两处均 prepend，保证覆盖入口的会话级选择。
+
+模型体验：persona 文本每次请求固定携带该模式模型声明；模式模型路由在 agent 生命周期内稳定（KV 前缀稳定）。
+
+## 行：omd-task
+
+tier 差异化子代理委派（等价 OMD 的 task(category=…)）。仅限 preset 作用域内挂载。
+
+| 配置字段 | 默认 | 含义 |
+|---|---|---|
+| provider | spawn | 子代理提供方 |
+| toolName | omd_task | 模型可见工具名（同 preset 内唯一） |
+| backgroundMode | continuable | continuable（默认后台，run_in_background:false 转前台）或 foreground |
+| tiers | 必填 | tier 名 → { provider(必), model(必), hint?, persona?, toolFilter?: {allow?, deny?}, maxTokens? }；tier 名匹配 [a-z0-9][a-z0-9_-]* |
+| defaultTier | 无 | 模型未传 tier 时的默认档（单 tier 时自动） |
+| maxDepth | 3 | 委派深度上限；provider-managed 表示交提供方 |
+
+模型可见参数：description（展示名）、prompt、tier（枚举见工具描述）、run_in_background（仅 continuable 模式）。工具描述枚举各 tier 的 hint 与模型，模型据此选型。
+
+## CLI：omd-dsh
+
+```
+omd-dsh <command> [--harness <路径>] [--dry-run]
+```
+
+- `omd-dsh sync` — 把 presets/ 与 vendored 行模块同步到 `<DSH_HOME>/.agent-presets/`（hash 保护、orphan 报告、非管理目录零操作）。每个 preset 的 omd-mode / omd-task 行由 `omd-matrix.json` 渲染。
+- `omd-dsh setup` — 交互式向导：先读取 DSH 已有模型，再引导逐模式/逐 tier 选择模型，写回 `omd-matrix.json` 并可选立即同步。
+- `omd-dsh models` — 打印发现的 DSH 模型目录（非交互）。
+
+细节见 docs/ARCHITECTURE.md 的「vendored 分发与跨树符号风险」。
+
+## 集中配置：omd-matrix.json
+
+所有模式的模型路由（provider/model/reasoningEffort）与 omd_task 各 tier 的模型集中在一个 `omd-matrix.json` 里：`omd-dsh setup` 生成/更新它，`omd-dsh sync` 读取它并渲染进各 preset。preset 里 `# [omd-dsh:mode:start] / [omd-dsh:mode:end]` 与 `# [omd-dsh:task:start] / [omd-dsh:task:end]` 之间的区域是自动生成的——改模型请改矩阵后跑 sync，不要手改 fence 之间的内容。
+
+## 开发
+
+```bash
+npm install     # 触发 build（tsc + postbuild）
+npm test        # vitest，39 个测试
+npm pack        # prepack 自动重建，产出 tgz
+```
+
+测试桩在 test/stubs/（dsh-scope/dsh-tools/dsh-subagent 的轻量替身），不依赖真实 harness。
+
+
+### 子代理透传语义
+
+omd-mode 对 subagentDepth > 0 的子代理一律透传（不覆盖 provider/model/变量）：
+omd-task 的 tier 模型通过显式 agentOptions 生效；顶层 agent 才被钉到模式模型。
+这保证「强模型顶层 + tier 差异化子代理」的优先级正确。
+
+### toolFilter 注意
+
+tiers 里的 toolFilter.deny/allow 只能点名该 preset 工具层中真实存在的工具名，
+否则子代理创建会被 DSH 以工具层错误拒绝。只读模式的 tiers 建议不配 toolFilter。
+

package/lib/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/lib/cli.js

@@ -0,0 +1,522 @@
+#!/usr/bin/env node
+import { promises as fs, existsSync, realpathSync, readFileSync, writeFileSync } from "node:fs";
+import { createHash } from "node:crypto";
+import { dirname, join, relative, resolve, basename } from "node:path";
+import { homedir } from "node:os";
+import { execFileSync } from "node:child_process";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { createInterface } from "node:readline/promises";
+/**
+ * omd-dsh CLI
+ *
+ *   omd-dsh sync    materialize presets into <DSH_HOME>/.agent-presets,
+ *                   rendering each preset's omd-mode / omd-task rows from
+ *                   omd-matrix.json (the single source for model routing and
+ *                   tier delegation).
+ *   omd-dsh setup   interactive wizard: discover the models DSH already has,
+ *                   then guide per-mode and per-tier model selection.
+ *   omd-dsh models  print the discovered model catalog (non-interactive).
+ *
+ * Distribution model (vendored + harness-anchored imports) is unchanged from
+ * the original omd-dsh sync: presets/omd-* are copied into .agent-presets/;
+ * their omd-mode/omd-task rows reference ../.omd-vendor/omd-mode.mjs /
+ * omd-task.mjs by relative path; the vendored modules are copied into
+ * .agent-presets/.omd-vendor/ with bare @deepseek-ai/* imports rewritten to
+ * absolute file:// URLs into the harness node_modules tree.
+ */
+const PACKAGE_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+const VENDOR_SOURCES = ["omd-mode.mjs", "omd-task.mjs"];
+const MATRIX_PATH = join(PACKAGE_ROOT, "omd-matrix.json");
+const MODE_FENCE = { start: "# [omd-dsh:mode:start]", end: "# [omd-dsh:mode:end]" };
+const TASK_FENCE = { start: "# [omd-dsh:task:start]", end: "# [omd-dsh:task:end]" };
+function usage() {
+    return [
+        "omd-dsh <command> [options]",
+        "  commands:",
+        "    sync     materialize presets into <DSH_HOME>/.agent-presets (renders omd-mode/omd-task from omd-matrix.json)",
+        "    setup    interactive: discover DSH models, then guide per-mode/tier model selection",
+        "    models   print the discovered DSH model catalog",
+        "  options:",
+        "    --harness <path>  node_modules dir of the DSH harness install (auto-detected via the dsh executable)",
+        "    --dry-run         (sync) print planned writes without touching the filesystem",
+        "    --verbose         (sync) print per-file detail",
+    ].join("\n");
+}
+function sha256(text) { return createHash("sha256").update(text).digest("hex"); }
+function dshHome() { return process.env.DSH_HOME !== undefined && process.env.DSH_HOME !== "" ? resolve(process.env.DSH_HOME) : join(homedir(), ".dsh"); }
+function findNodeModules(start) {
+    let current = resolve(start);
+    for (;;) {
+        if (basename(current) === "node_modules")
+            return current;
+        const parent = dirname(current);
+        if (parent === current)
+            return undefined;
+        current = parent;
+    }
+}
+function locateHarnessViaDsh() {
+    const candidates = [];
+    try {
+        const probe = process.platform === "win32" ? "where.exe" : "which";
+        const out = execFileSync(probe, ["dsh"], { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] });
+        for (const line of out.split(/\r?\n/)) {
+            const t = line.trim();
+            if (t !== "")
+                candidates.push(t);
+        }
+    }
+    catch { /* dsh not on PATH */ }
+    for (const candidate of candidates) {
+        let real = candidate;
+        try {
+            real = realpathSync(candidate);
+        }
+        catch { /* keep */ }
+        const nm = findNodeModules(real);
+        if (nm !== undefined && existsSync(join(nm, "@deepseek-ai", "dsh-scope", "package.json")))
+            return nm;
+    }
+    return undefined;
+}
+function resolveHarnessModule(harnessNodeModules, specifier) {
+    const segments = specifier.split("/");
+    const scope = segments[0].startsWith("@") ? segments[0] + "/" + segments[1] : segments[0];
+    const subpath = scope === specifier ? "" : specifier.slice(scope.length + 1);
+    const pkgDir = join(harnessNodeModules, ...scope.split("/"));
+    const manifestPath = join(pkgDir, "package.json");
+    if (!existsSync(manifestPath))
+        throw new Error("omd-dsh: cannot resolve \"" + specifier + "\" -- no package.json at " + manifestPath);
+    const manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
+    let entry;
+    const exportsMap = manifest.exports;
+    if (subpath === "" && exportsMap !== undefined && exportsMap["."] !== undefined) {
+        const dot = exportsMap["."];
+        if (typeof dot === "string")
+            entry = dot;
+        else if (typeof dot === "object" && dot !== null) {
+            entry = dot.node ?? dot.import ?? dot.default;
+            if (typeof entry === "object" && entry !== null)
+                entry = entry.node ?? entry.import ?? entry.default;
+        }
+    }
+    if (entry === undefined && subpath === "")
+        entry = manifest.module ?? manifest.main;
+    if (entry === undefined)
+        entry = subpath === "" ? "index.js" : subpath;
+    else if (subpath !== "")
+        entry = join(entry, subpath);
+    let resolvedPath = resolve(pkgDir, entry);
+    try {
+        resolvedPath = realpathSync(resolvedPath);
+    }
+    catch { /* keep */ }
+    if (!existsSync(resolvedPath))
+        throw new Error("omd-dsh: resolved entry \"" + entry + "\" for \"" + specifier + "\" does not exist at " + resolvedPath);
+    return pathToFileURL(resolvedPath).href;
+}
+function rewriteImports(sourceText, harnessNodeModules) {
+    const specifierPattern = /@deepseek-ai\/[A-Za-z0-9@._/-]+/g;
+    return sourceText.split(/\r?\n/).map((line) => {
+        if (!line.trimStart().startsWith("import"))
+            return line;
+        return line.replace(specifierPattern, (s) => resolveHarnessModule(harnessNodeModules, s));
+    }).join("\n");
+}
+function readMeta(dir) {
+    const metaPath = join(dir, ".omd-meta.json");
+    if (!existsSync(metaPath))
+        return undefined;
+    try {
+        const p = JSON.parse(readFileSync(metaPath, "utf8"));
+        if (p !== null && typeof p === "object" && p.files !== null && typeof p.files === "object")
+            return p;
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function collectSourceFiles(rootDir) {
+    const out = [];
+    const walk = async (dir) => {
+        for (const entry of await fs.readdir(dir, { withFileTypes: true })) {
+            const full = join(dir, entry.name);
+            if (entry.isDirectory())
+                await walk(full);
+            else
+                out.push(full);
+        }
+    };
+    await walk(rootDir);
+    return out;
+}
+// ── matrix ──
+function loadMatrix() {
+    if (!existsSync(MATRIX_PATH))
+        throw new Error("omd-dsh: missing " + MATRIX_PATH + " (run `omd-dsh setup` to create it, or restore it from source control)");
+    const parsed = JSON.parse(readFileSync(MATRIX_PATH, "utf8"));
+    if (parsed === null || typeof parsed !== "object" || parsed.modes === null || typeof parsed.modes !== "object")
+        throw new Error("omd-dsh: malformed " + MATRIX_PATH);
+    return parsed;
+}
+function saveMatrix(m) { writeFileSync(MATRIX_PATH, JSON.stringify(m, null, 2) + "\n", "utf8"); }
+// ── row rendering (relative indents; the splice prepends the fence indent) ──
+function q(s) { return JSON.stringify(s); }
+function renderModeRow(modeId, cfg) {
+    const out = ["- id: omd-mode", "  name: '../.omd-vendor/omd-mode.mjs'", "  config:", "    mode: " + modeId];
+    if (cfg.provider !== undefined)
+        out.push("    provider: " + cfg.provider);
+    if (cfg.model !== undefined)
+        out.push("    model: " + cfg.model);
+    if (cfg.reasoningEffort !== undefined)
+        out.push("    reasoningEffort: " + cfg.reasoningEffort);
+    return out;
+}
+function renderToolFilter(tf) {
+    const deny = tf.deny ?? [];
+    const allow = tf.allow ?? [];
+    const out = [];
+    if (tf.denyShell === true) {
+        const arr = (names) => "[" + names.map((n) => "'" + n + "'").join(", ") + "]";
+        const expr = "(process.platform === 'win32') ? " + arr([...deny, "pwsh"]) + " : " + arr([...deny, "bash"]);
+        out.push("toolFilter:", "  deny: !!js " + q(expr));
+    }
+    else {
+        if (allow.length > 0)
+            out.push("toolFilter:", "  allow: [" + allow.join(", ") + "]");
+        if (deny.length > 0) {
+            if (out.length === 0)
+                out.push("toolFilter:");
+            out.push("  deny: [" + deny.join(", ") + "]");
+        }
+    }
+    return out;
+}
+function renderTaskRow(cfg) {
+    const tiers = cfg.tiers ?? {};
+    if (Object.keys(tiers).length === 0)
+        return [];
+    const out = ["- id: omd-task", "  name: '../.omd-vendor/omd-task.mjs'", "  config:", "    provider: spawn", "    toolName: omd_task", "    backgroundMode: continuable", "    tiers:"];
+    for (const [name, t] of Object.entries(tiers)) {
+        out.push("      " + name + ":");
+        out.push("        provider: " + t.provider);
+        out.push("        model: " + t.model);
+        if (t.hint !== undefined)
+            out.push("        hint: " + q(t.hint));
+        if (t.persona !== undefined)
+            out.push("        persona: " + q(t.persona));
+        if (t.maxTokens !== undefined)
+            out.push("        maxTokens: " + t.maxTokens);
+        if (t.toolFilter !== undefined)
+            for (const l of renderToolFilter(t.toolFilter))
+                out.push("        " + l);
+    }
+    return out;
+}
+function spliceFence(lines, fence, rendered) {
+    const start = lines.findIndex((l) => l.trim() === fence.start);
+    const end = lines.findIndex((l) => l.trim() === fence.end);
+    if (start === -1 || end === -1 || end < start)
+        throw new Error("omd-dsh: preset is missing the " + fence.start + " / " + fence.end + " markers; regenerate the preset from source");
+    const indent = (lines[start].match(/^ */) || [""])[0];
+    const renderedIndented = rendered.map((l) => indent + l);
+    lines.splice(start, end - start + 1, indent + fence.start, ...renderedIndented, indent + fence.end);
+}
+function applyMatrix(text, modeId, cfg) {
+    const lines = text.split("\n");
+    spliceFence(lines, MODE_FENCE, renderModeRow(modeId, cfg));
+    const taskRendered = renderTaskRow(cfg);
+    const hasTaskFence = lines.some((l) => l.trim() === TASK_FENCE.start);
+    if (taskRendered.length > 0 && !hasTaskFence) {
+        throw new Error("omd-dsh: mode \"" + modeId + "\" has tiers in omd-matrix.json but its preset is missing the task fence");
+    }
+    if (hasTaskFence)
+        spliceFence(lines, TASK_FENCE, taskRendered);
+    return lines.join("\n");
+}
+// ── model discovery ──
+function discoverModels() {
+    const models = [];
+    const seen = new Set();
+    const add = (provider, model) => { if (model && !seen.has(provider + "/" + model)) {
+        seen.add(provider + "/" + model);
+        models.push({ provider, model });
+    } };
+    // DSH official DeepSeek defaults (dsh-llm-deepseek)
+    add("deepseek-official", "deepseek-v4-flash");
+    add("deepseek-official", "deepseek-v4-pro");
+    add("deepseek-official", "deepseek-v4-flash-vision-exp");
+    // best-effort: scan settings.yaml for additional model ids
+    const settingsPath = join(dshHome(), "settings.yaml");
+    let currentDefault;
+    if (existsSync(settingsPath)) {
+        const text = readFileSync(settingsPath, "utf8");
+        const blocklist = new Set(["spawn", "fork", "continuable", "foreground", "deepseek-official", "openai-completions", "anthropic-messages", "enabled", "disabled", "high", "low", "max"]);
+        for (const m of text.matchAll(/(?<![-A-Za-z0-9])model:\s*['"]?([A-Za-z0-9][A-Za-z0-9._/-]*)/g)) {
+            const id = m[1];
+            if (!blocklist.has(id) && /[0-9]/.test(id))
+                add("deepseek-official", id);
+        }
+        for (const m of text.matchAll(/^\s*-\s+id:\s*['"]?([A-Za-z0-9][A-Za-z0-9._/-]*)/gm)) {
+            const id = m[1];
+            if (!blocklist.has(id) && /[0-9]/.test(id))
+                add("deepseek-official", id);
+        }
+        const dm = text.match(/agent-default-model:\s*\n\s*provider:\s*['"]?([A-Za-z0-9._/-]+)['"]?\s*\n\s*model:\s*['"]?([A-Za-z0-9._/-]+)['"]?/);
+        if (dm)
+            currentDefault = { provider: dm[1], model: dm[2] };
+    }
+    return { models, currentDefault };
+}
+// ── sync ──
+async function runSync(flags, harnessNodeModules) {
+    const matrix = loadMatrix();
+    const manifest = JSON.parse(readFileSync(join(PACKAGE_ROOT, "package.json"), "utf8"));
+    const sourceVersion = manifest.version;
+    const presetsSourceDir = join(PACKAGE_ROOT, "presets");
+    const vendorSourceDir = join(PACKAGE_ROOT, "lib", "vendor");
+    const agentPresetsRoot = join(dshHome(), ".agent-presets");
+    const presetNames = (await fs.readdir(presetsSourceDir, { withFileTypes: true })).filter((e) => e.isDirectory()).map((e) => e.name);
+    const report = { synced: [], updated: [], conflicts: [], skipped: [], orphan: [] };
+    const log = (kind, text) => report[kind].push(text);
+    for (const presetName of presetNames) {
+        const modeId = presetName.replace(/^omd-/, "");
+        const cfg = matrix.modes[modeId];
+        if (cfg === undefined)
+            throw new Error("omd-dsh sync: omd-matrix.json has no entry for mode \"" + modeId + "\" (preset " + presetName + ")");
+        const sourceDir = join(presetsSourceDir, presetName);
+        const targetDir = join(agentPresetsRoot, presetName);
+        const sourceFiles = await collectSourceFiles(sourceDir);
+        const existingMeta = existsSync(targetDir) ? readMeta(targetDir) : undefined;
+        if (existsSync(targetDir) && existingMeta === undefined) {
+            log("skipped", presetName + "/ (directory exists but is not managed by omd-dsh -- left untouched)");
+            continue;
+        }
+        const nextFiles = {};
+        for (const sourceFile of sourceFiles) {
+            const rel = relative(sourceDir, sourceFile).split("\\").join("/");
+            let sourceText = await fs.readFile(sourceFile, "utf8");
+            if (rel === "agent.cordis.yml")
+                sourceText = applyMatrix(sourceText, modeId, cfg);
+            const sourceHash = sha256(sourceText);
+            const destFile = join(targetDir, rel);
+            let action = "synced";
+            if (existsSync(destFile)) {
+                const destHash = sha256(await fs.readFile(destFile, "utf8"));
+                const prevHash = existingMeta?.files?.[rel]?.sha256;
+                if (destHash === sourceHash)
+                    action = "up-to-date";
+                else if (prevHash !== undefined && destHash === prevHash)
+                    action = "updated";
+                else
+                    action = "conflict";
+            }
+            if (action === "conflict") {
+                log("conflicts", presetName + "/" + rel + " (locally modified -- keeping your version)");
+                if (existingMeta?.files?.[rel]?.sha256 !== undefined)
+                    nextFiles[rel] = { sha256: existingMeta.files[rel].sha256 };
+                continue;
+            }
+            if (action === "up-to-date")
+                log("skipped", presetName + "/" + rel + " (up to date)");
+            else {
+                if (!flags.dryRun) {
+                    await fs.mkdir(dirname(destFile), { recursive: true });
+                    await fs.writeFile(destFile, sourceText, "utf8");
+                }
+                log(action === "synced" ? "synced" : "updated", presetName + "/" + rel + (flags.dryRun ? " (dry-run)" : ""));
+            }
+            nextFiles[rel] = { sha256: sourceHash };
+        }
+        if (!flags.dryRun) {
+            await fs.mkdir(targetDir, { recursive: true });
+            await fs.writeFile(join(targetDir, ".omd-meta.json"), JSON.stringify({ source: "omd-dsh", sourceVersion, files: nextFiles }, null, 2) + "\n", "utf8");
+        }
+    }
+    const vendorTargetDir = join(agentPresetsRoot, ".omd-vendor");
+    const vendorMeta = existsSync(vendorTargetDir) ? readMeta(vendorTargetDir) : undefined;
+    if (existsSync(vendorTargetDir) && vendorMeta === undefined) {
+        log("skipped", ".omd-vendor/ (directory exists but is not managed by omd-dsh -- left untouched)");
+    }
+    else {
+        const nextVendorFiles = {};
+        for (const vendorName of VENDOR_SOURCES) {
+            const sourceFile = join(vendorSourceDir, vendorName);
+            if (!existsSync(sourceFile)) {
+                throw new Error("omd-dsh sync: missing vendored source " + sourceFile + " -- run `npm run build` first");
+            }
+            let sourceText = await fs.readFile(sourceFile, "utf8");
+            sourceText = rewriteImports(sourceText, harnessNodeModules);
+            const sourceHash = sha256(sourceText);
+            const destFile = join(vendorTargetDir, vendorName);
+            let action = "synced";
+            if (existsSync(destFile)) {
+                const destHash = sha256(await fs.readFile(destFile, "utf8"));
+                const prevHash = vendorMeta?.files?.[vendorName]?.sha256;
+                if (destHash === sourceHash)
+                    action = "up-to-date";
+                else if (prevHash !== undefined && destHash === prevHash)
+                    action = "updated";
+                else
+                    action = "conflict";
+            }
+            if (action === "conflict") {
+                log("conflicts", ".omd-vendor/" + vendorName + " (locally modified -- keeping your version)");
+                if (vendorMeta?.files?.[vendorName]?.sha256 !== undefined)
+                    nextVendorFiles[vendorName] = { sha256: vendorMeta.files[vendorName].sha256 };
+                continue;
+            }
+            if (action === "up-to-date")
+                log("skipped", ".omd-vendor/" + vendorName + " (up to date)");
+            else {
+                if (!flags.dryRun) {
+                    await fs.mkdir(vendorTargetDir, { recursive: true });
+                    await fs.writeFile(destFile, sourceText, "utf8");
+                }
+                log(action === "synced" ? "synced" : "updated", ".omd-vendor/" + vendorName + (flags.dryRun ? " (dry-run)" : ""));
+            }
+            nextVendorFiles[vendorName] = { sha256: sourceHash };
+        }
+        if (!flags.dryRun && VENDOR_SOURCES.length > 0) {
+            await fs.mkdir(vendorTargetDir, { recursive: true });
+            await fs.writeFile(join(vendorTargetDir, ".omd-meta.json"), JSON.stringify({ source: "omd-dsh", sourceVersion, harnessNodeModules, files: nextVendorFiles }, null, 2) + "\n", "utf8");
+        }
+    }
+    if (existsSync(agentPresetsRoot)) {
+        for (const entry of await fs.readdir(agentPresetsRoot, { withFileTypes: true })) {
+            if (!entry.isDirectory() || !entry.name.startsWith("omd-"))
+                continue;
+            if (presetNames.includes(entry.name))
+                continue;
+            if (readMeta(join(agentPresetsRoot, entry.name)) !== undefined)
+                log("orphan", entry.name + "/ (was installed by omd-dsh but no longer ships with v" + sourceVersion + " -- left untouched)");
+        }
+    }
+    console.log("omd-dsh sync: DSH_HOME=" + dshHome());
+    console.log("omd-dsh sync: harness node_modules=" + harnessNodeModules);
+    console.log("omd-dsh sync: source version=" + sourceVersion + (flags.dryRun ? " (dry-run)" : ""));
+    for (const key of ["synced", "updated", "skipped", "conflicts", "orphan"])
+        for (const line of report[key])
+            console.log("  [" + key + "] " + line);
+    const summary = ["synced", "updated", "conflicts", "orphan"].map((key) => report[key].length + " " + key).join(", ");
+    console.log("omd-dsh sync: " + summary + (flags.dryRun ? " (dry-run)" : ""));
+}
+// ── setup (interactive) ──
+function splitModel(answer) {
+    const a = answer.trim();
+    if (a.includes("/")) {
+        const i = a.indexOf("/");
+        return { provider: a.slice(0, i).trim(), model: a.slice(i + 1).trim() };
+    }
+    return { provider: "deepseek-official", model: a };
+}
+async function runSetup(flags, harnessNodeModules) {
+    const matrix = loadMatrix();
+    const { models, currentDefault } = discoverModels();
+    console.log("omd-dsh setup: 发现 DSH 已有模型：");
+    for (const m of models)
+        console.log("  - " + m.provider + "/" + m.model);
+    if (currentDefault)
+        console.log("omd-dsh setup: 当前全局默认 = " + currentDefault.provider + "/" + currentDefault.model);
+    console.log("");
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const ask = async (question) => (await rl.question(question)).trim();
+    const modeOrder = ["executor", "architect", "planner", "reviewer", "explorer", "librarian", "chat"];
+    for (const modeId of modeOrder) {
+        const cfg = matrix.modes[modeId] ?? {};
+        const cur = cfg.provider && cfg.model ? cfg.provider + "/" + cfg.model : "";
+        const ans = await ask("模式 " + modeId + " 顶层模型" + (cur ? " [" + cur + "]" : "") + " (回车保留，格式 provider/model): ");
+        if (ans !== "") {
+            const r = splitModel(ans);
+            cfg.provider = r.provider;
+            cfg.model = r.model;
+        }
+        if (cfg.tiers && Object.keys(cfg.tiers).length > 0) {
+            for (const [tierName, tier] of Object.entries(cfg.tiers)) {
+                const tcur = tier.provider + "/" + tier.model;
+                const tans = await ask("  " + modeId + " tier \"" + tierName + "\" 模型 [" + tcur + "] (回车保留): ");
+                if (tans !== "") {
+                    const r = splitModel(tans);
+                    tier.provider = r.provider;
+                    tier.model = r.model;
+                }
+            }
+        }
+        matrix.modes[modeId] = cfg;
+    }
+    saveMatrix(matrix);
+    console.log("omd-dsh setup: 已写入 " + MATRIX_PATH);
+    const syncNow = await ask("是否立即同步到 " + join(dshHome(), ".agent-presets") + "? [Y/n] ");
+    rl.close();
+    if (syncNow === "" || /^y/i.test(syncNow)) {
+        if (harnessNodeModules === undefined) {
+            console.error("omd-dsh setup: 无法定位 DSH harness node_modules，跳过同步。稍后运行 `omd-dsh sync --harness <路径>`。");
+        }
+        else {
+            await runSync(flags, harnessNodeModules);
+        }
+    }
+    else {
+        console.log("omd-dsh setup: 已跳过同步；稍后运行 `omd-dsh sync` 生效。");
+    }
+}
+// ── main ──
+async function main() {
+    const argv = process.argv.slice(2);
+    const flags = { dryRun: false, verbose: false };
+    let command = "";
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === "--harness")
+            flags.harness = argv[++i];
+        else if (arg === "--dry-run")
+            flags.dryRun = true;
+        else if (arg === "--verbose")
+            flags.verbose = true;
+        else if (arg === "--help" || arg === "-h") {
+            console.log(usage());
+            return;
+        }
+        else if (arg === "sync" || arg === "setup" || arg === "models")
+            command = arg;
+        else {
+            console.error("unknown argument: " + arg + "\n\n" + usage());
+            process.exitCode = 2;
+            return;
+        }
+    }
+    if (command === "") {
+        console.error("missing command\n\n" + usage());
+        process.exitCode = 2;
+        return;
+    }
+    if (command === "models") {
+        const { models, currentDefault } = discoverModels();
+        console.log("omd-dsh models: DSH_HOME=" + dshHome());
+        if (currentDefault)
+            console.log("omd-dsh models: 当前全局默认 = " + currentDefault.provider + "/" + currentDefault.model);
+        for (const m of models)
+            console.log("  " + m.provider + "/" + m.model);
+        return;
+    }
+    if (command === "setup") {
+        let harnessNodeModules = flags.harness !== undefined ? findNodeModules(flags.harness) : locateHarnessViaDsh();
+        if (harnessNodeModules !== undefined)
+            harnessNodeModules = realpathSync(harnessNodeModules);
+        await runSetup(flags, harnessNodeModules);
+        return;
+    }
+    let harnessNodeModules = flags.harness !== undefined ? findNodeModules(flags.harness) : locateHarnessViaDsh();
+    if (harnessNodeModules === undefined || !existsSync(join(harnessNodeModules, "@deepseek-ai", "dsh-scope", "package.json"))) {
+        console.error("omd-dsh sync: cannot locate the DSH harness node_modules.\n  - ensure the dsh executable is on PATH, or\n  - pass --harness <path to the harness node_modules directory>.\n\n" + usage());
+        process.exitCode = 2;
+        return;
+    }
+    harnessNodeModules = realpathSync(harnessNodeModules);
+    await runSync(flags, harnessNodeModules);
+}
+main().catch((error) => {
+    console.error("omd-dsh failed: " + (error instanceof Error ? error.message : String(error)));
+    process.exitCode = 1;
+});

package/lib/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @module @carljia/omd-dsh
+ *
+ * omd-mode: per-mode (agent preset) model routing row for DeepSeek Harness.
+ *
+ * Structurally identical to the harness built-in installModelSelection
+ * (dsh-agent): it listens on the system-prompt/assemble event to inject
+ * the provider/model prompt variables (so a persona can render the
+ * model and provider template variables), and overrides provider/model
+ * on the agent/request waterfall after next(), dropping any inherited
+ * reasoningEffort. Both listeners register with prepend: true so this
+ * row sits OUTSIDE the entry point per-session selection listener and
+ * its override wins deterministically -- that is the mechanism behind
+ * "each mode pins its own model".
+ *
+ * When provider/model are not configured the row passes everything
+ * through and only serves the persona banner variables (inheriting the
+ * entry/session selection), so it is safe to mount into any preset.
+ */
+/** Cordis plugin name. */
+declare const name = "omd-mode";
+/** No service injection: this row only registers scoped event listeners. */
+declare const inject: never[];
+/** Runtime schema for the omd-mode row. */
+declare const Config: any;
+declare function apply(ctx: any, config: any): void;
+export { Config, apply, inject, name };