@carljia/omd-dsh 0.1.0 → 0.1.2

package/lib/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { promises as fs, existsSync, realpathSync, readFileSync, writeFileSync } from "node:fs";
+import { promises as fs, existsSync, realpathSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
 import { createHash } from "node:crypto";
 import { dirname, join, relative, resolve, basename } from "node:path";
 import { homedir } from "node:os";
@@ -25,7 +25,7 @@ import { createInterface } from "node:readline/promises";
  * 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 VENDOR_SOURCES = ["omd-mode.mjs", "omd-task.mjs", "omd-ulw.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]" };
@@ -37,7 +37,7 @@ function usage() {
         "    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)",
+        "    --harness <path>  node_modules dir of the DSH harness install (saved locally after first use; otherwise auto-detected)",
         "    --dry-run         (sync) print planned writes without touching the filesystem",
         "    --verbose         (sync) print per-file detail",
     ].join("\n");
@@ -55,6 +55,60 @@ function findNodeModules(start) {
         current = parent;
     }
 }
+function harnessCachePath() { return join(dshHome(), "omd-dsh-harness.json"); }
+/** Read the cached harness node_modules, ignoring a stale/missing entry. */
+function readCachedHarness() {
+    try {
+        const p = harnessCachePath();
+        if (!existsSync(p))
+            return undefined;
+        const parsed = JSON.parse(readFileSync(p, "utf8"));
+        const nm = parsed && typeof parsed === "object" ? parsed.harnessNodeModules : undefined;
+        if (typeof nm !== "string" || nm === "")
+            return undefined;
+        if (!existsSync(join(nm, "@deepseek-ai", "dsh-scope", "package.json")))
+            return undefined;
+        return nm;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Persist the resolved harness node_modules for later runs (best-effort). */
+function writeCachedHarness(harnessNodeModules) {
+    try {
+        writeFileSync(harnessCachePath(), JSON.stringify({ harnessNodeModules }, null, 2) + "\n", "utf8");
+    }
+    catch { /* best-effort */ }
+}
+/**
+ * Resolve the DSH harness node_modules:
+ *   1. --harness flag (and cache it for later);
+ *   2. auto-detect via the dsh executable on PATH;
+ *   3. fall back to the locally cached value.
+ */
+function resolveHarness(flags) {
+    let nm;
+    if (flags.harness !== undefined) {
+        nm = findNodeModules(flags.harness);
+        if (nm !== undefined) {
+            try {
+                nm = realpathSync(nm);
+                writeCachedHarness(nm);
+            }
+            catch { /* keep nm as-is */ }
+        }
+        return nm;
+    }
+    nm = locateHarnessViaDsh() ?? locateHarnessViaNpxCache() ?? readCachedHarness();
+    if (nm !== undefined) {
+        try {
+            nm = realpathSync(nm);
+        }
+        catch { /* keep */ }
+    }
+    return nm;
+}
 function locateHarnessViaDsh() {
     const candidates = [];
     try {
@@ -79,6 +133,51 @@ function locateHarnessViaDsh() {
     }
     return undefined;
 }
+/** Candidate npx cache roots where a non-global DSH install may live. */
+function npxCacheRoots() {
+    const roots = [];
+    if (process.platform === "win32") {
+        const localAppData = process.env.LOCALAPPDATA;
+        if (localAppData)
+            roots.push(join(localAppData, "npm-cache", "_npx"));
+        const appData = process.env.APPDATA;
+        if (appData)
+            roots.push(join(appData, "npm-cache", "_npx"));
+    }
+    else {
+        roots.push(join(homedir(), ".npm", "_npx"));
+    }
+    return roots;
+}
+/**
+ * Best-effort scan of the npx cache for a DSH install whose node_modules
+ * carries @deepseek-ai/dsh-scope. Picks the most recently touched one.
+ */
+function locateHarnessViaNpxCache() {
+    const matches = [];
+    for (const root of npxCacheRoots()) {
+        let entries;
+        try {
+            entries = readdirSync(root);
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            const nm = join(root, entry, "node_modules");
+            if (!existsSync(join(nm, "@deepseek-ai", "dsh-scope", "package.json")))
+                continue;
+            let mtime = 0;
+            try {
+                mtime = statSync(join(root, entry)).mtimeMs;
+            }
+            catch { /* keep 0 */ }
+            matches.push({ nm, mtime });
+        }
+    }
+    matches.sort((a, b) => b.mtime - a.mtime);
+    return matches.length > 0 ? matches[0].nm : undefined;
+}
 function resolveHarnessModule(harnessNodeModules, specifier) {
     const segments = specifier.split("/");
     const scope = segments[0].startsWith("@") ? segments[0] + "/" + segments[1] : segments[0];
@@ -451,7 +550,7 @@ async function runSetup(flags, harnessNodeModules) {
     rl.close();
     if (syncNow === "" || /^y/i.test(syncNow)) {
         if (harnessNodeModules === undefined) {
-            console.error("omd-dsh setup: 无法定位 DSH harness node_modules，跳过同步。稍后运行 `omd-dsh sync --harness <路径>`。");
+            console.error("omd-dsh setup: 无法定位 DSH harness node_modules，跳过同步。首次请运行 `omd-dsh sync --harness <路径>`（之后会自动缓存，无需重复指定）。");
         }
         else {
             await runSync(flags, harnessNodeModules);
@@ -501,19 +600,15 @@ async function main() {
         return;
     }
     if (command === "setup") {
-        let harnessNodeModules = flags.harness !== undefined ? findNodeModules(flags.harness) : locateHarnessViaDsh();
-        if (harnessNodeModules !== undefined)
-            harnessNodeModules = realpathSync(harnessNodeModules);
-        await runSetup(flags, harnessNodeModules);
+        await runSetup(flags, resolveHarness(flags));
         return;
     }
-    let harnessNodeModules = flags.harness !== undefined ? findNodeModules(flags.harness) : locateHarnessViaDsh();
+    const harnessNodeModules = resolveHarness(flags);
     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());
+        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> (saved for later runs).\n\n" + usage());
         process.exitCode = 2;
         return;
     }
-    harnessNodeModules = realpathSync(harnessNodeModules);
     await runSync(flags, harnessNodeModules);
 }
 main().catch((error) => {

package/lib/ulw.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @module @carljia/omd-dsh/ulw
+ *
+ * omd-ulw: human-facing `/ulw` command — the "ultrawork" trigger. It arms a
+ * goal for the task; goal auto-continuation then drives the agent to
+ * completion without further input.
+ */
+/** Cordis plugin name. */
+declare const name = "omd-ulw";
+/** The goal domain is already required by tool-goal in the same preset. */
+declare const inject: string[];
+declare function apply(ctx: any): void;
+export { apply, inject, name };

package/lib/ulw.js

@@ -0,0 +1,55 @@
+/**
+ * @module @carljia/omd-dsh/ulw
+ *
+ * omd-ulw: human-facing `/ulw` command — the "ultrawork" trigger. It arms a
+ * goal for the task; goal auto-continuation then drives the agent to
+ * completion without further input.
+ */
+/** Cordis plugin name. */
+const name = "omd-ulw";
+/** The goal domain is already required by tool-goal in the same preset. */
+const inject = ["goals"];
+/** Execute one /ulw invocation through the goal domain. */
+function executeUlw(ctx, invocation) {
+    const task = invocation.rawInput.trim();
+    if (task.length === 0) {
+        return {
+            kind: "error",
+            text: "Usage: /ulw <task> — arm a goal and work on it autonomously until done.",
+        };
+    }
+    try {
+        const current = ctx.goals.get(invocation.agent);
+        if (current !== undefined && current.phase !== "complete") {
+            return {
+                kind: "error",
+                text: `A goal is already ${current.phase}. Run /goal clear first, then /ulw <task>.`,
+            };
+        }
+        ctx.goals.create(invocation.agent, { objective: task });
+        return {
+            kind: "success",
+            text: `Ultrawork armed — working to completion.\nObjective: ${task}`,
+        };
+    }
+    catch (error) {
+        return {
+            kind: "error",
+            text: `ulw failed: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+function apply(ctx) {
+    ctx.inject(["commands"], (commandCtx) => {
+        commandCtx.commands.register({
+            name: "ulw",
+            description: "ultrawork: arm a goal for a task and work on it autonomously until done",
+            input: {
+                hint: "<task>",
+                images: false,
+            },
+            handler: (invocation) => executeUlw(ctx, invocation),
+        });
+    });
+}
+export { apply, inject, name };

package/lib/vendor/omd-ulw.mjs

@@ -0,0 +1,55 @@
+/**
+ * @module @carljia/omd-dsh/ulw
+ *
+ * omd-ulw: human-facing `/ulw` command — the "ultrawork" trigger. It arms a
+ * goal for the task; goal auto-continuation then drives the agent to
+ * completion without further input.
+ */
+/** Cordis plugin name. */
+const name = "omd-ulw";
+/** The goal domain is already required by tool-goal in the same preset. */
+const inject = ["goals"];
+/** Execute one /ulw invocation through the goal domain. */
+function executeUlw(ctx, invocation) {
+    const task = invocation.rawInput.trim();
+    if (task.length === 0) {
+        return {
+            kind: "error",
+            text: "Usage: /ulw <task> — arm a goal and work on it autonomously until done.",
+        };
+    }
+    try {
+        const current = ctx.goals.get(invocation.agent);
+        if (current !== undefined && current.phase !== "complete") {
+            return {
+                kind: "error",
+                text: `A goal is already ${current.phase}. Run /goal clear first, then /ulw <task>.`,
+            };
+        }
+        ctx.goals.create(invocation.agent, { objective: task });
+        return {
+            kind: "success",
+            text: `Ultrawork armed — working to completion.\nObjective: ${task}`,
+        };
+    }
+    catch (error) {
+        return {
+            kind: "error",
+            text: `ulw failed: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+function apply(ctx) {
+    ctx.inject(["commands"], (commandCtx) => {
+        commandCtx.commands.register({
+            name: "ulw",
+            description: "ultrawork: arm a goal for a task and work on it autonomously until done",
+            input: {
+                hint: "<task>",
+                images: false,
+            },
+            handler: (invocation) => executeUlw(ctx, invocation),
+        });
+    });
+}
+export { apply, inject, name };

package/omd-matrix.json

@@ -13,7 +13,13 @@
           "model": "deepseek-v4-flash",
           "hint": "cheap and fast — repetitive investigation, searching, summarising, mechanical work",
           "persona": "You are a FAST worker subagent (快速执行子代理): complete the assigned task efficiently with the tools you have; prefer short, focused answers.",
-          "toolFilter": { "deny": ["write", "edit"], "denyShell": true }
+          "toolFilter": {
+            "deny": [
+              "write",
+              "edit"
+            ],
+            "denyShell": true
+          }
         },
         "deep": {
           "provider": "deepseek-official",
@@ -32,7 +38,13 @@
           "model": "deepseek-v4-flash",
           "hint": "cheap and fast — repetitive investigation, searching, summarising, mechanical work",
           "persona": "You are a FAST worker subagent (快速执行子代理): complete the assigned task efficiently with the tools you have; prefer short, focused answers.",
-          "toolFilter": { "deny": ["write", "edit"], "denyShell": true }
+          "toolFilter": {
+            "deny": [
+              "write",
+              "edit"
+            ],
+            "denyShell": true
+          }
         },
         "deep": {
           "provider": "deepseek-official",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carljia/omd-dsh",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "OMD 理念的 DeepSeek Harness 插件：模式能力边界 + 按模式配模型 + tier 差异化子代理委派",
   "keywords": [
     "deepseek-harness",

package/presets/omd-executor/agent.cordis.yml

@@ -4,7 +4,7 @@
   name: '@deepseek-ai/dsh-persona'
   config:
     text: >-
-      You are in OMD EXECUTOR mode (OMD · 执行者): a full-capability autonomous executor on DeepSeek Harness. Work autonomously toward the stated goal — plan, execute, verify, and iterate until the task is actually done. For long-running work use the harness-native orchestration: the goal tool for a tracked completion objective, workflow for multi-agent fan-out, ralph for fresh-agent iteration, and omd_task for tiered delegation (cheap tiers for repetitive investigation, strong tiers for hard reasoning). Do not stop to ask when the path forward is clear. 本模式路由模型：{{model}}（provider: {{provider}}）。
+      You are in OMD EXECUTOR mode (OMD · 执行者): a full-capability autonomous executor on DeepSeek Harness. Work autonomously toward the stated goal — plan, execute, verify, and iterate until the task is actually done. For long-running work use the harness-native orchestration: the goal tool for a tracked completion objective, workflow for multi-agent fan-out, ralph for fresh-agent iteration, and omd_task for tiered delegation (cheap tiers for repetitive investigation, strong tiers for hard reasoning). Do not stop to ask when the path forward is clear. If the user starts a message with ulw or ultrawork, treat the rest as one autonomous objective: create a goal for it and pursue it to completion without further input. 本模式路由模型：{{model}}（provider: {{provider}}）。
 
 # [omd-dsh:mode:start]
 # [omd-dsh:mode:end]
@@ -41,6 +41,9 @@
 - id: tool-goal
   name: '@deepseek-ai/dsh-tool-goal'
 
+- id: omd-ulw
+  name: '../.omd-vendor/omd-ulw.mjs'
+
 - id: compaction
   name: cordis:group
   group: true