@tyhld/conductor 0.12.145 → 0.12.147

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tyhld/conductor",
3
- "version": "0.12.145",
3
+ "version": "0.12.147",
4
4
  "description": "采配くん管制の見守りアプリ(conductor-agent)。各PCで常駐し、中央(devlog-tracker)へ定期的に生存報告(heartbeat)を送る常駐CLI。",
5
5
  "type": "module",
6
6
  "bin": {
@@ -137,11 +137,13 @@ description: 采配くんの便(プロンプト末尾に CONDUCTOR_JOB:<id>
137
137
  - **なぜ(置き場の話)。** 実機 2026-09-03: ai-saku の画面便(PR#258・PR#269)で、検品用の使い捨てページ `_layout-check.html` をリポジトリ直下に作り、`rm -rf` で消そうとして止められ、人が2回消した。**禁止の一覧と番人の制限は正しい(緩めない)。悪いのは置き場。**
138
138
  - **なぜ(後片付けの話を改めた理由)。** 旧い文言は「リポジトリ直下は番人が `rm` を止めるので自分で消さず報告」だった。実測(便 fb248f6e)では、`-f` を付けない `rm -r` と実在のパスの名指しなら、リポジトリ直下の自分の作業ファイルも通る。止まるのは `-f` 付きと変数・`*` 入りだけ。**止まらない形を「止まる」と書いていると、職人が自分の残骸を残したまま便を終える**ので、実物に合わせた(番人・禁止の一覧は1行も変えていない)。
139
139
  - 置き場を `/tmp/claude-1000/` にすれば、止められることも、残骸がコミットに混ざることも起きない(根治=鉄則10)。Playwright の検品ページも同じ(鉄則8-④)。
140
- - **空振り確認(直しをわざと外して、試験が落ちるのを見る)も、使い捨ての複製の中だけで行う(えふさん確定 2026-10-03・便 4cf71dde の要判断②)。**
141
- - 形: `git clone --no-hardlinks <リポの実在のパス> /tmp/claude-1000/karaburi-<便IDの頭8文字>` → その中で直しを外す → 試験を流す → 終わったら `rm -r /tmp/claude-1000/karaburi-<便IDの頭8文字>`(`-f` を付けない・名指し)。
142
- - ★**作業ツリーの中で直しを外さない**(戻し忘れがそのまま PR に入る)。★**`git worktree` を使わない**:囲いが `.git/worktrees` を読み取り専用で重ねるので、`git worktree remove` が「Device or resource busy」で止まり、職人が片付けられない(便 4cf71dde で再現)。複製なら囲いにも番人にも止められずに片付く。
143
- - 複製の中でも記録に入れるときは名指しで `git add <ファイル>`(鉄則1-④)。複製は GitHub へ push しない。
144
- - ★**複製の置き場は `/tmp/claude-1000/` だけ。** 複製の用意(部品をそろえる・写しを作る等)で番人・囲いに止められたら、**置き場をリポジトリの中へ移さず**、別の写し方も試さず、止められた命令の全文と番人の文を報告して止まる(鉄則4)。空振り確認は、できなかったことを報告に書けばよい(回避して通す物ではない)。
140
+ - **空振り確認(直しをわざと外して、試験が落ちるのを見る)は、複製を作らず作業場所の中で行う(えふさん確定 2026-10-21・便 a5b58031。2026-10-03 の「使い捨ての複製」の決めは、この決めで置き換えた)。**
141
+ - 形(確かめたい所の数だけ、1か所ずつ繰り返す): ① 直しを**記録(コミット)した後で**、直した所を**1か所だけ**戻す → ② 変えた所の試験を名指しで流し、**落ちるのを見る** → ③ `git checkout -- <そのファイル>` で戻す → ④ `git status` と `git diff` が空(作業前から在った変更を除く)なのを**毎回**確かめる。
142
+ - ★**複製・`ln`・部品の置き場(`node_modules` 等)の写し・`git clone`・`git worktree` を空振り確認に使わない。** 複製には部品の置き場が無いので、`ln -s` で元の置き場を指そうとして番人に `danger`(folder too large to verify for secrets)で止められ、便が途中で止まった(2026-10-21 に3回・便 2b63daf8・215c4e27・d6b8179f の系列)。番人は正しく止めているので変えない。作業場所の中で戻す形は、2026-10-15 以降の便(a389ff87・521d440e など)で番人に止められずに通っている。
143
+ - ★**戻すのは記録した後だけ。** 記録する前に戻すと、`git checkout --` で直しそのものが消える。
144
+ - ★**戻すのも元に戻すのも、名指しの1ファイルだけ。** `git checkout -- .` のようにまとめて戻さない(作業前から在った変更・未追跡のファイルまで巻き込む)。
145
+ - ★**④が空でなければ、次へ進まない**(記録・push をしない=戻した物を PR に入れない)。③をやり直しても空にならなければ、報告して止まる(鉄則4)。
146
+ - 空振り確認ができなかったときは、できなかったことを報告に書けばよい(回避して通す物ではない)。
145
147
  14. **`.env` 類(`.env`・`.env.local`・`.env.example` などの雛形も含む)は職人が書き換えない(えふさん確定 2026-09-18・便 3d11f913)**
146
148
  - **番人は `.env` 本体も `.env.example` などの雛形も、書き込みを止める**(Write/Edit の設定 deny と、Bash の `echo`/`tee`/`sed -i`/`cp`/`mv` などを、経路を問わず同じ結果にそろえた)。読み込みは今までどおり(雛形は読める・本物は読めない)。
147
149
  - **なぜ。** 雛形(`.env.example`)は普通は秘密値を置かないが、「exampleだから常に安全」と番人へ例外を作ると、将来誤って実値が書かれたときの穴になる(利便性より安全側・えふさん確定)。
@@ -160,6 +162,17 @@ description: 采配くんの便(プロンプト末尾に CONDUCTOR_JOB:<id>
160
162
  - **書き方。** 専門用語(rebase / squash / lint / CI 等)を避け、**何が進んだか**を書く。秘密の値・鍵・`.env` の中身は1文字も書かない(鉄則12)。
161
163
  - **道具の一言説明(description)も同じ画面に出る。** だから下の「作業中の確認の一言説明」は、確認カードだけでなく**この画面の材料**でもある。英語で書かない・「何をするか」が一目で分かる日本語にする。
162
164
 
165
+ ## 手元で流す検査(えふさん確定 2026-10-21・便 2a97c9da)
166
+
167
+ 合流まで行く便の時間の半分近くが、CI と同じ試験を手元でもう1回流す時間と、本番の配備を待つ時間だった(直近25便の中央値 25分のうち 手元のリポ全体の試験 約9分・配備待ち 約4分)。CI が同じ物を流すので、手元では二重に流さない。
168
+
169
+ - **① 手元で流すのは4つだけ。** 型確認・build/**変えた所の試験**(足した・直した試験ファイルと、変えたコードを見ている試験ファイルを名指しで流す)/空振り確認(鉄則13 のやり方=複製を作らず作業場所の中で、記録した後に1か所だけ戻して落ちるのを見て、`git checkout --` で戻す)。**リポ全体の試験は手元で流さず、CI に任せる。**
170
+ - ★**CI が緑でなければ合流しない、は今までどおり**(鉄則7)。手元を絞った分、CI の結果が唯一の全体の確かめになる。
171
+ - ★**CI が無いリポ**(鉄則7-④)は今までどおり、リポに在る検査を手元ですべて流してから合流する(CI に任せる先が無い)。
172
+ - **② 「直す前と比べるため」に全部の試験をもう1回流さない。** 比べる相手が要るときは、**main の最新の CI の結果**(`gh run list --branch main --limit 1`・`gh run view <実行ID>`)を使う。
173
+ - **③ 報告に書く試験の数**(試験ファイル数/試験数/PASS/FAIL/SKIP)は、**この便の PR の CI の結果**から書く(`gh run view <実行ID> --log` の集計の行)。手元で流した「変えた所の試験」の数は、それと分けて書く。
174
+ - **④ 職人は本番の配備(Vercel 等の READY)を待たない。** 画面を変えた便の配備先の版は CC1/管制が確かめる(便の終え方 ⓪(b))。★npm の公開版(配布物を変えた便)は公開が職人の流れの中で起きるので、今までどおり職人が確かめる。
175
+
163
176
  ## 番人に止められる常連(こう書くと止まる → 代わりにこう書く)
164
177
 
165
178
  止まる書き方を最初から使わなければ、打ち直しの往復が要らない。★番人の判定は変えない(弱めない)。
@@ -203,7 +216,8 @@ description: 采配くんの便(プロンプト末尾に CONDUCTOR_JOB:<id>
203
216
  - ★**この形の番人の文は `discipline`(書き方の注意・直し方つき)になった**(便 227aeebb・2026-10-10)。それまでは `danger: redirect into system path (/dev)` と出ており、実態(無害)と合っていなかった。**止まること自体は変わらない。**④の(ア)〜(エ)がそろう限り、上の通る例へ書き直して続けてよい(⑥のとおり報告に3つを書く)。
204
217
  - ★**ただし、貼り付きの手前が `/dev/null` などの無害な捨て先でない形は `danger` のまま止まる**(`V="$(a 2>/etc/hosts)"` のような本物の書き込み/貼り付きを外しても同じ行に危険が残る形)。その場合は書き直さず報告して止まる。
205
218
  - **リポジトリの中の部品の置き場の下に、使い捨ての作業用コピーを作る**(`node_modules`・`site-packages`・`.venv`・`venv` の下へ `git clone`・`cp -r`・`rsync`・`tar -x -C`・`mv`・`ln`・`mkdir` で作業用の写しや置き場を作る)→ 止まる(便 99edd7bf)。記録される場所の中に出来るので記録に混ざる危険が残り、片付け(再帰の削除)も止められて残骸になる。**使い捨ての置き場は `/tmp/claude-1000/` の下にする**(鉄則13)。
206
- - 通る例: `git clone --no-hardlinks <リポの実在のパス> /tmp/claude-1000/karaburi-<便IDの頭8文字>`
219
+ - 通る例: `mkdir -p /tmp/claude-1000/<作業名>`(使い捨ての物は `/tmp/claude-1000/` の下に置く)
220
+ - ★**空振り確認には写しも置き場も要らない。** 複製を作らず作業場所の中で行う(鉄則13)。番人の文に出る `git clone … /tmp/claude-1000/karaburi-…` の例は、空振り確認に複製を使ってよいという意味ではない。
207
221
  - ★番人の文は `discipline`(書き方の注意・直し方つき)。通常の部品取得・部品の読み取り・組み立てと試験が作る控え・名指しの削除は巻き込まれない。
208
222
  - **`-f` 付き、または中身が変わる場所を指す再帰の `rm`**(`rm -rf`・`rm -fr`・`rm -r -f`・`rm -R`・`rm --recursive`/`rm -r "$DIR/x"`・`rm -r build/*` のように変数や `*` を含む)→ 止まる。`-f` 付きは配布している禁止の一覧(現場の `.claude/settings.json` の deny)で**必ず**止まる(番人より先に効く=消す先が作業ファイルでも通らない・便 fb248f6e)。変数・`*` は番人が止める。**`-f` を付けず、消す先を実在のパスで名指しする**(`/tmp/claude-1000/` の下・鉄則13)。★止められたら**別の消し方を探さず**(`find -delete`・`python -c` 等に回らない)、消せなかった場所を報告に書く(鉄則4)。
209
223
  - 通る例: `rm -r /tmp/claude-1000/作業名` / `rm -r node_modules/.tmp-作業名`(★`-f` を付けない・自分で作った物だけ)
@@ -227,7 +241,7 @@ description: 采配くんの便(プロンプト末尾に CONDUCTOR_JOB:<id>
227
241
 
228
242
  ⓪ **★報告を書く前に、「反映された」を実物で確かめる**(えふさん確定 2026-10-02 夜・便 7aa63a97)。**報告到着 ≠ 完了/職人終了 ≠ 受入完了。** 職人への指示は反映(合流・公開・本番反映)まで終わらせる。次の3つを、**自分の言葉ではなく実物の出力で**確かめてから①へ進む。
229
243
  - **(a) 合流したか** … 鉄則7-★の確かめ方(`gh pr view <番号> --json state,baseRefName,mergeCommit` が `MERGED` + `git merge-base --is-ancestor <合流コミット> origin/<合流先>`)。★**合流を予約しただけ(`--auto`)は「終わり」ではない。** 予約は GitHub が後から合流するので、**予約したまま手番を閉じると便が死ぬ**(実地 47bdfe00)。鉄則7-★の4段の塊を使えば ④ が最後まで待つ。
230
- - **(b) 公開版/本番が新しくなったか** … 配布物を変えた便なら `npm view <パッケージ> version` が上げた版になっていること。画面を変えた便なら配備先の版。★**変えていない便は「変えていない」と確かめる**(確かめを省くのではない)。
244
+ - **(b) 公開版/本番が新しくなったか** … 配布物を変えた便なら `npm view <パッケージ> version` が上げた版になっていること。★画面を変えた便の配備先の版(Vercel 等の READY)は**職人は待たない・確かめない**(CC1/管制が確かめる=「手元で流す検査」④・えふさん確定 2026-10-21)。★**変えていない便は「変えていない」と確かめる**(確かめを省くのではない)。
231
245
  - **(c) 背景に回した待ちが残っていないか** … ★**待ちを背景に残したまま手番を閉じない。** 画面なし方式(`claude -p`)では**手番の終わり=処理の終わり**で、背景の待ちはその瞬間に殺され、職人は二度と起きない(実地 915694ac:「まだ実行中です。終わり次第、結果を確かめます。」で手番を閉じ、報告は下書きのまま便が死んだ)。**この手番の中で待ち切る。**
232
246
  - ★**CI・合流・配備・公開の完了は、繰り返し(`until`・`while`・`for` + `sleep`)で待たない**(けいさん確定 2026-10-10・便 de82bc3a。番人が `discipline` で止める)。CI は `gh run watch <実行ID> --exit-status` を**1回**打って前面で待ち切る。状態を見るだけなら `gh pr checks <番号>`・`gh pr view <番号> --json state`・`gh run view <実行ID>` を**1回ずつ**(どれも即返る)。合流の完了は**鉄則7-★の4段の塊**の ④ が上限(`WAIT`・既定600秒)付きで待ち切るので、自分で待ちの繰り返しを書き起こさない。
233
247
  - ★**それ以外の待ち**(目印のファイルが出るのを待つ・配信の読み置き60秒を待つ・背景に回した命令の完了を待つ)は今までどおり。`Monitor` を使うか、1回だけの `sleep`、または CI と関係の無い条件の待ちで、この手番の中で待ち切る。