@carljia/omd-dsh 0.1.1 → 0.1.3

package/lib/vendor/omd-start-work.mjs

@@ -0,0 +1,147 @@
+import { access, readFile } from "node:fs/promises";
+import { isAbsolute, join } from "node:path";
+import { scopeOf } from "@deepseek-ai/dsh-scope";
+/**
+ * @module @carljia/omd-dsh/startwork
+ *
+ * omd-start-work: human-facing `/start-work` command -- the "start work"
+ * trigger at the end of the OMD planning workflow. It resolves the named
+ * plan file inside the workspace's plan directory (a fixed, code-level
+ * convention -- never mentioned in any persona/prompt text), arms a goal
+ * whose objective references the plan's absolute path, and goal
+ * auto-continuation then drives the agent to execute the plan without
+ * further input.
+ */
+/** Cordis plugin name. */
+const name = "omd-start-work";
+/** The goal domain is already required by tool-goal in the same preset. */
+const inject = ["goals"];
+/** Plan directory segments relative to the session workspace root (cwd). */
+const PLAN_DIR_SEGMENTS = [".omd", "plans"];
+/** The prefix accepted when a user pastes the full relative plan path. */
+const PLAN_DIR_PREFIX = ".omd/plans/";
+/** Plan directory for one workspace root. */
+function plansDir(cwd) {
+    return join(cwd, ...PLAN_DIR_SEGMENTS);
+}
+/**
+ * Resolve the user's file-name input to a candidate path inside the plan
+ * directory. Accepts a bare file name ("foo.md" / "foo") or the full
+ * relative path (".omd/plans/foo.md"); rejects absolute paths and anything
+ * that would escape the plan directory.
+ */
+function resolveCandidate(cwd, input) {
+    const trimmed = String(input).trim().replace(/\\/g, "/");
+    if (trimmed === "" || isAbsolute(trimmed))
+        return undefined;
+    let name = trimmed.replace(/^\.\//, "");
+    if (name.includes("/")) {
+        if (!name.startsWith(PLAN_DIR_PREFIX))
+            return undefined;
+        name = name.slice(PLAN_DIR_PREFIX.length);
+    }
+    if (name === "" || name.includes("/") || name === "." || name === "..")
+        return undefined;
+    if (name.startsWith("."))
+        return undefined; // no hidden-file tricks
+    return join(plansDir(cwd), name);
+}
+/** One /start-work invocation through the goal domain. */
+async function executeStartWork(ctx, invocation) {
+    const agent = invocation.agent;
+    const cwd = agent !== undefined &&
+        agent.session !== undefined &&
+        agent.session.header !== undefined &&
+        typeof agent.session.header.cwd === "string"
+        ? agent.session.header.cwd
+        : "";
+    if (cwd === "") {
+        return {
+            kind: "error",
+            text: "This session has no workspace directory; /start-work needs one to find the plan file.",
+        };
+    }
+    const candidate = resolveCandidate(cwd, invocation.rawInput);
+    if (candidate === undefined) {
+        return {
+            kind: "error",
+            text: "Usage: /start-work <plan file name> — the file must live inside " + PLAN_DIR_SEGMENTS.join("/") + "/.",
+        };
+    }
+    let file = candidate;
+    const usable = async (path) => {
+        try {
+            await access(path);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    if (!(await usable(file)) && !file.endsWith(".md") && (await usable(file + ".md"))) {
+        file = file + ".md";
+    }
+    else if (!(await usable(file))) {
+        return {
+            kind: "error",
+            text: "Plan file not found: " + PLAN_DIR_SEGMENTS.join("/") + "/" + file.slice(plansDir(cwd).length + 1),
+        };
+    }
+    let text;
+    try {
+        text = await readFile(file, "utf8");
+    }
+    catch (error) {
+        return {
+            kind: "error",
+            text: "Cannot read the plan file: " + (error instanceof Error ? error.message : String(error)),
+        };
+    }
+    if (text.trim() === "") {
+        return { kind: "error", text: "The plan file is empty." };
+    }
+    try {
+        const current = ctx.goals.get(agent);
+        if (current !== undefined && current.phase !== "complete") {
+            return {
+                kind: "error",
+                text: `A goal is already ${current.phase}. Run /goal clear first, then /start-work <plan file name>.`,
+            };
+        }
+        ctx.goals.create(agent, {
+            objective: "Execute the approved plan file at " +
+                file +
+                ". Read the file in full, then carry out every step autonomously: implement, verify, and iterate until the plan's goal and success criteria are met. Work through goal continuation rounds until done.",
+        });
+        return {
+            kind: "success",
+            text: "Start work armed — executing the plan to completion.\nPlan: " +
+                PLAN_DIR_SEGMENTS.join("/") +
+                "/" +
+                file.slice(plansDir(cwd).length + 1),
+        };
+    }
+    catch (error) {
+        return {
+            kind: "error",
+            text: "start-work failed: " + (error instanceof Error ? error.message : String(error)),
+        };
+    }
+}
+function apply(ctx) {
+    if (scopeOf(ctx) === undefined) {
+        throw new Error("omd-start-work: refusing to mount outside a scoped context; mount this row inside an agent preset");
+    }
+    ctx.inject(["commands"], (commandCtx) => {
+        commandCtx.commands.register({
+            name: "start-work",
+            description: "start work: arm a goal that executes the named plan file to completion",
+            input: {
+                hint: "<plan file name>",
+                images: false,
+            },
+            handler: (invocation) => executeStartWork(ctx, invocation),
+        });
+    });
+}
+export { apply, inject, name };

package/{omd-matrix.json → omd-matrix.default.json}

@@ -13,7 +13,10 @@
           "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",
@@ -23,7 +26,7 @@
         }
       }
     },
