dsh-repo-setup 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 gongyijie85
+
+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,60 @@
+# dsh-repo-setup
+
+仓库体检引导插件 —— Anthropic **claude-code-setup** 的 DeepSeek Harness 版。
+
+注册一个**只读**工具 `repo_setup_scan`:扫描项目目录的语言栈、测试设置、
+文档、git、Docker 与数据库线索,然后给出设置建议:该装哪些 DSH 技能插件、
+该挂哪些 MCP 服务器、该补哪些卫生文件。**绝不修改任何东西。**
+
+## 安装
+
+```sh
+# npm
+dsh plugin --profile web add dsh-repo-setup
+
+# GitHub
+dsh plugin --profile web add github:gongyijie85/dsh-repo-setup
+
+# 本地开发
+dsh plugin --profile web add D:\plugins\dsh-repo-setup
+```
+
+装完重启 profile(`dsh web`),模型会在进入新/陌生仓库时自动调用
+`repo_setup_scan`(也可在对话里直接要求"扫描这个仓库怎么配置")。
+
+## 工具:repo_setup_scan
+
+| 参数 | 说明 |
+| --- | --- |
+| `path` | 要扫描的项目目录;缺省为当前工作目录 |
+
+输出 Markdown 报告:
+
+- **Detected stack** — package.json / pyproject.toml / Cargo.toml / go.mod /
+  Dockerfile 等标记识别的技术栈(含前端框架与测试运行器探测)
+- **Repo hygiene** — AGENTS.md 缺失、git 未初始化、无测试、数据库线索
+- **Recommended installs** — 一键命令:
+  - `mattpocock-skills-dsh`(grilling/to-spec/to-tickets/tdd/code-review 工作流)
+  - `superpowers-dsh`(规划→TDD→评审方法论)
+  - `dsh-ponytail`(防过度工程)
+  - MCP:context7(库文档)、playwright(前端)、postgres、github(按检测结果)
+
+## 工作原理
+
+- **Bundle 层** —— `cordis.patch.yml` 在 dsh-base 层插入插件行。
+- **工具** —— `lib/index.js` 用 `@deepseek-ai/dsh-tools` 的 `defineTool` 注册
+  `repo_setup_scan`,只读探测(读有限个已知文件 + 顶层目录列表),不做任何写入。
+- **零运行时依赖** —— 除 harness 注入的 `@deepseek-ai/dsh-tools` peer 依赖外
+  只用 Node 内置模块。
+
+## 开发验证
+
+```sh
+node --check lib/index.js
+# 功能冒烟(伪 ctx 注册 + 直接调 scanRepo 逻辑见 scripts/verify-tool.mjs)
+node scripts/verify-tool.mjs
+```
+
+## 许可证
+
+MIT。见 [LICENSE](LICENSE)。

package/cordis.patch.yml

@@ -0,0 +1,8 @@
+# dsh-repo-setup bundle patch: register the read-only repo bootstrap scanner
+# tool on the host tools registry.
+#
+# This patch is applied over the dsh-base layer; later layers (the profile's
+# own cordis.patch.yml and --patch overlays) can still address this row by id.
+- insert:
+    - id: dsh-repo-setup
+      name: 'dsh-repo-setup'

package/lib/index.js

