@tyhld/conductor 0.12.173 → 0.12.175

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/dist/headless.js CHANGED
@@ -19,10 +19,10 @@ import { createInterface } from 'node:readline';
19
19
  import { createWriteStream, existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, rmSync, statSync, unlinkSync, writeFileSync } from 'node:fs';
20
20
  import path from 'node:path';
21
21
  import os from 'node:os';
22
- import { CENTRAL_BUSY_HOLD_MAX_MS, RELAY_DELIVER_MAX, RELAY_FETCH_TIMEOUT_MS, RELAY_HEARTBEAT_INTERVAL_MS, RELAY_RESTORE_ORPHANS_ENABLED, ackResumeSignal, buildAnchor, buildSendText, canDeliver, completeWithReportOutcome, createRelayState, deliverJobEndFacts, deliveryReport, fetchCommand, fetchCommandState, fetchCommandStatus, fetchControlWithUpdate, fetchOrphans, flushPendingJobEndFacts, isTerminalCommandStatus, kindOf, markDelivered, noteCentralDown, noteCentralUp, noteDrain, noteReadiness, patchStatus, pruneLogLine, pruneStaleWorktrees, recoverStuckProcessedReports, reconnectDelayMs, WAIT_CLOSED_STATUS, FINISH_GATE_KINDS, reportDelivery, selectOrphanToRestore, sendHeartbeat, } from './relay.js';
22
+ import { CENTRAL_BUSY_HOLD_MAX_MS, RELAY_DELIVER_MAX, RELAY_FETCH_TIMEOUT_MS, RELAY_HEARTBEAT_INTERVAL_MS, RELAY_RESTORE_ORPHANS_ENABLED, ackResumeSignal, buildAnchor, buildSendText, canDeliver, completeWithReportOutcome, createRelayState, deliverJobEndFacts, deliveryReport, fetchCommand, fetchCommandState, fetchCommandStatus, fetchControlWithUpdate, fetchOrphans, flushPendingJobEndFacts, isTerminalCommandStatus, kindOf, markDelivered, noteCentralDown, noteCentralUp, noReportEndNote, noteDrain, noteReadiness, patchStatus, pruneLogLine, pruneStaleWorktrees, recoverStuckProcessedReports, reconnectDelayMs, WAIT_CLOSED_STATUS, FINISH_GATE_KINDS, reportDelivery, selectOrphanToRestore, sendHeartbeat, } from './relay.js';
23
23
  import { claudePinPath, readClaudePinLine, } from './autoupdate-flags.js';
24
24
  import { cleanupJobWorkDir, jobWorkDirGuide, prepareJobWorkDir, stayInRepoDir, } from './job-workdir.js';
25
- import { clearUsageHold, detectUsageLimit, formatJst, mergeUsageLimit, placeUsageHold, readUsageHold, saveLimitResume, takeLimitResume, usageHoldNotice, usageLimitLabel, } from './usage-limit.js';
25
+ import { authHoldHit, clearUsageHold, detectUsageLimit, formatJst, mergeUsageLimit, placeUsageHold, readUsageHold, saveLimitResume, takeLimitResume, usageHoldNotice, usageLimitLabel, } from './usage-limit.js';
26
26
  const log = (msg) => {
27
27
  console.log(`[headless] ${msg}`);
28
28
  };
