@dorokuma/herdsman 0.11.6 → 0.13.2

package/drizzle/meta/_journal.json

@@ -71,6 +71,13 @@
       "when": 1788403075026,
       "tag": "0009_high_lake",
       "breakpoints": true
+    },
+    {
+      "idx": 10,
+      "version": "6",
+      "when": 1790610020312,
+      "tag": "0010_legacy_degraded_cleanup",
+      "breakpoints": true
     }
   ]
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dorokuma/herdsman",
-  "version": "0.11.6",
-  "description": "Agent history daemon and runtime bridges for Herdr-managed coding agents. Forked from @ryonakae/herdsman.",
+  "version": "0.13.2",
+  "description": "Agent history daemon and runtime bridges for Herdr-managed coding agents.",
   "type": "module",
   "files": [
     "dist",
@@ -75,8 +75,5 @@
   "lint-staged": {
     "*.{js,jsx,ts,tsx,json,jsonc}": "biome check --write --no-errors-on-unmatched"
   },
-  "author": "dorokuma",
-  "contributors": [
-    "Ryo Nakae (https://github.com/ryonakae)"
-  ]
+  "author": "dorokuma"
 }

package/README.ja.md

@@ -1,145 +0,0 @@
-![Herdsman cover](./assets/herdsman-cover.png)
-
-# Herdsman
-
-<!-- README-I18N:START -->
-[English](./README.md) | **日本語**
-<!-- README-I18N:END -->
-
-Herdsman は、Herdr で動く coding agent の状態を記録する daemon ベースの観測ツールです。CLI から構造化された履歴を取得でき、Pi では owner だけに cached context と通知を送り、必要なときに自動で wake します。
-
-Herdr の `herdr agent read` は terminal stream や scrollback を読みます。Herdsman は agent の session data から作業状況、message の抜粋、compact tool result、未読の outcome を取得します。Herdsman は agent を操作しません。agent の start、prompt、wait、pane 操作、terminal control には公式 Herdr CLI または skill を使います。
-
-現在は Claude Code、Codex、Gemini CLI、OpenCode、Pi、Grok、Antigravity CLI のセッション履歴の取得に対応しています。
-
-## 要件
-
-- Node.js >= 24.18.0
-- Herdr >= 0.7.0
-- `herdsman-pi` を使う場合は Pi >= 0.80.6
-
-## インストール
-
-```bash
-npm install --global @dorokuma/herdsman
-herdsman help
-```
-
-### ソースからインストールする
-
-ソースからbuildする場合はpnpm >= 11.9.0も必要です。
-
-```bash
-git clone https://github.com/dorokuma/herdsman.git
-cd herdsman
-pnpm install
-pnpm build
-npm install --global . --ignore-scripts
-herdsman help
-```
-
-## daemon を起動する
-
-Herdsman のagent commandとPi notificationはdaemonを必要とします。daemon は `herdr session list --json` に出る実行中の Herdr session を監視し、60 秒ごとに再スキャンします。停止した Herdr session は index しません。runtime file は標準で `~/.herdsman` に置きます。別の directory を使う場合は `HERDSMAN_HOME` を設定します。
-
-```bash
-herdsman daemon start
-```
-
-## 主なコマンド
-
-- `herdsman agent list`: 選択した workspace の最新キャッシュから status と最後の user / assistant message の抜粋を返します。鮮度が必要なときは各行の `updatedAt` を確認します。
-- `herdsman agent get <target>`: 明示的に詳細を取得し、1 agent の metadata、compact history、最新の compact tool result を返します。
-- `herdsman agent read <target> --limit N`: 明示的に履歴を読み、直近 N 件の user / assistant / compact `tool_result` message を返します。
-
-各 agent record は、`reviewer` のような Herdr の live `name` と、`codex` のような runtime `agent` kind を別々に保持します。通常の list 出力では `name` と `agent` を別の column に表示し、JSON でも両方を返します。Herdr workspace 内では、Herdsman が current workspace を自動で選びます。
-
-```bash
-herdsman agent list --json
-herdsman agent get reviewer --json
-herdsman agent read reviewer --limit 20 --json
-```
-
-Herdr の外から読む場合は scope を指定します。
-
-```bash
-herdsman agent list --all --json
-herdsman agent list --workspace wB --json
-herdsman agent get reviewer --workspace wB --json
-herdsman agent read wB:p2 --workspace wB --limit 20 --json
-```
-
-`<target>` は、選択した scope 内で pane id、terminal id、Herdsman agent id の完全一致を最初に探します。次に `reviewer` のような Herdr live name を探し、live name が一致しない場合だけ `codex` のような一意の agent kind を使います。複数の running Herdr session で target が曖昧になる場合は `--session <name>` を付けます。
-
-## Agent Skill
-
-Agent Skill を追加する前に、Herdsman CLI をインストールして daemon を起動します。次のコマンドで、対応する coding agent に Herdsman の手順を追加します。
-
-```bash
-npx skills add dorokuma/herdsman --skill herdsman -g
-```
-
-Herdsman skill は agent の status、compact history、直近の tool result を構造化データとして読み取ります。agent の確認だけなら、Herdsman skill を単独で使えます。
-
-workspace、tab、pane、terminal input/output、wait も agent から操作する場合は、公式 Herdr skill を追加します。
-
-```bash
-npx skills add ogulcancelik/herdr --skill herdr -g
-```
-
-## Pi extension
-
-Piからextensionをインストールします。
-
-```bash
-pi install npm:@dorokuma/herdsman-pi
-```
-
-extensionにはPi 0.80.6以降が必要です。PiがHerdr内で動くとHerdsman daemonに接続します。接続中のPiはoffの状態でも正確なPi session pathをpresence identityとして登録します。extensionはturnごとのtool resultやmessageのtelemetryは送信しませんが、自身の最終assistant messageがsession fileに書き込まれた後にturn完了シグナルをdaemonへ送るため、completed/blocked outcomeには空でない最終応答が含まれます。
-
-Piで`/herdsman on`を入力すると、そのterminalが現在のHerdr sessionとworkspaceにおける唯一のHerdsman ownerになります。cached current-workspace agent context、pending件数、agent update、自動wakeを受け取るのはownerだけです。contextからowner自身のPi terminalを除き、ほかのPi terminalを含めます。通常のpromptではdaemon RPCや履歴読み込みを待たず、local cacheのsnapshotを挿入します。起動直後、reconnect直後、scope移動直後はsnapshotが届くまでcontextが一時的にない場合があります。
-
-agentが完了またはblockedになると、visibleなHerdsman turnを1回開始します。通常のuser runが実行中なら、Herdsmanはsettleを待ちます。themed cardは最大3件を表示し、Piのexpand keyで全outcomeと長さを制限した最終responseを確認できます。nameがあるagentは`reviewer · Codex`、ないagentは`Codex`と表示します。agentの出力は信頼できない参考情報として扱い、Piは既存のuser requestに必要な作業だけを続けます。
-
-現在のPiの状態は`/herdsman`または`/herdsman status`で確認し、`/herdsman off`でそのPiのowner動作を解除します。offにしても別のownerへは影響しません。offまたはnon-ownerのPiは後でclaimできるよう接続を保ちますが、hidden agent context、pending件数、update、wakeは受け取りません。onのPiだけがfooterに`◆ Herdsman`を表示し、未処理のoutcomeがある間は`· N agent updates`が付きます。updateを含むturnが最終assistant responseを生成してsettleし、元のeventをacknowledgeすると件数が消えます。直前までonだったPiが接続を失うと、復旧中は`◇ Herdsman · reconnecting`を表示します。ownerがいない間はoutcomeを配信せず、その間に発生したoutcomeは後からclaimしてもreplayしません。reload、reconnect、別Piによる直接のowner交代では、未acknowledgedのoutcomeを保持します。ownershipはPi sessionの切り替えやpaneの移動後も同じHerdr terminalに追従し、そのterminalがgrace periodを超えて切断された場合は解除されます。
-
-## Herdr plugin
-
-任意のpluginはGitHub Releaseのtagからインストールします。
-
-```bash
-herdr plugin install dorokuma/herdsman/packages/herdsman-herdr-plugin --ref v0.11.6 --yes
-```
-
-インストール済みの Herdsman CLI と同じバージョンの release tag を指定してください。
-
-plugin は Herdsman daemon に接続し、current Herdr workspace の compact agent row を Herdr UI に表示します。row には live name と runtime kind の column、cached history の抜粋が含まれます。Herdrはrepository subdirectoryからpluginをインストールします。npmには公開せず、CLIとPi extensionだけを使う場合は不要です。
-
-## パッケージ
-
-| Path | 配布方法 | Purpose |
-| --- | --- | --- |
-| repository root | npm: `@dorokuma/herdsman` | Herdsman CLIとdaemon。 |
-| `packages/herdsman-pi` | npm: `@dorokuma/herdsman-pi` | agent historyとagent updateのPi extension。 |
-| `packages/herdsman-herdr-plugin` | GitHub Releaseのsubdirectory | 任意のHerdr UI integration。npm packageではありません。 |
-
-## 開発
-
-```bash
-pnpm install
-pnpm check
-pnpm build
-```
-
-package検証、npm公開、GitHub Releaseの手順は[Releasing Herdsman](./docs/releasing.md)に記載しています。
-
-DB schema を変えたら次も実行します。
-
-```bash
-pnpm db:generate
-pnpm db:check
-```
-
-## ライセンス
-
-[MIT](./LICENSE)