@@ -0,0 +1,195 @@
+// dsh-repo-setup: repo bootstrap guidance for the DeepSeek Harness.
+//
+// A Cordis plugin registering one read-only tool, `repo_setup_scan`, on the
+// `ctx.tools` registry. The tool inspects a project directory (stack markers,
+// test setup, docs, git, docker, db hints) and returns a curated setup
+// recommendation: which DSH skill plugins to install, which MCP servers to
+// mount, and which hygiene files to create. It never modifies anything.
+//
+// This is the DSH counterpart of Anthropic's claude-code-setup plugin.
+//
+// @module dsh-repo-setup
+import { readFile, readdir } from 'node:fs/promises'
+import { join } from 'node:path'
+import { defineTool } from '@deepseek-ai/dsh-tools'
+
+const name = 'dsh-repo-setup'
+const inject = ['tools']
+
+/** Marker files and the stack label they imply. */
+const STACK_MARKERS = [
+  ['package.json', 'Node.js'],
+  ['pnpm-workspace.yaml', 'Node.js (pnpm workspace)'],
+  ['pyproject.toml', 'Python (pyproject)'],
+  ['requirements.txt', 'Python'],
+  ['Cargo.toml', 'Rust'],
+  ['go.mod', 'Go'],
+  ['pom.xml', 'Java (Maven)'],
+  ['build.gradle', 'Java (Gradle)'],
+  ['Gemfile', 'Ruby'],
+  ['composer.json', 'PHP'],
+  ['*.sln', 'dotnet'],
+  ['Makefile', 'Make (multi-lang)'],
+  ['CMakeLists.txt', 'C/C++ (CMake)'],
+  ['Dockerfile', 'Docker'],
+  ['docker-compose.yml', 'Docker Compose'],
+]
+
+/** Files that indicate a test setup. */
+const TEST_MARKERS = ['vitest.config.*', 'jest.config.*', 'pytest.ini', 'tox.ini', 'Cargo.toml', 'go.mod', '*.test.js', '*.spec.ts', 'tests/', 'test/']
+
+/** Presence of a frontend framework among package.json dependencies. */
+const FRONTEND_DEPS = ['react', 'vue', 'next', 'nuxt', 'svelte', 'angular', 'solid-js', 'vite', 'astro']
+
+/** Presence of a database hint. */
+const DB_HINTS = ['postgres', 'postgresql', 'DATABASE_URL', 'pg', 'mysql', 'mariadb', 'sqlite', 'mongodb', 'redis']
+
+/**
+ * Read a small text file, tolerating absence.
+ * @param root - directory to look in.
+ * @param file - relative file name.
+ * @returns file contents or undefined.
+ */
+async function tryRead(root, file) {
+  try {
+    return await readFile(join(root, file), 'utf8')
+  } catch {
+    return undefined
+  }
+}
+
+/**
+ * List top-level entries of a directory, tolerating absence.
+ * @param root - directory to scan.
+ * @returns entry names (files and dirs), or [].
+ */
+async function listTop(root) {
+  try {
+    return await readdir(root, { withFileTypes: true })
+  } catch {
+    return []
+  }
+}
+
+/**
+ * Run the read-only repo scan.
+ * @param root - the project directory to inspect.
+ * @returns a markdown report string.
+ */
+async function scanRepo(root) {
+  const entries = await listTop(root)
+  const names = new Set(entries.map((e) => e.name))
+  const dirs = new Set(entries.filter((e) => e.isDirectory()).map((e) => e.name))
+  const files = new Set(entries.filter((e) => e.isFile()).map((e) => e.name))
+
+  const lines = []
+  lines.push(`# Repo setup scan: \`${root}\``)
+  lines.push('')
+
+  // --- stack ---
+  const stacks = STACK_MARKERS.filter(([m]) => names.has(m) || (m.includes('*') && [...names].some((n) => n.endsWith(m.slice(1)))))
+    .map(([, label]) => label)
+  const pkg = await tryRead(root, 'package.json')
+  let deps = {}
+  if (pkg) {
+    try {
+      const parsed = JSON.parse(pkg)
+      deps = { ...(parsed.dependencies ?? {}), ...(parsed.devDependencies ?? {}) }
+    } catch {
+      lines.push('- ⚠️ package.json exists but is not valid JSON.')
+    }
+  }
+  const depNames = Object.keys(deps)
+  if (depNames.some((d) => FRONTEND_DEPS.includes(d))) stacks.push('Frontend (web framework detected)')
+  if (depNames.includes('vitest') || depNames.includes('jest') || depNames.includes('playwright')) stacks.push('JS test runner detected')
+  lines.push(`**Detected stack:** ${stacks.length ? [...new Set(stacks)].join(', ') : 'unknown (no common marker found)'}`)
+
+  // --- hygiene ---
+  lines.push('')
+  lines.push('## Repo hygiene')
+  if (names.has('AGENTS.md') || names.has('CLAUDE.md')) {
+    lines.push('- ✅ `AGENTS.md` / `CLAUDE.md` present.')
+  } else {
+    lines.push('- ❌ No `AGENTS.md` / `CLAUDE.md` — agents start with zero repo conventions. Create one (writing-for-agents skill can draft it).')
+  }
+  if (names.has('.git')) {
+    lines.push('- ✅ Git repository initialized.')
+  } else {
+    lines.push('- ❌ Not a git repository — run `git init` before starting work.')
+  }
+  if (dirs.has('.github')) {
+    lines.push('- ✅ GitHub Actions directory present.')
+  }
+  const hasTests =
+    depNames.some((d) => ['vitest', 'jest', 'playwright', 'mocha', 'cypress', 'pytest', 'unittest'].includes(d)) ||
+    dirs.has('tests') || dirs.has('test') ||
+    [...names].some((n) => /\.(test|spec)\./.test(n))
+  lines.push(hasTests ? '- ✅ Test setup detected.' : '- ⚠️ No tests detected — consider test-first work (tdd skill).')
+  const dbHints = [...new Set([...depNames, (await tryRead(root, '.env.example')) ?? '', (await tryRead(root, '.env')) ?? ''].join('\n').match(/postgres|mysql|mariadb|sqlite|mongodb|redis|DATABASE_URL/g) ?? [])]
+  if (dbHints.length) {
+    lines.push(`- 🗄️ Database hints: ${dbHints.join(', ')}.`)
+  }
+
+  // --- recommendations ---
+  lines.push('')
+  lines.push('## Recommended installs')
+  const installs = []
+  installs.push('mattpocock-skills-dsh — grilling / to-spec / to-tickets / tdd / code-review workflow (25 skills)')
+  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 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'))) {
+    lines.push('')
+    lines.push('**MCP servers to mount** (via the DSH MCP manager / Settings → MCP):')
+    lines.push('- `context7` (https://mcp.context7.com/mcp) — up-to-date library docs, kills hallucinated APIs')
+  }
+  if (stacks.some((s) => s.includes('Frontend'))) {
+    lines.push('- `playwright` (official Playwright MCP) — browser automation for the UI work')
+  }
+  if (dbHints.includes('postgres') || dbHints.includes('pg') || dbHints.includes('DATABASE_URL')) {
+    lines.push('- `postgres` (crystaldba/postgres-mcp) — schema/query help')
+  }
+  if (dirs.has('.github')) {
+    lines.push('- `github` (official GitHub MCP via GitRuozhi/dsh-github-mcp) — issues/PRs in context')
+  }
+
+  // --- summary ---
+  lines.push('')
+  lines.push('## Notes')
+  lines.push('- This scan is read-only: it never modified the repository.')
+  lines.push('- Re-run `repo_setup_scan` after the repo changes to refresh recommendations.')
+  lines.push('- Full plugin index: https://github.com/Dominic789654/awesome-deepseek-harness')
+  return lines.join('\n')
+}
+
+/** Register the read-only repo setup scanner. */
+function apply(ctx) {
+  ctx.tools.register(defineTool({
+    name: 'repo_setup_scan',
+    description: 'Read-only bootstrap scan of a project directory: detects language stack, test setup, docs, git, docker and database hints, ' +
+      'then recommends which DSH skill plugins to install (mattpocock-skills-dsh, superpowers-dsh, dsh-ponytail), which MCP servers to ' +
+      'mount (context7, playwright, postgres, github), and which hygiene files to create. ' +
+      'Use when starting work in a new or unfamiliar repository, or when the user asks what to install / how to set this repo up. ' +
+      'Never modifies anything.',
+    parameters: {
+      path: {
+        type: 'string',
+        description: 'Project directory to scan. Defaults to the current working directory.',
+      },
+    },
+    output: {
+      schema: { type: 'string' },
+      render: (_args, value) => [{ type: 'text', text: value }],
+    },
+    execute: (args) => scanRepo(args.path ?? process.cwd()),
+    timeoutMs: 15000,
+  }))
+}
+
+export { apply, name, inject }
+export default { apply, name, inject }

package/package.json

@@ -0,0 +1,49 @@
+{
+  "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",
+  "private": false,
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md",
+    "LICENSE"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gongyijie85/dsh-repo-setup.git"
+  },
+  "homepage": "https://github.com/gongyijie85/dsh-repo-setup",
+  "bugs": {
+    "url": "https://github.com/gongyijie85/dsh-repo-setup/issues"
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "plugin",
+    "bootstrap",
+    "repo-setup",
+    "claude-code-setup"
+  ],
+  "peerDependencies": {
+    "@deepseek-ai/dsh-tools": ">=0.0.1-rc.1 <0.2.0",
+    "@deepseek-ai/cordis": "^4.0.1"
+  },
+  "scripts": {
+    "verify": "node scripts/verify-tool.mjs",
+    "prepublishOnly": "node scripts/verify-tool.mjs"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  }
+}