dsh-js-reverse-plugin 0.1.0 → 0.2.1

package/index.js

@@ -1,7 +1,5 @@
-// dsh-js-reverse-plugin — one DeepSeek Harness bundle that mounts the
-// js-reverse skills (AST deobfuscation / iv8 / JSVMP) as runtime skills.
-// The js-reverse-mcp server is mounted by the cordis.patch.yml layer, so a
-// single `dsh plugin add` installs skills + MCP tools together.
+// Bundled reverse-engineering skills. The bundle patches register the
+// reverse agent preset and the js-reverse MCP server declaratively.
 import { readdirSync, readFileSync, statSync } from 'node:fs'
 import { join } from 'node:path'
 import { fileURLToPath } from 'node:url'
@@ -53,7 +51,7 @@ export function collectSkills() {
   return registrations
 }
 
-/** Register every bundled skill; each registration is a disposable effect. */
+/** Register bundled skills; Cordis owns and reverses each registration. */
 export function apply(ctx) {
   for (const skill of collectSkills()) {
     ctx.skills.register(skill)

package/package.json

@@ -1,20 +1,31 @@
 {
   "name": "dsh-js-reverse-plugin",
-  "version": "0.1.0",
-  "description": "JavaScript reverse-engineering bundle for DeepSeek Harness: AST deobfuscation / iv8 / JSVMP skills plus the js-reverse-mcp server tools.",
+  "version": "0.2.1",
+  "description": "JavaScript reverse-engineering bundle for DeepSeek Harness: AST deobfuscation / iv8 / JSVMP skills, the js-reverse-mcp server tools, and the reverse agent preset.",
   "type": "module",
   "main": "index.js",
   "files": [
     "index.js",
     "cordis.patch.yml",
-    "skills"
+    "skills",
+    "preset"
   ],
   "dependencies": {
     "yaml": "^2.4.0"
   },
   "dsh": {
     "bundle": {
-      "patch": "./cordis.patch.yml"
+      "patch": [
+        "./cordis.patch.yml",
+        "./preset/reverse.patch.yml"
+      ]
     }
+  },
+  "engines": {
+    "node": ">=24.9.0",
+    "dsh": "^0.2.1-rc.3"
+  },
+  "scripts": {
+    "test": "node --test tests/*.test.mjs"
   }
 }

package/preset/reverse.patch.yml

@@ -0,0 +1,166 @@
+# Reverse agent composition for the declarative DSH preset registry.
+- insert:
+    - id: preset-reverse
+      name: '@deepseek-ai/dsh-agent-preset'
+      config:
+        id: reverse
+        name: 逆向模式
+        description: JS 逆向工程 Agent：证据驱动、逐步决策，配备 iv8 受控执行与 js-reverse 浏览器取证。
+        order: 2
+        plugins:
+          - id: persona
+            name: '@deepseek-ai/dsh-persona'
+            config:
+              prefix: >-
+                You are a JS reverse-engineering agent powered by the {{model}} model.
+
+                工作准则：
+                - 证据驱动：每个结论必须可溯源——静态证据（源码、字节码、AST）或动态证据（受控执行、浏览器观测）。区分"事实"与"推断"，不无证猜测。
+                - 逐步决策：关键选择先说明依据与代价，等用户决定——解混淆路线、是否补环境、静态还是动态、继续还是交接。
+                - 保护原始输入：目标文件一律只读；分析前先做格式化派生副本，一切修改只落在副本。
+                - 解混淆服务于分析：产出是方便阅读、搜索、定位、动态观测的派生视图；不以"清理干净"或还原作者原名、原始工程为目标。
+                - 受控执行：动态证据通过 iv8（C++ V8 + 浏览器环境）或 js-reverse MCP 取得；Node.js 仅作静态工程工具。
+                - 等价验收：恢复的算法、签名、映射以与原始实现精确等价为验收标准；"服务器恰好接受"不是证明。
+                - 长线任务用 todo 和 goal 跟踪；多路独立分析（静态/动态/资料）可用 subagent 并行；关键证据和推导过程记录在案，保持可审计。
+
+          - id: agent-instructions
+            name: '@deepseek-ai/dsh-agent-instructions'
+            config:
+              maxBytes: 65536
+
+          - id: tool-bash
+            name: '@deepseek-ai/dsh-tool-bash'
+            disabled: !!js process.platform === 'win32'
+
+          - id: tool-pwsh
+            name: '@deepseek-ai/dsh-tool-pwsh'
+            disabled: !!js process.platform !== 'win32'
+
+          - id: tool-fs
+            name: '@deepseek-ai/dsh-tool-fs'
+
+          - id: tool-fs-search
+            name: '@deepseek-ai/dsh-tool-fs-search'
+            config:
+              sampleOverCapGlobResults: false
+
+          - id: tool-jobs
+            name: '@deepseek-ai/dsh-tool-jobs'
+
+          - id: skill-filesystem
+            name: '@deepseek-ai/dsh-skill-filesystem'
+
+          - id: tool-skill
+            name: '@deepseek-ai/dsh-tool-skill'
+
+          - id: tool-goal
+            name: '@deepseek-ai/dsh-tool-goal'
+
+          - 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: compaction
+            name: cordis:group
+            group: true
+            isolate:
+              compaction: true
+              toolResultPruner: true
+            config:
+              - id: compaction-basic
+                name: '@deepseek-ai/dsh-compaction-basic'
+
+              - id: command-compact
+                name: '@deepseek-ai/dsh-command-compact'
+
+              - id: tool-result-pruner
+                name: '@deepseek-ai/dsh-compaction-tool-result-pruner'
+                config:
+                  thresholdChars: 8192
+                  headChars: 4096
+                  tailChars: 1024
+
+          - id: delegation
+            name: cordis:group
+            group: true
+            isolate:
+              workflowEngine: true
+            config:
+              - id: tool-subagent-control
+                name: '@deepseek-ai/dsh-tool-subagent-control'
+
+              - id: tool-subagent
+                name: '@deepseek-ai/dsh-tool-subagent'
+                config:
+                  provider: spawn
+                  toolName: subagent
+
+              - id: tool-subagent-fork
+                name: '@deepseek-ai/dsh-tool-subagent'
+                config:
+                  provider: fork
+                  toolName: subagent_fork
+
+              - id: tool-subagent-codex
+                name: '@deepseek-ai/dsh-tool-subagent'
+                disabled: true
+                config:
+                  provider: codex
+                  toolName: subagent_codex
+                  enableRunInBackground: false
+                  maxDepth: provider-managed
+
+              - id: tool-subagent-claude-code
+                name: '@deepseek-ai/dsh-tool-subagent'
+                disabled: true
+                config:
+                  provider: claude-code
+                  toolName: subagent_claude_code
+                  enableRunInBackground: false
+                  maxDepth: provider-managed
+
+              - id: workflow-ptc
+                name: '@deepseek-ai/dsh-workflow-ptc'
+                config:
+                  provider: spawn
+
+              - id: tool-workflow
+                name: '@deepseek-ai/dsh-tool-workflow'
+
+              - id: tool-ralph
+                name: '@deepseek-ai/dsh-tool-ralph'
+                config:
+                  subagentProvider: spawn
+                  maxRounds: 64
+
+          - id: tool-ask-user
+            name: '@deepseek-ai/dsh-tool-ask-user'
+
+          - id: tool-todo
+            name: '@deepseek-ai/dsh-tool-todo'
+            config:
+              allowParallelInProgress: true
+
+          - id: tool-web
+            name: '@deepseek-ai/dsh-tool-web'
+            config:
+              fetch: false
+              searchTimeoutMs: 60000