@@ -1611,6 +1611,16 @@ async function checkRunningJob(cfg, state) {
1611
1611
  ? null
1612
1612
  : `Claude の${usageLimitLabel(usageHit.limitType)}に当たって終わりました(失敗にせず待ちに戻します)` +
1613
1613
  (usageHit.text ? `: ${usageHit.text}` : '');
1614
+ // ★時間切れで、報告ファイルが1つも無い便(便 eb63dba5・実地 e947eff3)。送り直せる物が無いので、
1615
+ // 「報告なしで終わった」ことを終わりの事実と失敗の理由の両方で管制へはっきり知らせる。
1616
+ const noReportNote = job.timedOut
1617
+ ? noReportEndNote({
1618
+ endKind: 'timeout',
1619
+ phase: reportDelivery(job.commandId).phase,
1620
+ lastActivityAt: job.lastActivityAt,
1621
+ finishedAt: job.finishedAt ?? Date.now(),
1622
+ })
1623
+ : null;
1614
1624
  // ★再開するかもしれない便だけ、終わりの事実を届ける前に「停止の依頼」を1回確かめる
1615
1625
  // (けいさん決定 2026-10-07・便 fbdd7482)。
1616
1626
  //
@@ -1695,6 +1705,7 @@ async function checkRunningJob(cfg, state) {
1695
1705
  ?? (unknownExternalEnd ? unknownExternalEndDetail(job.exitCode, job.exitSignal) : null)
1696
1706
  // ★利用上限で終わった便(便 27a9fb19)。異常終了とは別の理由だと分かる一言を載せる。
1697
1707
  ?? usageDetail
1708
+ ?? noReportNote
1698
1709
  ?? delivery.note
1699
1710
  ?? `attempt ${job.attempt}/${HEADLESS_MAX_ATTEMPTS}`,
1700
1711
  // ★上限に達して「途中で終わった」便だけに付ける(管制が機械で見分けられる形)。
@@ -1704,7 +1715,8 @@ async function checkRunningJob(cfg, state) {
1704
1715
  if (job.timedOut) {
1705
1716
  // 上限時間で強制停止した → 管制へ理由つきで failed を記録する
1706
1717
  const elapsed = Math.round((Date.now() - job.startedAt) / 1000);
1707
- const reason = `上限時間(${Math.round(CENTRAL_BUSY_HOLD_MAX_MS / 1000)}s)で強制停止 (実行${elapsed}s, exit=${job.exitCode}, signal=${job.exitSignal})`;
1718
+ const reason = `上限時間(${Math.round(CENTRAL_BUSY_HOLD_MAX_MS / 1000)}s)で強制停止 (実行${elapsed}s, exit=${job.exitCode}, signal=${job.exitSignal})` +
1719
+ (noReportNote !== null ? `。${noReportNote}` : '');
1708
1720
  await sendCommandEvents(cfg, job.commandId, [{
1709
1721
  type: 'error',
1710
1722
  text: reason.slice(0, EVENT_TEXT_MAX),
@@ -1797,14 +1809,30 @@ async function checkRunningJob(cfg, state) {
1797
1809
  at: new Date().toISOString(),
1798
1810
  attempt: job.attempt,
1799
1811
  }]);
1800
- // ★中央へ failed を返す(次の便が止まらないように)
1801
- await patchStatus(cfg, job.commandId, 'failed', authMsg);
1802
- rs.abandoned.add(job.commandId);
1803
- noteLastJob('auth_error', authMsg);
1812
+ // ★ログイン切れは便の中身ではなく PC の状態(便 6d0b403f・実地 2026-10-28 に3便続けて failed)。
1813
+ // 利用上限と同じく、この便は failed にせず「待ち」に戻し、PC で1つの札でほかの便の配達も止める。
1814
+ // ★続きからではなく新しい会話で起こし直す(fresh)。やり直しの回数も使わせない。
1815
+ // ★作業場所は片付ける(新しい会話は新しい作業場所で起こす。変更が残っていれば消さずに残る)。
1816
+ const placed = placeUsageHold(authHoldHit(detail), { site: cfg.site, commandId: job.commandId });
1817
+ saveLimitResume(cfg.site, { commandId: job.commandId, sessionId: '', attempt: job.attempt, fresh: true });
1818
+ state.attempts.set(job.commandId, job.attempt);
1819
+ if (!(await patchStatus(cfg, job.commandId, 'queued'))) {
1820
+ (state.requeuePending ??= new Set()).add(job.commandId);
1821
+ }
1822
+ if (placed.created) {
1823
+ await sendCommandEvents(cfg, job.commandId, [{
1824
+ type: 'progress',
1825
+ text: usageHoldNotice(placed.hold, cfg.machine).slice(0, EVENT_TEXT_MAX),
1826
+ at: new Date().toISOString(),
1827
+ attempt: job.attempt,
1828
+ }]);
1829
+ }
1830
+ noteLastJob('auth_error', `${authMsg}・失敗にせず待ちに戻しました(試し直し ${formatJst(placed.hold.resumeAtMs)} 日本時間)`);
1804
1831
  await finishJobWorkDir(cfg, job);
1805
1832
  state.job = null;
1806
1833
  rs.lastHeartbeatAt = null;
1807
- log(`WARN site=${cfg.site} id=${job.commandId} 認証エラー → 再試行しない`);
1834
+ log(`WARN site=${cfg.site} id=${job.commandId} 認証エラー → 失敗にせず待ちに戻し、` +
1835
+ `この PC の配達を ${formatJst(placed.hold.resumeAtMs)}(日本時間)まで止めます`);
1808
1836
  return;
1809
1837
  }
1810
1838
  if (job.exitCode === 0) {
@@ -2719,10 +2747,13 @@ export async function headlessTick(cfg, state, hooks) {
2719
2747
  return;
2720
2748
  }
2721
2749
  // ── claude -p を起動 ──
2722
- const isResume = attempt > 1;
2750
+ // ★ログイン切れで待ちに戻した便は、新しい会話で起こし直す(便 6d0b403f)。
2751
+ // 会話IDは試行番号ごとに別なので、前の回と重ならない。
2752
+ const freshAfterHold = limited?.fresh === true;
2753
+ const isResume = attempt > 1 && !freshAfterHold;
2723
2754
  // resume: 前回のセッション ID を渡す。fresh start: 新しいセッション ID を作る。
2724
2755
  // ★利用上限の続きは、上限に当たった回の会話IDそのものを使う(便 27a9fb19)。
2725
- const sessionId = limited !== null
2756
+ const sessionId = limited !== null && !freshAfterHold
2726
2757
  ? limited.sessionId
2727
2758
  : isResume
2728
2759
  ? sessionIdForCommand(cmd.id, attempt - 1)
package/dist/relay.js CHANGED
@@ -2914,7 +2914,11 @@ export function buildSendText(body, site, anchor, kind = 'claude', context) {
2914
2914
  // ★Codex の職人には Codex にできることだけを頼む全文を付ける(便 cfa9eeec・codexCompletionGuide)。
2915
2915
  // 鉄則(~/.claude/skills)は Codex には届かないので、全文で渡すのは今までどおり。
2916
2916
  const guide = kind === 'codex' ? codexCompletionGuide(site, commandId) : shortCompletionLine(site, commandId);
2917
- const full = `${body}\n\n${dispatchContextBlock(context)}${guide}` +
2917
+ // ★Claude の職人には、どのチャットの便にも同じ「共通の型」を付ける(便 6d0b403f)。
2918
+ // 各チャットの本文に頼らず、途中で止まる書き方を最初から選ばせないため。正本は鉄則の同名の節。
2919
+ // ★Codex には付けない(鉄則も Read の道具も届かないので、書いてある道具が使えない)。
2920
+ const common = kind === 'codex' ? '' : `${craftCommonBlock()}\n\n`;
2921
+ const full = `${body}\n\n${dispatchContextBlock(context)}${common}${guide}` +
2918
2922
  // アンカー(管理用ジョブ印)は必ず本文の最後に置く。完了検出の境界として使う。
2919
2923
  `(管理用ジョブ印・変更不要: ${anchor})`;
2920
2924
  // 改行(と連続改行)を空白1個に潰し、前後を整える。
@@ -2939,6 +2943,34 @@ export function dispatchContextBlock(context) {
2939
2943
  }
2940
2944
  return lines.length > 0 ? `${lines.join('\n')}\n\n` : '';
2941
2945
  }
2946
+ /** 鉄則(conductor-craftsman の SKILL.md)の中の、共通の型の正本の見出し。 */
2947
+ export const CRAFT_COMMON_HEADING = '## 途中で止まらない書き方(全便の共通の型)';
2948
+ /**
2949
+ * どのチャットの便にも配り役が付ける「共通の型」(便 6d0b403f・えふさん決定 2026-11-04)。
2950
+ *
2951
+ * 【なぜ要るか】直近30日、途中で止まった便の多くは便の中身ではなく「止まりやすい書き方」だった
2952
+ * (元の場所を名指しした cd+grep を $(...) の中で動かした e879cf84/元の場所で python3 を動かした
2953
+ * e0796fcd/禁止のパイプ・grep を使った 62475b9e)。チャットごとに本文へ書き足していたので、
2954
+ * 書き忘れた便・書き方の違う便で同じ止まり方がくり返された。
2955
+ * 【決め】要点だけを全便に付ける。言い切りの正本は鉄則の CRAFT_COMMON_HEADING の節
2956
+ * (試験 craft-common-block が、ここに書いた項がすべて鉄則にもあることを確かめる)。
2957
+ * ★番人の判定は1つも変えない。止まらない書き方を最初から選ばせるだけ。
2958
+ */
2959
+ export const CRAFT_COMMON_ITEMS = [
2960
+ 'リポの元の場所(~/projects/<現場>)を命令に書かない。本文に元の場所が書かれていても、【作業場所】の段があればその場所へ読み替える',
2961
+ 'cd は起動した場所へ戻されることがある(Shell cwd was reset)。以後は絶対パス・git -C <場所>・npm --prefix <場所> で打つ',
2962
+ '$(...) の中に場所を書かない(値が要るときは先にその命令だけを打ち、出た値をそのまま書く)',
2963
+ 'ファイルの中身・一覧を読むのは Read の道具・ls・git ls-files。python3 -c・node -e・cat で読まない',
2964
+ '探すのは場所を名指しした git grep -n -e <語> -- <フォルダかファイル>。パイプ(|)・grep -r・rg・awk は使わない',
2965
+ '背景の調べ役(サブエージェント)は使わない(調べ役の命令も同じ番人に掛かり、1回の danger で便全体が止まる)',
2966
+ 'CI を待つのは gh run watch <実行ID> --exit-status を1回(繰り返しと sleep で待たない)',
2967
+ '番人に danger で止められたら別の道具へ替えず、止められた命令の全文と番人の文を報告に書いて終える',
2968
+ ];
2969
+ export function craftCommonBlock() {
2970
+ return (`【共通の型(配り役が全便に付ける・正本は鉄則の「途中で止まらない書き方」)】` +
2971
+ CRAFT_COMMON_ITEMS.map((s, i) => `${'①②③④⑤⑥⑦⑧⑨'[i]}${s}。`).join('') +
2972
+ `★便の本文の決まりがこれより厳しければ、本文に従う。`);
2973
+ }
2942
2974
  /** 鉄則(conductor-craftsman の SKILL.md)の中の、便の終え方の見出し。1行の案内はここを指す。 */
2943
2975
  export const CRAFTSMAN_FINISH_HEADING = '## 便の終え方';
2944
2976
  /**
@@ -5760,6 +5792,35 @@ export function jobEndFactsPath(site, commandId, env = process.env) {
5760
5792
  }
5761
5793
  /** 人向けの一言の上限(管制の列を汚さない)。 */
5762
5794
  const JOB_END_DETAIL_MAX = 500;
5795
+ /** 最後の動きから終わりまでがこれより長ければ「PC が止まっていた可能性」を添える。 */
5796
+ export const NO_REPORT_IDLE_GAP_MS = 30 * 60 * 1000;
5797
+ /**
5798
+ * 「報告なしで終わった便」を管制へはっきり知らせる一言(★純粋関数・便 eb63dba5)。
5799
+ *
5800
+ * 【なぜ要るか(実地 e947eff3・282e5926)】2026-11-04 夜に PC が止まり、戻ったときに上限時間を
5801
+ * 超えていた便が止められた。職人は報告を書く前(合流の確かめ・CI の待ち)だったので、報告ファイルは
5802
+ * どこにも無い=送り直せる物が無い。それなのに管制へ届く一言は `attempt 1/3` だけで、
5803
+ * 「報告が無いまま終わった・作った物が残っているかもしれない」ことが CC1 に伝わらなかった
5804
+ * (e947eff3 は PR #1383 が合流済みだった)。
5805
+ * 【★出すのは時間切れの便で、報告ファイルが1つも無いときだけ】
5806
+ * ・報告ファイルが在れば 30秒ごとの回収の道(sendPendingReportFiles)が送る=ここでは言わない。
5807
+ * ・形が整っていない報告は、今までどおり reportShapeNote が理由を言う。
5808
+ * ・異常終了(error)は自動でやり直す、止められた便(stopped)は人が止めた=どちらも続きの便は要らない。
5809
+ * 【★言うのは事実だけ】報告ファイルが無いこと・最後の動きの時刻。PC が止まっていたとは断定しない。
5810
+ */
5811
+ export function noReportEndNote(f) {
5812
+ if (f.endKind !== 'timeout' || f.phase !== 'none')
5813
+ return null;
5814
+ let text = '報告なしで終わりました(報告ファイルがありません=職人は報告を書く前に止まりました)。' +
5815
+ 'PR・合流など途中までの作業が残っていることがあるので、確かめと報告の続きの便が要ります';
5816
+ if (f.lastActivityAt !== null && f.finishedAt - f.lastActivityAt >= NO_REPORT_IDLE_GAP_MS) {
5817
+ const min = Math.round((f.finishedAt - f.lastActivityAt) / 60000);
5818
+ text +=
5819
+ `。最後の動きは ${new Date(f.lastActivityAt).toISOString()}(終わる${Math.floor(min / 60)}時間${min % 60}分前)` +
5820
+ '=その間 PC が止まっていた可能性があります';
5821
+ }
5822
+ return text;
5823
+ }
5763
5824
  /**
5764
5825
  * 管制へ送る本文(★純粋関数=単体テストできる)。
5765
5826
  *
@@ -100,13 +100,35 @@ export function usableResetsAt(hit, now) {
100
100
  }
101
101
  /** 配達を再開する時刻(ms)を決める(★純粋関数)。 */
102
102
  export function usageResumeAtMs(hit, now) {
103
+ if (hit.limitType === AUTH_HOLD_TYPE)
104
+ return now + AUTH_HOLD_WAIT_MS;
103
105
  if (usableResetsAt(hit, now))
104
106
  return hit.resetsAtMs + USAGE_LIMIT_MARGIN_MS;
105
107
  return now + USAGE_LIMIT_DEFAULT_WAIT_MS;
106
108
  }
109
+ /**
110
+ * ログイン切れの札の種類(便 6d0b403f)。
111
+ *
112
+ * 【なぜ要るか(実地)】2026-10-28 09:05〜09:12 JST、FshimaNP の Claude のログインが切れていて、
113
+ * 配られた便が3件(39c1a84e・6ec694a3・d9a849ca)続けて起動後約7秒で auth_error の failed になった。
114
+ * 2026-11-02 の TYHLD-GOTO(3790d74b)も同じ。ログイン切れは便の中身ではなく PC の状態なので、
115
+ * 利用上限と同じく「この便は待ちに戻し、その PC への配達を止める」。
116
+ * 【決め】戻る時刻は分からない(人がログインし直すまで)。AUTH_HOLD_WAIT_MS ごとに1便だけ試し直す
117
+ * (ログインし直していれば、そのまま配達が戻る)。人は `conductor resume-delivery` で今すぐ戻せる。
118
+ * ★待ちに戻した便は、新しい会話で起こし直す(ログイン切れの回の会話は残っていないことがあるため)。
119
+ */
120
+ export const AUTH_HOLD_TYPE = 'auth';
121
+ /** ログイン切れのとき、試し直すまで待つ長さ。 */
122
+ export const AUTH_HOLD_WAIT_MS = 60 * 60_000;
123
+ /** ログイン切れを「待ちの札」の形にする(★純粋関数)。戻る時刻は読めないので null。 */
124
+ export function authHoldHit(text = null) {
125
+ return { limitType: AUTH_HOLD_TYPE, resetsAtMs: null, text };
126
+ }
107
127
  /** 上限の種類の日本語。 */
108
128
  export function usageLimitLabel(limitType) {
109
129
  switch (limitType) {
130
+ case AUTH_HOLD_TYPE:
131
+ return 'ログイン切れ';
110
132
  case 'seven_day':
111
133
  case 'seven_day_opus':
112
134
  case 'seven_day_sonnet':
@@ -216,6 +238,11 @@ export function clearUsageHold(file = holdFilePath()) {
216
238
  /** 管制へ1回だけ送る知らせの文。 */
217
239
  export function usageHoldNotice(hold, machine) {
218
240
  const when = formatJst(hold.resumeAtMs);
241
+ if (hold.limitType === AUTH_HOLD_TYPE) {
242
+ return (`PC「${machine}」の Claude のログインが切れています。この PC への配達を止め、この便は失敗にせず待ちに戻しました。` +
243
+ `その PC で claude にログインし直してから \`conductor resume-delivery\` を打つと今すぐ再開します` +
244
+ `(打たなくても ${when}(日本時間)に1便だけ試し直します)。`);
245
+ }
219
246
  const how = hold.resetsKnown ? `上限が戻る時刻に合わせて ${when}(日本時間)に` : `戻る時刻が読めないので ${when}(日本時間)に`;
220
247
  return (`Claude の${usageLimitLabel(hold.limitType)}に当たりました。PC「${machine}」への配達を止め、この便は失敗にせず待ちに戻しました。` +
221
248
  `${how}自動で配達を再開します。アカウントを切り替えたときは、その PC で \`conductor resume-delivery\` を打つと今すぐ再開します。`);
@@ -241,7 +268,10 @@ function readResumeList(site) {
241
268
  /** 控えを残す(★同じ便は1件だけ・20件まで)。中継が立ち上げ直しても続きから起こせるようにファイルに置く。 */
242
269
  export function saveLimitResume(site, rec) {
243
270
  const kept = readResumeList(site).filter((r) => r.commandId !== rec.commandId);
244
- kept.push({ commandId: rec.commandId, sessionId: rec.sessionId, attempt: rec.attempt });
271
+ kept.push({
272
+ commandId: rec.commandId, sessionId: rec.sessionId, attempt: rec.attempt,
273
+ ...(rec.fresh === true ? { fresh: true } : {}),
274
+ });
245
275
  try {
246
276
  mkdirSync(stateDir(), { recursive: true });
247
277
  writeFileSync(limitResumePath(site), JSON.stringify(kept.slice(-20)) + '\n');
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tyhld/conductor",
3
- "version": "0.12.173",
3
+ "version": "0.12.175",
4
4
  "description": "采配くん管制の見守りアプリ(conductor-agent)。各PCで常駐し、中央(devlog-tracker)へ定期的に生存報告(heartbeat)を送る常駐CLI。",
5
5
  "type": "module",
6
6
  "bin": {
@@ -25,7 +25,7 @@ description: 采配くんの便(プロンプト末尾に CONDUCTOR_JOB:<id>
25
25
  - 守りの設定(`.claude/settings.local.json` など)は配り役が作業場所へ写してある=**触らない・記録に入れない**(`git status` に `?? .claude/` と出ても、はじめから在る物として扱う)。
26
26
  - 便が終わると配り役が作業場所を片付ける。**記録していない変更・送っていない記録が残っていれば消さずに残す**ので、終える前に push まで済ませる(鉄則7)。
27
27
  - ★便の本文に `【作業場所】` の段が無い便(tmux 方式・リポでない現場・この PC で切っている等)は、今までどおりこの項の残りのとおり。
28
- - ★**手元の作業場所で枝を切り替えられないとき**(はじめから在る変更が切り替えとぶつかる等)は、`git worktree add -b <作業ブランチ名> --no-track /tmp/claude-1000/<便IDを入れた名前> origin/main` で**別の作業場所**を作り、以後はそこで作業する(cd はその作業場所へ1回だけ=鉄則2)。終わったら `git worktree remove /tmp/claude-1000/<便IDを入れた名前>` で片付ける。★はじめから在る変更を退避(stash)・強制(`-f`・`--force`)・上書きして切り替えない(実地 便 934fca62 → dd5fe11a)。★これは便の作業場所の話で、空振り確認には worktree を使わない(鉄則13)。
28
+ - ★**手元の作業場所で枝を切り替えられないとき**(はじめから在る変更が切り替えとぶつかる等)は、`git worktree add -b <作業ブランチ名> --no-track /tmp/claude-1000/<便IDを入れた名前> origin/main` で**別の作業場所**を作り、以後はそこで作業する(cd はその作業場所へ1回だけ=鉄則2)。★cd は起動した場所へ戻されることがある(`Shell cwd was reset`=実地 便 e0796fcd)ので、以後の命令は絶対パス・`git -C <作業場所>`・`npm --prefix <作業場所>` で場所を名指しして打つ(「途中で止まらない書き方」の (2))。終わったら `git worktree remove /tmp/claude-1000/<便IDを入れた名前>` で片付ける。★はじめから在る変更を退避(stash)・強制(`-f`・`--force`)・上書きして切り替えない(実地 便 934fca62 → dd5fe11a)。★これは便の作業場所の話で、空振り確認には worktree を使わない(鉄則13)。
29
29
  - ★**リポ全体の差分が「読めないファイル」で落ちたとき**(`unsupported file type` / `cannot hash <名前>` が出る/`.npmrc` のような設定が身に覚えなく `M` で出る)。**これは壊れていない。**
30
30
  秘密に分類されたファイルは職人から中身を隠してあるので、git がそのファイルを数えられないだけ。**中身を見に行く方へ回らない。**
31
31
  - ① そのファイルを**触らない・開かない・`git diff` の対象にしない**。「読めるようにする」方向へ回避しない(鉄則4)。
@@ -33,7 +33,7 @@ description: 采配くんの便(プロンプト末尾に CONDUCTOR_JOB:<id>
33
33
  - ③ `M` と出ていても、**自分が触っていなければ触っていない**。★職人には本当に変わったかを確かめられない。`git status --porcelain -- <そのファイル>` の**表示だけ**を報告に書き、**中身は1文字も書かない**。
34
34
  - ④ **コミットに含めない**(`git add` は対象を名指しする=`git add -A` を使わない)。★`git commit -a`・`-am`・`--all` も同じ「まとめて全部を入れる」形なので使わない(番人が止める)。**ファイルを名指しで `git add` してから `git commit -m …`**(便 4cf71dde:着手前から `M` だった `.claude/settings.json` が、空振り確認の `git commit -a` で手元の記録に入った)。
35
35
  - ⑤ それで進めないときだけ、回避せず**人の手番として報告して止まる**。
36
- 2. **cd は1回だけ** — cd は作業開始時に1回だけ実行する。以後 cd を `&&` で他コマンドと連結しない・リダイレクトと混ぜない。
36
+ 2. **cd は1回だけ** — cd は作業開始時に1回だけ実行する。以後 cd を `&&` で他コマンドと連結しない・リダイレクトと混ぜない。★cd が起動した場所へ戻されたとき(`Shell cwd was reset`)は打ち直さず、以後は絶対パス・`git -C <場所>` で打つ(「途中で止まらない書き方」の (2))。
37
37
  3. **持ち場の外に出ない** — 指示された作業ディレクトリの外を変更しない。
38
38
  4. **壁に当たったら止まる** — サンドボックス制約・保護されたパスに当たったら回避せず中断して報告する(★通信で塞がれたときの読み方は鉄則12)。
39
39
  5. **エージェント設定に書き込まない** — `.mcp.json`、`.claude/` 配下、hooks 等のエージェント設定パスには書き込まない。
@@ -294,6 +294,30 @@ description: 采配くんの便(プロンプト末尾に CONDUCTOR_JOB:<id>
294
294
  - ★**止まるのは「行き先が分からない形」と「保護ブランチを狙う形」**(実測 便 6e8d85e6)。場所を指す旗を付けても枝を名指しした形(`git -C <場所> push origin <作業ブランチ名>`)は止まらないので、「場所を指す旗が付いているか」で安全を判断しない。
295
295
  - ★**強い上書き(`--force`/`-f`/`--force-with-lease`/先頭が `+` の参照指定)は、旗の位置を問わず止まる。** 旗を末尾や中間に置く形・短い旗をまとめた形(`-fu`)・`git` と `push` の間に場所や設定を指す旗を挟む形・`+` を引用符で囲う形・つないだ行や包みの中に書いた形も、すべて止まる(便 e619bd86 で語の並びを見る判定に替えた。それまでは挟む形と引用符で囲う形が素通りしていた=実地 便 6e8d85e6)。**そもそも強い上書きは打たない**(便の本文の「force-push と reset はしない」)。
296
296
 
297
+ ## 途中で止まらない書き方(全便の共通の型)
298
+
299
+ どのチャットが出した便にも、配り役が本文の後ろに `【共通の型(配り役が全便に付ける…)】` の段を付ける(えふさん決定 2026-11-04・便 6d0b403f)。その段の各項の正本がこの節。★各チャットの便の本文に同じことが書かれていなくても、この節のとおりにする。★本文の決まりがこれより厳しければ本文に従う。★番人の判定は1つも変えていない(止まらない書き方を最初から選ぶための節で、止められた後に回避する根拠にはしない=上の節の①〜⑦がそのまま掛かる)。
300
+
301
+ 直近30日(2026-10-05〜11-04)に途中で止まった便を、どのチャットの便かを問わず集めて、職人の側で防げる形だけをここに寄せた。
302
+
303
+ - (1) **リポの元の場所(~/projects/<現場>)を命令に書かない。本文に元の場所が書かれていても、`【作業場所】`の段があればその場所へ読み替える。**
304
+ - 止まった例(便 e879cf84): 背景の調べ役が `cd /home/…/projects/mebukia && grep …` を `$(...)` の中で動かし、`danger: secret file (.npmrc) inside …/mebukia read without naming it by grep` で便全体が止まった。元の場所には記録されない秘密のファイルが在るので、番人が正しく止める。
305
+ - 代わりに: `【作業場所】` の場所(無ければ自分で作った作業場所)を絶対パスで名指しする。
306
+ - (2) **cd は起動した場所へ戻されることがある(`Shell cwd was reset`)。以後は絶対パス・`git -C <場所>`・`npm --prefix <場所>` で打つ。**
307
+ - 止まった例(便 e0796fcd): 職人は鉄則1のとおり `/tmp/claude-1000/wt-…` を作って cd したが、Claude Code がシェルの今いる場所を起動した場所(リポの元の場所)へ戻したので、素の `python3` が元の場所で動き `danger: secret file (.npmrc) inside …/TYHLD-platform copied inside python3` で止まった(便 27a9fb19 の重大発見1)。
308
+ - 代わりに: 自分で作った作業場所では、`cd` が効いたと思わずに、命令ごとに場所を名指しする(`git -C /tmp/claude-1000/<名前> status`・`npm --prefix /tmp/claude-1000/<名前> ci …`・`node --test /tmp/claude-1000/<名前>/test/<変えた所>.test.ts`)。配り役が作業場所で起こした便(`【作業場所】` の段がある便)は、戻る先が作業場所なのでこの心配は無い。
309
+ - (3) **`$(...)` の中に場所を書かない(値が要るときは先にその命令だけを打ち、出た値をそのまま書く)。** 番人は `$(...)` の中を読み切れないと、作業場所(リポの根)を探したものとして測る(番人の文に `(書かれた場所を読み切れないので作業場所として判定)(inside command substitution)` と出る)。
310
+ - 代わりに: 値が要るときは、先にその命令だけを1回打ち、出た値をそのまま次の命令に書く。
311
+ - (4) **ファイルの中身・一覧を読むのは Read の道具・`ls`・`git ls-files`。`python3 -c`・`node -e`・`cat` で読まない。** 小さな台本は読む場所を番人に確かめさせない形になり、元の場所や秘密のファイルに触れると `danger` で止まる。
312
+ - (5) **探すのは場所を名指しした `git grep -n -e <語> -- <フォルダかファイル>`。パイプ(`|`)・`grep -r`・`rg`・`awk` は使わない。**
313
+ - 止まった例(便 62475b9e・e0796fcd): 便の本文が禁じたパイプ・grep を使い、`discipline` で打ち直しになった(便の本文の違反として報告に残った)。
314
+ - 代わりに: リポの中は `git grep -n -e 語 -- src docs`、リポの外(試験の出力・CI の記録)は Read の道具。
315
+ - (6) **背景の調べ役(サブエージェント)は使わない(調べ役の命令も同じ番人に掛かり、1回の danger で便全体が止まる)。** 調べ役が1回 `danger` に当たると、その便の残りがすべて止まる(便 e879cf84・上の節の「`danger` で止められた後」)。調べ役は鉄則も便の本文の決まりも読まずに動く。
316
+ - (7) **CI を待つのは `gh run watch <実行ID> --exit-status` を1回(繰り返しと sleep で待たない)。** 待ちの形は上の節のとおり。
317
+ - (8) **番人に `danger` で止められたら別の道具へ替えず、止められた命令の全文と番人の文を報告に書いて終える**(鉄則4・上の節の⑤-2)。
318
+
319
+ ★**職人の側では防げない止まり方は、配り役が受け持つ**(職人は何もしなくてよい): Claude の利用上限(便 27a9fb19)とログイン切れ(便 6d0b403f)に当たった便は、失敗にせず待ちに戻し、その PC への配達を止める。便ごとの作業場所で起こす(便 27a9fb19)。
320
+
297
321
  ## 便の終え方
298
322
 
299
323
  便の最後には、配達役が付けた1行「【便の終え方】…報告の置き場: ~/最終行: DONE:<現場> とだけ出力/完了の知らせ: conductor_complete を commandId="<指示ID>" で1回だけ」と、管理用ジョブ印 `CONDUCTOR_JOB:<指示ID>` がある。作業がすべて終わったら、この節のとおりに次の順で終える(便 a5306df2:以前は便ごとに付いていた全文を、ここへ寄せた)。