dsh-repo-setup 0.1.0 → 0.1.1

package/README.en.md

@@ -0,0 +1,75 @@
+# dsh-repo-setup
+
+[![npm version](https://img.shields.io/npm/v/dsh-repo-setup)](https://www.npmjs.com/package/dsh-repo-setup)
+[![GitHub release](https://img.shields.io/github/v/release/gongyijie85/dsh-repo-setup)](https://github.com/gongyijie85/dsh-repo-setup/releases)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+Repo bootstrap guidance for the **DeepSeek Harness (DSH)** — the counterpart of
+Anthropic's **claude-code-setup**.
+
+Registers one **read-only** tool, `repo_setup_scan`: it inspects a project
+directory (language stack, test setup, docs, git, Docker and database hints)
+and returns setup recommendations — which DSH skill plugins to install, which
+MCP servers to mount, which hygiene files to create. **It never modifies
+anything.**
+
+## Install
+
+```sh
+# npm
+dsh plugin --profile web add dsh-repo-setup
+
+# GitHub
+dsh plugin --profile web add github:gongyijie85/dsh-repo-setup
+
+# Local folder (development)
+dsh plugin --profile web add D:\plugins\dsh-repo-setup
+```
+
+Restart the profile (`dsh web`). The model then calls `repo_setup_scan`
+automatically when entering a new or unfamiliar repository (or just ask:
+"scan this repo and tell me how to set it up").
+
+## Tool: repo_setup_scan
+
+| Parameter | Description |
+| --- | --- |
+| `path` | Project directory to scan. Defaults to the current working directory. |
+
+Outputs a Markdown report:
+
+- **Detected stack** — stack markers (package.json / pyproject.toml /
+  Cargo.toml / go.mod / Dockerfile, ...) including frontend frameworks and
+  test runners
+- **Repo hygiene** — missing AGENTS.md, git not initialized, no tests,
+  database hints
+- **Recommended installs** — one-command installs:
+  - `mattpocock-skills-dsh` (grilling / to-spec / to-tickets / tdd /
+    code-review workflow)
+  - `superpowers-dsh` (planning → TDD → review methodology)
+  - `dsh-ponytail-skills` (anti-over-engineering)
+  - `dsh-claude-mem` (optional: cross-session memory)
+  - `dsh-mcp-manager` (to mount the MCP servers below)
+  - MCP servers: context7 (library docs), playwright (frontend), postgres,
+    github (depending on what the scan detects)
+
+## How it works
+
+- **Bundle layer** — `cordis.patch.yml` inserts a plugin row over the dsh-base
+  layer.
+- **Tool** — `lib/index.js` registers `repo_setup_scan` with `defineTool`
+  from `@deepseek-ai/dsh-tools`; the scan is read-only (a bounded set of known
+  files + top-level directory listing), with no writes at all.
+- **Zero runtime dependencies** — Node built-ins plus the harness-injected
+  `@deepseek-ai/dsh-tools` peer dependency.
+
+## Development / verification
+
+```sh
+node --check lib/index.js
+node scripts/verify-tool.mjs   # fake-ctx registration + scan against real dirs
+```
+
+## License
+
+MIT. See [LICENSE](LICENSE).

package/README.md

@@ -1,5 +1,15 @@
 # dsh-repo-setup
 
+[![npm version](https://img.shields.io/npm/v/dsh-repo-setup)](https://www.npmjs.com/package/dsh-repo-setup)
+[![GitHub release](https://img.shields.io/github/v/release/gongyijie85/dsh-repo-setup)](https://github.com/gongyijie85/dsh-repo-setup/releases)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+<div align="center">
+
+[English](README.en.md) | **简体中文**
+
+</div>
+
 仓库体检引导插件 —— Anthropic **claude-code-setup** 的 DeepSeek Harness 版。
 
 注册一个**只读**工具 `repo_setup_scan`:扫描项目目录的语言栈、测试设置、
@@ -36,7 +46,9 @@ dsh plugin --profile web add D:\plugins\dsh-repo-setup
 - **Recommended installs** — 一键命令:
   - `mattpocock-skills-dsh`(grilling/to-spec/to-tickets/tdd/code-review 工作流)
   - `superpowers-dsh`(规划→TDD→评审方法论)
-  - `dsh-ponytail`(防过度工程)
+  - `dsh-ponytail-skills`(防过度工程)
+  - `dsh-claude-mem`(可选:跨会话记忆)
+  - `dsh-mcp-manager`(挂载下方 MCP 用)
   - MCP:context7(库文档)、playwright(前端)、postgres、github(按检测结果)
 
 ## 工作原理

package/lib/index.js

@@ -138,9 +138,9 @@ async function scanRepo(root) {
   installs.push('superpowers-dsh — brainstorming → plans → TDD → review methodology')
   installs.push('dsh-ponytail — lazy senior dev mode (anti-over-engineering)')
   if (hasTests || stacks.some((s) => s.includes('test'))) installs.push('(tdd skill is included in both packs above)')
-  lines.push(`- \`dsh plugin --profile web add github:gongyijie85/mattpocock-skills-dsh\``)
-  lines.push(`- \`dsh plugin --profile web add github:LayneChai/superpowers-dsh\``)
-  lines.push(`- \`dsh plugin --profile web add github:gongyijie85/dsh-ponytail\``)
+  lines.push(`- \`dsh plugin --profile web add mattpocock-skills-dsh\``)
+  lines.push(`- \`dsh plugin --profile web add superpowers-dsh\``)
+  lines.push(`- \`dsh plugin --profile web add dsh-ponytail-skills\``)
   lines.push(`- \`dsh plugin --profile web add github:Bleed00/dsh-claude-mem\`  (optional: cross-session memory)`)
   lines.push(`- \`dsh plugin --profile web add github:Nichts0v0/dsh-mcp-manager\`  (to mount the MCP servers below)`)
   if (stacks.some((s) => s.includes('Node') || s.includes('Rust') || s.includes('Python') || s.includes('Go'))) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-repo-setup",
   "description": "Repo bootstrap guidance for DeepSeek Harness: read-only repo_setup_scan tool that detects stack/tests/docs/git/db and recommends skill plugins, MCP servers and hygiene files to install (claude-code-setup counterpart)",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "private": false,
   "type": "module",
   "main": "lib/index.js",
@@ -13,6 +13,7 @@
     "lib",
     "cordis.patch.yml",
     "README.md",
+    "README.en.md",
     "LICENSE"
   ],
   "license": "MIT",