@njuptlzf/dsh-ponytail 1.1.0

package/LICENSE

@@ -0,0 +1,26 @@
+MIT License
+
+Copyright (c) 2026 Kasakaze (njuptlzf)
+
+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.
+
+---
+
+The bundled `SKILL.md` originates from https://github.com/DietrichGebert/ponytail
+and is licensed under MIT by its respective author(s).

package/README.md

@@ -0,0 +1,129 @@
+# dsh-ponytail
+
+<details open>
+<summary><b>English</b> · <i>点击下方「中文」切换中文</i></summary>
+
+A [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) plugin that installs the [Ponytail](https://github.com/DietrichGebert/ponytail) "lazy senior developer" ruleset. It mirrors upstream's two-layer split:
+
+- an **always-on, mode-switchable** system-prompt section built from the *compact* ruleset (~2.5 KB), and
+- the **full** ruleset + 5 companion skills as on-demand `/` skills.
+
+**This repo vendors no skill content.** On first boot it fetches once from upstream `DietrichGebert/ponytail`, caches to disk, and never re-fetches or hand-syncs afterwards.
+
+### What it does
+
+1. **Always-on section (lean)** — the compact ruleset (`.agents/rules/ponytail.md`, ~2.5 KB) as a system-prompt section, cached at `~/.dsh/ponytail-cache/compact.md`. Switch the level per session with `/ponytail lite|full|ultra|off`; `off` empties the section so the tokens are actually saved. Default `full`.
+2. **On-demand skills** — the full ruleset (`ponytail`) and the 5 companions (`ponytail-help` / `ponytail-audit` / `ponytail-debt` / `ponytail-gain` / `ponytail-review`) written once to `~/.dsh/skills/<name>/SKILL.md`, invocable from the `/` palette.
+
+### Install
+
+```sh
+dsh plugin --profile web add @njuptlzf/dsh-ponytail
+# without a global dsh:
+npx @deepseek-ai/dsh plugin --profile web add @njuptlzf/dsh-ponytail
+# from git instead: dsh plugin --profile web add github:njuptlzf/dsh-ponytail
+```
+
+Restart `dsh web` after install. The first boot fetches once and caches, so later boots — online or offline — never touch the network. To update the skills, delete the corresponding cache/skill files and restart.
+
+### Usage
+
+- `/ponytail` — report the current level; `/ponytail lite|full|ultra|off` — switch it. Mode is per-session (`agent.id`), so one conversation's `off` does not affect another.
+- The 6 skills stay in the `/` palette; name them (e.g. "audit for over-engineering") and the model loads them on its own.
+
+### dsh-ponytail vs codex-ponytail
+
+| | codex-ponytail (upstream Codex plugin) | dsh-ponytail (this plugin) |
+|---|---|---|
+| Mechanism | Codex plugin: `SessionStart` + `SubagentStart` + `UserPromptSubmit` lifecycle hooks | DSH bundle: `systemPrompt` section + `commands` service |
+| Always-on content | full ruleset, mode-filtered, at `SessionStart` | **compact ruleset (~2.5 KB)** every step |
+| Per-turn cost | full rules only at session start / compact / subagent; one mode line per turn | ~2.5 KB re-rendered per step (DSH `systemPrompt` per-step semantics) |
+| `off` | `UserPromptSubmit` stops injecting, tokens saved | section renders empty, tokens saved (parity) |
+| Levels | `lite`/`full`/`ultra` filter the full ruleset's per-mode rows | level carried as header + behavior; per-mode detail lives in the on-demand full skill |
+| Session isolation | single-session process → process-level flag file | multi-session process → per `agent.id` (== `session.id`) |
+| Compaction | `SessionStart` re-fires on the `compact` matcher | compaction only shatters history, never the system prompt (inherent) |
+| Subagents | `SubagentStart` + `PONYTAIL_SUBAGENT_MATCHER` | global section inherits into subagents via composition (no patch expected) |
+| On-demand detail | `ponytail` skill | `ponytail` skill (parity) |
+| Fallback | inline `getFallbackInstructions` | TODO (see `OPTIMIZATION_PLAN.md`) |
+
+### Structure
+
+```
+dsh-ponytail/
+├── index.js               # host plugin: fetch once → compact always-on + mirror full/companions
+├── package.json           # dsh.bundle.patch declaration
+├── cordis.patch.yml       # mount row
+├── OPTIMIZATION_PLAN.md   # full design rationale + comparison
+├── README.md
+└── LICENSE                # MIT
+```
+
+### Attribution
+
+Skill content comes from [DietrichGebert/ponytail](https://github.com/DietrichGebert/ponytail) (MIT), fetched at runtime. The plugin wrapper is MIT © 2026 Kasakaze (njuptlzf).
+
+</details>
+
+<details>
+<summary><b>中文</b> · <i>点击上方「English」切换英文</i></summary>
+
+一个 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 插件：把 [Ponytail](https://github.com/DietrichGebert/ponytail)「懒高级工程师」规范接入进来，对标上游的两层结构：
+
+- **常驻、可按档切换**的 system-prompt section，用 **精简规则**（~2.5 KB）构建；
+- **全文规则** + 5 个同伴技能作为按需 `/` skill。
+
+**本仓库不存技能内容**——首次启动从上游 `DietrichGebert/ponytail` 抓取一次并落盘缓存，之后不再联网、永不手工同步。
+
+### 它做什么
+
+1. **常驻 section（精简）** — 精简规则（`.agents/rules/ponytail.md`，~2.5 KB）作为 system-prompt section，缓存于 `~/.dsh/ponytail-cache/compact.md`。用 `/ponytail lite|full|ultra|off` 按会话切档；`off` 会让 section 渲染为空、真的省回 token。默认 `full`。
+2. **按需 skills** — 全文规则（`ponytail`）和 5 个同伴（`ponytail-help` / `ponytail-audit` / `ponytail-debt` / `ponytail-gain` / `ponytail-review`）写入 `~/.dsh/skills/<name>/SKILL.md`，`/` 面板可调。
+
+### 安装
+
+```sh
+dsh plugin --profile web add @njuptlzf/dsh-ponytail
+# 无全局 dsh：
+npx @deepseek-ai/dsh plugin --profile web add @njuptlzf/dsh-ponytail
+# 或者从 git 安装：dsh plugin --profile web add github:njuptlzf/dsh-ponytail
+```
+
+安装后**重启 `dsh web`**：首次启动联网抓取一次并缓存，之后无论在线离线都不再联网。要更新技能，删对应缓存/技能文件再重启即可触发重抓。
+
+### 使用
+
+- `/ponytail` — 报告当前档；`/ponytail lite|full|ultra|off` — 切档。档位按会话（`agent.id`）隔离，一个会话的 `off` 不影响其它会话。
+- 6 个技能常驻 `/` 面板；直接说「audit for over-engineering」等关键词，模型会按描述自行加载。
+
+### dsh-ponytail vs codex-ponytail
+
+| | codex-ponytail（上游官方 Codex 插件） | dsh-ponytail（本插件） |
+|---|---|---|
+| 接入机制 | Codex 插件：`SessionStart` + `SubagentStart` + `UserPromptSubmit` 三个 lifecycle hook | DSH bundle：`systemPrompt` section + `commands` 服务 |
+| 常驻内容 | `SessionStart` 时注入**全文**（按 mode 过滤） | 每步注入**精简规则（~2.5 KB）** |
+| 每轮成本 | 全文只在会话开始/压缩/子代理时；每轮只一行 mode 标记 | 每步重渲 ~2.5 KB（DSH `systemPrompt` 的 per-step 语义） |
+| off | `UserPromptSubmit` 停止注入、省回 token | section 渲染为空、省回 token（对齐） |
+| 强度档 | `lite`/`full`/`ultra` 过滤全文对应档的内容 | 档位以 header + 行为承载；分档细节落在按需全文 skill |
+| 会话隔离 | 单会话进程 → 进程级 flag 文件 | 多会话单进程 → 按 `agent.id`（== `session.id`）隔离 |
+| 压缩/遗忘 | `SessionStart` 的 `compact` matcher 在压缩时重注入 | 压缩只 shadow 历史、不动 system prompt（天然免疫） |
+| 子代理 | `SubagentStart` + `PONYTAIL_SUBAGENT_MATCHER` | 全局 section 随 composition 继承子代理（预期无需补丁） |
+| 按需详情 | `ponytail` skill | `ponytail` skill（对齐） |
+| 兜底 | 内置 `getFallbackInstructions` | 待补（见 `OPTIMIZATION_PLAN.md`） |
+
+### 结构
+
+```
+dsh-ponytail/
+├── index.js               # host 插件：只抓一次 → 精简常驻 + 镜像全文/同伴
+├── package.json           # dsh.bundle.patch 声明
+├── cordis.patch.yml       # 挂载行
+├── OPTIMIZATION_PLAN.md   # 完整设计说明与对比
+├── README.md
+└── LICENSE                # MIT
+```
+
+### 归属
+
+技能内容来自 [DietrichGebert/ponytail](https://github.com/DietrichGebert/ponytail)（MIT），运行时抓取。插件包装层 MIT © 2026 Kasakaze (njuptlzf)。
+
+</details>

package/cordis.patch.yml

@@ -0,0 +1,5 @@
+# @njuptlzf/dsh-ponytail bundle patch: mount the ponytail host plugin
+# under its package name (module specifier), resolved through the profile's node_modules.
+- insert:
+    - id: dsh-ponytail
+      name: '@njuptlzf/dsh-ponytail'

package/index.js

@@ -0,0 +1,141 @@
+/**
+ * dsh-ponytail — Ponytail (lazy senior dev) as a mode-switchable, always-on
+ * DSH host plugin.
+ *
+ * Vendors NO skill content — everything is fetched once from the canonical
+ * upstream (https://github.com/DietrichGebert/ponytail, MIT) and cached to
+ * disk, never re-fetched:
+ *
+ *   Layer 1 — always-on (lean): the COMPACT ruleset
+ *     (.agents/rules/ponytail.md, ~2.5 KB) as a per-step systemPrompt section.
+ *     Mode-switchable per session via /ponytail lite|full|ultra|off; "off"
+ *     renders the section empty, so the tokens are really saved (no restart).
+ *
+ *   Layer 2 — on-demand skills: the FULL ruleset
+ *     (skills/ponytail/SKILL.md) and the five companions, fetched once directly
+ *     into ~/.dsh/skills/<name>/SKILL.md, invocable from the "/" palette.
+ *
+ * "只抓一次": fetch only when a disk copy is missing; a present copy is reused
+ * forever. Delete a copy to force a refetch.
+ *
+ * DSH-specific: one process hosts many sessions, so mode is stored per agent id
+ * (agent.id === session.id), NOT process-global as in single-session CLI hosts.
+ */
+
+import { readFileSync, existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { homedir } from 'node:os';
+
+export var name = 'dsh-ponytail';
+export var inject = ['systemPrompt', 'commands'];
+
+var RAW_BASE = 'https://raw.githubusercontent.com/DietrichGebert/ponytail/main/';
+var MAIN = 'ponytail';
+var COMPACT_REL = '.agents/rules/ponytail.md';
+var COMPANIONS = ['ponytail-help', 'ponytail-audit', 'ponytail-debt', 'ponytail-gain', 'ponytail-review'];
+var MODES = ['off', 'lite', 'full', 'ultra'];
+var DEFAULT_MODE = 'full';
+
+var compactSpec = '';
+
+// sessionId (agent.id) -> mode. DSH is multi-session single-process, so state
+// must be per-session; the Map's growth is bounded by live session count.
+var modeById = new Map();
+
+function modeFor(agent) {
+  var m = agent && agent.id !== undefined ? modeById.get(agent.id) : undefined;
+  return MODES.includes(m) ? m : DEFAULT_MODE;
+}
+
+function skillFile(name) {
+  return join(homedir(), '.dsh', 'skills', name, 'SKILL.md');
+}
+
+function compactCacheFile() {
+  return join(homedir(), '.dsh', 'ponytail-cache', 'compact.md');
+}
+
+function readFileOrNull(path) {
+  try {
+    return readFileSync(path, 'utf8');
+  } catch (e) {
+    return null;
+  }
+}
+
+function saveFile(target, content) {
+  try {
+    mkdirSync(dirname(target), { recursive: true });
+    writeFileSync(target, content);
+  } catch (e) {
+    console.error('[dsh-ponytail] write failed:', e && e.message ? e.message : String(e));
+  }
+}
+
+async function fetchUrl(rel) {
+  try {
+    var res = await fetch(RAW_BASE + rel);
+    if (!res.ok) throw new Error('HTTP ' + res.status);
+    return await res.text();
+  } catch (e) {
+    console.error('[dsh-ponytail] fetch failed for ' + rel + ':', e && e.message ? e.message : String(e));
+    return null;
+  }
+}
+
+export function apply(ctx) {
+  // Cache-first: the always-on section has content offline, from turn one.
+  compactSpec = readFileOrNull(compactCacheFile()) || '';
+
+  ctx.effect(function () {
+    return ctx.systemPrompt.section({
+      name: 'ponytail',
+      order: 900,
+      text: function (context) {
+        var mode = modeFor(context && context.agent);
+        if (mode === 'off' || compactSpec === '') return '';   // empty → dropped by renderPrompt
+        return 'PONYTAIL MODE ACTIVE — level: ' + mode + '\n\n' + compactSpec;
+      }
+    });
+  }, 'ponytail always-on section');
+
+  ctx.effect(function () {
+    return ctx.commands.register({
+      name: 'ponytail',
+      description: 'Set ponytail intensity (lite|full|ultra|off), or report the current level',
+      handler: function (invocation) {
+        var id = invocation.agent && invocation.agent.id;
+        var arg = (invocation.rawInput || '').trim().toLowerCase();
+        if (arg !== '') {
+          if (!MODES.includes(arg)) return { kind: 'error', text: 'Usage: /ponytail [lite|full|ultra|off]' };
+          if (id !== undefined) modeById.set(id, arg);
+        }
+        var current = id !== undefined && modeById.has(id) ? modeById.get(id) : DEFAULT_MODE;
+        return { kind: 'success', text: 'PONYTAIL MODE ' + current.toUpperCase() };
+      }
+    });
+  }, 'ponytail mode command');
+
+  // 只抓一次: fetch only missing skill files; reuse present ones forever.
+  (async function bootstrap() {
+    if (compactSpec === '') {
+      var compact = await fetchUrl(COMPACT_REL);
+      if (compact !== null) { compactSpec = compact; saveFile(compactCacheFile(), compact); }
+    }
+
+    // Full ruleset + 5 companions: each is a skill fetched once directly into
+    // ~/.dsh/skills/<name>/SKILL.md — the skill file IS the cache anchor.
+    var fetched = 0;
+    var skills = [MAIN].concat(COMPANIONS);
+    for (var i = 0; i < skills.length; i++) {
+      var name = skills[i];
+      if (existsSync(skillFile(name))) continue;
+      var content = await fetchUrl('skills/' + name + '/SKILL.md');
+      if (content !== null) { saveFile(skillFile(name), content); fetched += 1; }
+    }
+
+    console.log('[dsh-ponytail] ready: compact=' + (compactSpec !== '' ? 'ok' : 'MISSING') + ', skills fetched=' + fetched + ' (rest cached)');
+  })();
+
+  return undefined;
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@njuptlzf/dsh-ponytail",
+  "version": "1.1.0",
+  "description": "Ponytail (lazy-senior-dev) as a mode-switchable, always-on DSH plugin: injects the COMPACT ruleset every step (off empties it) and mirrors the full ruleset + five companions into ~/.dsh/skills. Attribution: github.com/DietrichGebert/ponytail (MIT).",
+  "type": "module",
+  "main": "index.js",
+  "exports": {
+    ".": "./index.js",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "index.js",
+    "cordis.patch.yml"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=22"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "cordis",
+    "plugin",
+    "ponytail",
+    "lazy-senior-dev",
+    "skill"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/njuptlzf/dsh-ponytail.git"
+  }
+}