-    "architect": {
+    "ultraworker": {
       "provider": "deepseek-official",
       "model": "deepseek-v4-pro",
       "tiers": {
@@ -32,7 +35,10 @@
           "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.1",
+  "version": "0.1.3",
   "description": "OMD 理念的 DeepSeek Harness 插件：模式能力边界 + 按模式配模型 + tier 差异化子代理委派",
   "keywords": [
     "deepseek-harness",
@@ -43,7 +43,7 @@
   "files": [
     "lib",
     "presets",
-    "omd-matrix.json",
+    "omd-matrix.default.json",
     "README.md",
     "LICENSE"
   ],

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

@@ -8,6 +8,8 @@
 
 # [omd-dsh:mode:start]
 # [omd-dsh:mode:end]
+- id: omd-mode-switch
+  name: '../.omd-vendor/omd-mode-switch.mjs'
 - id: tool-ask-user
   name: '@deepseek-ai/dsh-tool-ask-user'
 

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

@@ -4,10 +4,37 @@
   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. 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}}）。
+      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. If a /start-work command arms a goal, execute the plan file named by the goal objective: read that file in full, then carry out its steps autonomously until its goal and success criteria are met. 本模式路由模型：{{model}}（provider: {{provider}}）。
 
 # [omd-dsh:mode:start]
 # [omd-dsh:mode:end]
+- id: omd-start-work
+  name: '../.omd-vendor/omd-start-work.mjs'
+
+- id: omd-mode-switch
+  name: '../.omd-vendor/omd-mode-switch.mjs'
+
+- id: planning
+  name: cordis:group
+  group: true
+  isolate:
+    planMode: true
+  config:
+    - id: plan-mode
+      name: '@deepseek-ai/dsh-plan-mode'
+      config:
+        section: |
+          You are in plan mode. Stay in plan mode until exit_plan_mode succeeds or the user switches the session mode. Imperative language to implement changes means plan the implementation, not execute it. A user's conversational agreement — including an answer confirming something you asked — approves nothing and does not end plan mode; fold the confirmed decision into the plan and submit it through exit_plan_mode.
+
+          Explore first. Use non-mutating reads, searches, static analysis, and checks to ground the plan in the actual repository. Do not edit or write files, change configuration, run formatters or code generation that rewrites tracked files, commit, or otherwise carry out the plan. Prefer existing functions and patterns over new machinery.
+
+          The tool catalog stays the same across modes for request-cache stability. These plan-mode rules override any later tool description or guidance that suggests using mutation tools; those tools remain listed to keep the tool catalog unchanged. Do not use todo_write to track this planning phase: it tracks implementation after an approved plan, while the plan itself belongs in exit_plan_mode.
+
+          Resolve discoverable facts by inspection. Use ask_user_question only for user-owned choices or material ambiguity that inspection cannot answer. Do not ask the user where code lives or how current behavior works when you can find out.
+
+          Make the plan decision-complete: state the goal and success criteria; group implementation changes by subsystem; identify public API, schema, and data-flow changes; cover edge cases, failure modes, tests, acceptance criteria, and explicit assumptions. Keep it concise enough to review but detailed enough that another engineer can implement it without making design decisions.
+
+          When ready, call exit_plan_mode with the complete plan markdown, starting with a # title. Make exit_plan_mode the only and final tool call in that assistant response: it presents the plan for approval, and implementation begins only in a later step after approval. Do not paste the final plan as a plain reply or ask "should I proceed?" through prose or ask_user_question. If review rejects it, incorporate the feedback and present again. If the review channel is unavailable or aborted, stay in plan mode and ask the user to switch modes manually; do not proceed with implementation.
 - id: agent-instructions
   name: '@deepseek-ai/dsh-agent-instructions'
   config:

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

@@ -8,6 +8,8 @@
 
 # [omd-dsh:mode:start]
 # [omd-dsh:mode:end]
+- id: omd-mode-switch
+  name: '../.omd-vendor/omd-mode-switch.mjs'
 - id: agent-instructions
   name: '@deepseek-ai/dsh-agent-instructions'
   config:

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

@@ -8,6 +8,8 @@
 
 # [omd-dsh:mode:start]
 # [omd-dsh:mode:end]
+- id: omd-mode-switch
+  name: '../.omd-vendor/omd-mode-switch.mjs'
 - id: agent-instructions
   name: '@deepseek-ai/dsh-agent-instructions'
   config:

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

@@ -4,10 +4,15 @@
   name: '@deepseek-ai/dsh-persona'
   config:
     text: >-
-      You are in OMD PLANNER mode (OMD · 规划访谈): a planning-and-interview agent on DeepSeek Harness. The harness plan-mode section supplies your planning rules — follow it. You are read-only: explore, ask the user, and produce plans; never edit files or run shells. Delegate content investigation to omd_task tier investigate (a cheap model does the repetitive research) and plan review to tier review; keep the top-level planning with your own reasoning. 本模式路由模型：{{model}}（provider: {{provider}}）。
+      You are in OMD PLANNER mode (OMD · 规划访谈): a planning-and-interview agent on DeepSeek Harness. The harness plan-mode section supplies your planning rules — follow it. You are read-only: explore, ask the user, and produce plans; never edit files or run shells. Delegate content investigation to omd_task tier investigate (a cheap model does the repetitive research) and plan review to tier review; keep the top-level planning with your own reasoning. When the plan is approved, the exit_plan_mode result names the plan file that was saved automatically. Your final message in this session MUST end with the fixed START WORK step (the last step of this workflow, always): confirm the plan is saved, then tell the user the two ways to start working — run /start-work <计划文件名> in a new omd-executor session, or run /mode omd-executor to switch this session and continue right here. Never begin implementing in this read-only planner session. 本模式路由模型：{{model}}（provider: {{provider}}）。
 
 # [omd-dsh:mode:start]
 # [omd-dsh:mode:end]
+- id: omd-plan
+  name: '../.omd-vendor/omd-plan.mjs'
+
+- id: omd-mode-switch
+  name: '../.omd-vendor/omd-mode-switch.mjs'
 - id: agent-instructions
   name: '@deepseek-ai/dsh-agent-instructions'
   config:
@@ -35,6 +40,8 @@
 
           When ready, call exit_plan_mode with the complete plan markdown, starting with a # title. Make exit_plan_mode the only and final tool call in that assistant response: it presents the plan for approval, and implementation begins only in a later step after approval. Do not paste the final plan as a plain reply or ask "should I proceed?" through prose or ask_user_question. If review rejects it, incorporate the feedback and present again. If the review channel is unavailable or aborted, stay in plan mode and ask the user to switch modes manually; do not proceed with implementation.
 
+          Once the plan is approved, the exit_plan_mode result names the automatically saved plan file. Close the conversation with your persona's fixed Start Work final step — this is the last workflow step, always — and never start implementing in this read-only session.
+
 - id: tool-fs
   name: '@deepseek-ai/dsh-tool-fs'
 

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

@@ -8,6 +8,8 @@
 
 # [omd-dsh:mode:start]
 # [omd-dsh:mode:end]
+- id: omd-mode-switch
+  name: '../.omd-vendor/omd-mode-switch.mjs'
 - id: agent-instructions
   name: '@deepseek-ai/dsh-agent-instructions'
   config:

package/presets/{omd-architect → omd-ultraworker}/agent.cordis.yml

@@ -1,13 +1,18 @@
-# omd-architect preset (OMD architect mode). Generated by omd-dsh — see README for the mode matrix.
+# omd-ultraworker preset (OMD ultraworker mode). Generated by omd-dsh — see README for the mode matrix.
 
 - id: persona
   name: '@deepseek-ai/dsh-persona'
   config:
     text: >-
-      You are in OMD ARCHITECT mode (OMD · 架构构建): a deep builder on DeepSeek Harness. Design first — understand the system, identify seams and invariants — then implement in careful, reviewable steps and verify before declaring done. Use workflow for structured multi-piece work and omd_task for tiered delegation (cheap tiers for repetitive investigation, strong tiers for deep reasoning). 本模式路由模型：{{model}}（provider: {{provider}}）。
+      You are in ULTRAWORKER mode (OMD · 超能工作者): a deep, high-throughput builder on DeepSeek Harness with PTC (Code Mode) tool presentation. Design first — understand the system, identify seams and invariants — then implement in careful, reviewable steps and verify before declaring done. Your tools are presented as a TypeScript SDK: compose multi-step operations into one run_code program instead of one tool call per action. Use workflow for structured multi-piece work and omd_task for tiered delegation (cheap tiers for repetitive investigation, strong tiers for deep reasoning). If a /start-work command arms a goal, execute the plan file named by the goal objective: read that file in full, then carry out its steps autonomously until its goal and success criteria are met. 本模式路由模型：{{model}}（provider: {{provider}}）。
 
 # [omd-dsh:mode:start]
 # [omd-dsh:mode:end]
+- id: omd-start-work
+  name: '../.omd-vendor/omd-start-work.mjs'
+
+- id: omd-mode-switch
+  name: '../.omd-vendor/omd-mode-switch.mjs'
 - id: agent-instructions
   name: '@deepseek-ai/dsh-agent-instructions'
   config:
@@ -110,3 +115,12 @@
   config:
     fetch: false
     searchTimeoutMs: 60000
+
+# PTC (Code Mode) presentation for this agent alone: the model writes a
+# TypeScript program against a generated SDK and run_code executes it, so a
+# sequence that would be five round trips becomes one. The row waits for the
+# host's codeRuntime rather than assuming it.
+- id: tool-presentation
+  name: '@deepseek-ai/dsh-agent-tool-presentation'
+  config:
+    mode: code

package/presets/omd-ultraworker/preset.yml

@@ -0,0 +1,3 @@
+name: OMD · 超能工作者
+description: 深度构建模式：完整工具集 + workflow + omd_task 差异化委派 + PTC（Code Mode，模型以 TypeScript SDK 呈现工具，多步操作一次往返）。
+order: 102

package/presets/omd-architect/preset.yml

@@ -1,3 +0,0 @@
-name: OMD · 架构构建
-description: 深度构建模式：完整工具集 + workflow + omd_task 差异化委派（不含 ralph）。
-order: 102