@tyhld/conductor 0.12.30 → 0.12.32

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tyhld/conductor",
-  "version": "0.12.30",
+  "version": "0.12.32",
   "description": "采配くん管制の見守りアプリ（conductor-agent）。各PCで常駐し、中央(devlog-tracker)へ定期的に生存報告(heartbeat)を送る常駐CLI。",
   "type": "module",
   "bin": {

package/scripts/hooks/skill_sync_notify.py

@@ -32,6 +32,7 @@
   python3 skill_sync_notify.py <直近の試みの控えのパス>
   ★控えの1行目が status=failed のときだけカードを出す。ok のときは何もしない。
 """
+import json
 import os
 import sys
 
@@ -102,21 +103,54 @@ def parse_last(path):
     return out
 
 
+#: 入れ直しの1行（★取得先を明示する。ここを省くと社内の取得先を見に行って失敗する）。
+REINSTALL = ('npm install -g @tyhld/conductor '
+             '--@tyhld:registry=https://registry.npmjs.org')
+#: 配り直しの1行（★入っている配布物の中の台本を打つ。作業ツリーの台本ではない）。
+RESYNC = 'APPLY=1 bash "$(npm root -g)/@tyhld/conductor/scripts/update-guard.sh"'
+
+
+def recovery_steps(reason):
+    """うまくいかなかった理由に【合った】手順を返す（便 675e2d05）。
+
+    【なぜ理由ごとに分けるか（実地 2026-09-20・便 8692c586 の重大発見1）】
+      以前は理由によらず「update-guard を打ってください」の固定文だった。version-drift
+      （入っている版と公開の版が違う）のときにこれを打っても、配り元の確認でまた弾かれる＝
+      同じ失敗を繰り返すだけで直らない。先に入れ直しが要る。
+    """
+    if reason in ('version-drift', 'not-installed', 'incomplete'):
+        return [f'再開のしかた: この PC で次の順に打ってください。① {REINSTALL}',
+                f'　② {RESYNC}']
+    if reason == 'unverifiable':
+        return ['再開のしかた: 公開 npm に問い合わせられませんでした。'
+                'この PC の通信（回線・取得先の設定）を確かめてから、次を打ってください。',
+                f'　{RESYNC}']
+    return [f'再開のしかた: この PC で次の1行を打ってください。　{RESYNC}']
+
+
 def build_payload(rec, env=None):
-    """カードの中身。★何が起きていて、何をすれば直るかを日本語で書く。"""
+    """カードの中身。★何が起きていて、何をすれば直るかを日本語で書く。
+
+    ★本文は【その回の控え（rec）の実際の値】だけから組み立てる。固定の版番号や、
+      もう済んだ操作の案内を焼き込まない（便 675e2d05・えふさん確定 2026-09-20）。
+    """
     env = os.environ if env is None else env
     machine = env.get('CONDUCTOR_MACHINE') or os.uname().nodename
     reason = rec.get('reason', '不明')
     kind = notice_kind(rec)
-    body = '\n'.join([
+    lines = [
         f'いま止まっているもの: この PC（{machine}）で、{kind["stopped"]}',
-        '再開のしかた: この PC で次の1行を打ってください。'
-        '　cd ~/projects/conductor　そのあと　APPLY=1 bash scripts/update-guard.sh',
+        *recovery_steps(reason),
         '★このカードは管制からは押せません（この PC での操作が要ります）。',
         f'PC: {machine}／うまくいかなかった理由: {reason}',
         f'最後に試した時刻: {rec.get("at", "不明")}',
-        f'配ろうとした版: {rec.get("version", "不明")}',
-    ])
+        f'入っている版: {rec.get("version", "不明")}',
+    ]
+    # ★公開の版は、控えに在るときだけ載せる。無い種類の知らせに「公開の版: 不明」と
+    #   書くと、読む人には【公開の版が読めなかった】ように見える（便 675e2d05）。
+    if rec.get('published'):
+        lines.append(f'公開の版: {rec["published"]}')
+    body = '\n'.join(lines)
     return {
         'site': env.get('CONDUCTOR_SITE') or machine,
         'machine': machine,
@@ -131,19 +165,78 @@ def build_payload(rec, env=None):
     }
 
 
-def run(last_path, cfg=None, datalink=hook_datalink):
-    """返り値: 出したカードのID / None（出さなかった）。"""
+#: 出した札の番号を覚えておく場所（鍵→カードID）。★秘密は入らない（番号だけ）。
+CARD_STATE = os.path.join(os.path.expanduser('~'), '.tyhld', 'hooks', 'notice-cards.json')
+
+
+def _load_cards(path=None):
+    """覚えている札の番号。読めなければ空（覚えていない＝今までどおりに振る舞う）。"""
+    try:
+        with open(path or CARD_STATE, encoding='utf-8') as f:
+            got = json.load(f)
+        return got if isinstance(got, dict) else {}
+    except Exception:  # noqa: BLE001
+        return {}
+
+
+def _save_cards(cards, path=None):
+    """覚え書きを書く。★書けなくても止まらない（知らせは本筋ではない）。"""
+    target = path or CARD_STATE
+    try:
+        os.makedirs(os.path.dirname(target), exist_ok=True)
+        tmp = target + '.tmp'
+        with open(tmp, 'w', encoding='utf-8') as f:
+            json.dump(cards, f, ensure_ascii=False)
+        os.replace(tmp, target)
+    except Exception:  # noqa: BLE001
+        pass
+
+
+def _close(cfg, datalink, cards, key, path=None):
+    """覚えている札を閉じる（best effort）。閉じたら覚え書きから外す。"""
+    card_id = cards.get(key)
+    if not card_id:
+        return False
+    try:
+        datalink.abandon(cfg, card_id)
+    except Exception:  # noqa: BLE001
+        pass
+    cards.pop(key, None)
+    _save_cards(cards, path)
+    return True
+
+
+def run(last_path, cfg=None, datalink=hook_datalink, state_path=None):
+    """返り値: 出したカードのID / None（出さなかった・閉じただけ）。
+
+    ★失敗の回 … 前に出した札を【閉じてから】出し直す。管制は同じ鍵の再登録を寿命の延長
+      として扱い、本文は最初のままになる（実地 2026-09-20・札に 4日前の版が出ていた）。
+      閉じてから出し直せば、本文は必ずその回の値になる。
+    ★成功の回 … 出していた札を閉じる。直ったのに札が最大60分出たままにならない。
+    """
     rec = parse_last(last_path)
-    if rec.get('status') != 'failed':
+    status = rec.get('status')
+    if status not in ('failed', 'ok'):
         return None
     cfg = datalink.load_config() if cfg is None else cfg
     if cfg is None:
         # 接続情報が無い機体。★控えには残っているので、黙って消えるわけではない。
         return None
+    key = notice_kind(rec)['key']
+    cards = _load_cards(state_path)
+
+    if status == 'ok':
+        _close(cfg, datalink, cards, key, state_path)
+        return None
+
+    # 失敗。★古い本文の札が残っていたら先に閉じる（上書きできない作りへの対処）。
+    _close(cfg, datalink, cards, key, state_path)
     reg = datalink.register(cfg, build_payload(rec))
     if not reg or not reg.get('id'):
         return None
-    # ★待たない。押されるまで管制に出たままにする＝古い鉄則のままであることが見え続ける。
+    cards[key] = reg['id']
+    _save_cards(cards, state_path)
+    # ★待たない。押されるまで管制に出たままにする＝直っていないことが見え続ける。
     return reg['id']
 
 

package/scripts/hooks/test_policy.py

@@ -1087,7 +1087,9 @@ check('同期モードは掃除・タイマー・pnpm 点検を飛ばす',
 check('職人の鉄則は同期モードでも配る',
       _ug.index('①-d 職人の鉄則スキル') < _ug.index('①-b・①-c・①-d2 は省略（同期モード）'), True)
 check('配り損ねたら成功と偽らず管制へ知らせる',
-      'craftsman_notify_failure' in _ug and 'skill_sync_notify.py' in _ug, True)
+      'craftsman_notify' in _ug and 'skill_sync_notify.py' in _ug, True)
+# ★直った回は札を閉じる（便 675e2d05）。直っているのに札が最大60分出たままだった。
+check('直った回は管制の札を閉じる', 'craftsman_notify_recovered' in _ug, True)
 # ★上書きの前に日時つきの控えを取る（えふさん確定 2026-09-16・便 bf030fee）。
 #   中身の検査は test/craftsman-skill-sync.test.ts。ここでは決まりが消えていないことだけ見る。
 check('上書きの前に控えを取る', 'craftsman_backup()' in _ug, True)

package/scripts/hooks/test_skill_sync_notify.py

@@ -6,7 +6,7 @@
 
 【何を守っているか（便 29612ff1・えふさん確定 2026-09-16）】
   「★更新失敗時に古いルールのまま黙って動かないこと。適用version/時刻を確認可能にする」
-  (a) 成功の控えでは【1件も知らせない】（毎時のカードで管制を埋めない）
+  (a) 成功の控えでは【新しい札を1枚も出さない】（毎時のカードで管制を埋めない）
   (b) 失敗の控えでは【必ず知らせる】＝黙って進まない
   (c) カードの中身に「いま止まっているもの」「再開のしかた」が入っている
       ＝管制が知らせとして描ける形（ai-kana の hook-notice-text.ts が探す見出し語）
@@ -15,7 +15,16 @@
   (e) 機体ごとに鍵が固定＝毎時の失敗が同じ1枚に集約される（カードが増殖しない）
   (f) 知らせに失敗しても例外を外へ出さない（★同期そのものは止めない）
   (g) 控えが読めない・空・壊れていても落ちない
+
+【★便 675e2d05 で足した3つ（実地 2026-09-20・えふさん確定）】
+  (h) 失敗の回は【前の札を閉じてから】出し直す＝本文が必ずその回の値になる。
+      管制は同じ鍵の再登録を寿命の延長として扱い、本文は最初のまま残る（upsertHookRequest）。
+      実地では、直しても札に4日前の版が出たままだった。
+  (i) 成功の回は【出していた札を閉じる】＝直ったのに札が最大60分出たままにならない。
+  (j) 再開の手順が【うまくいかなかった理由に合っている】＝同じ失敗を繰り返させない。
+      版のずれに「配り直してください」とだけ言っても、配り元の確認でまた弾かれる。
 """
+import json
 import os
 import sys
 import tempfile
@@ -51,22 +60,49 @@ class FakeLink:
     #: 「既定のまま」と「わざと None を返させる」を区別するための印。
     DEFAULT = object()
 
-    def __init__(self, cfg=CFG, reg=DEFAULT):
+    def __init__(self, cfg=CFG, reg=DEFAULT, ids=None, abandon_raises=False):
         self.cfg = cfg
         self.reg = {'id': 'req-1'} if reg is FakeLink.DEFAULT else reg
-        self.sent = []
+        self.ids = list(ids) if ids else None      # 連番で返したいとき
+        self.abandon_raises = abandon_raises
+        self.sent = []      # 送ったカードの中身
+        self.closed = []    # 閉じに行ったカードID
+        self.log = []       # ('close'|'register', …) の並び＝★順序を見るため
 
     def load_config(self, env=None):
         return self.cfg
 
     def register(self, cfg, payload):
         self.sent.append(payload)
+        self.log.append(('register', payload['requestKey']))
+        if self.ids is not None:
+            return {'id': self.ids.pop(0)} if self.ids else None
         return self.reg
 
+    def abandon(self, cfg, request_id):
+        self.closed.append(request_id)
+        self.log.append(('close', request_id))
+        if self.abandon_raises:
+            raise RuntimeError('通信断')
+        return {'ok': True}
+
     # ★本物と同じ実装を借りる（sessionId が空にならないことを一緒に確かめるため）。
     stable_session_id = staticmethod(sn.hook_datalink.stable_session_id)
 
 
+def real_state_snapshot():
+    """【本物】の覚え書きの中身（無ければ None）。★試験が実機を汚していないかを見るため。"""
+    try:
+        with open(sn.CARD_STATE, encoding='utf-8') as f:
+            return f.read()
+    except Exception:  # noqa: BLE001
+        return None
+
+
+#: 試験を始める前の姿。終わりに同じであることを確かめる。
+REAL_STATE_BEFORE = real_state_snapshot()
+
+
 def write(tmp, name, text):
     p = os.path.join(tmp, name)
     with open(p, 'w', encoding='utf-8') as f:
@@ -74,30 +110,48 @@ def write(tmp, name, text):
     return p
 
 
+def state(tmp, name='cards.json'):
+    """★札の覚え書きは必ずこの回だけの場所へ。
+
+    既定は $HOME/.tyhld/hooks/notice-cards.json ＝【本物】の置き場なので、試験で
+    そこへ書くと、実機に居もしないカードの番号が残り、次の同期が存在しない札を
+    閉じに行く。試験は本物の控えに1バイトも書かない。
+    """
+    return os.path.join(tmp, name)
+
+
 # ── (a)(b) 出す・出さない ────────────────────────────────────────────────────
 print('\n【(a)(b) 成功では出さない・失敗では必ず出す】')
 with tempfile.TemporaryDirectory() as tmp:
+    st = state(tmp)
     link = FakeLink()
-    check('成功の控え: 知らせない', sn.run(write(tmp, 'ok.last', OK_LINE + '\n'), datalink=link), None)
+    check('成功の控え: 知らせない',
+          sn.run(write(tmp, 'ok.last', OK_LINE + '\n'), datalink=link, state_path=st), None)
     check('成功の控え: 1件も送っていない', len(link.sent), 0)
+    check('成功の控え: 覚えが無ければ閉じにも行かない', len(link.closed), 0)
+    check('成功の控え: 覚え書きを作らない', os.path.exists(st), False)
 
     link = FakeLink()
-    got = sn.run(write(tmp, 'ng.last', NG_LINE + '\n'), datalink=link)
+    got = sn.run(write(tmp, 'ng.last', NG_LINE + '\n'), datalink=link, state_path=st)
     check('失敗の控え: 知らせた（カードIDが返る）', got, 'req-1')
     check('失敗の控え: 1件だけ送った', len(link.sent), 1)
 
     # ★控えが無い・空・壊れている＝出さない（落ちない）＝(g)
     link = FakeLink()
-    check('控えが無い: 落ちずに何もしない', sn.run(os.path.join(tmp, 'none.last'), datalink=link), None)
-    check('控えが空: 落ちずに何もしない', sn.run(write(tmp, 'e.last', ''), datalink=link), None)
-    check('控えが壊れている: 落ちずに何もしない', sn.run(write(tmp, 'b.last', 'ゴミ\n'), datalink=link), None)
+    check('控えが無い: 落ちずに何もしない',
+          sn.run(os.path.join(tmp, 'none.last'), datalink=link, state_path=st), None)
+    check('控えが空: 落ちずに何もしない',
+          sn.run(write(tmp, 'e.last', ''), datalink=link, state_path=st), None)
+    check('控えが壊れている: 落ちずに何もしない',
+          sn.run(write(tmp, 'b.last', 'ゴミ\n'), datalink=link, state_path=st), None)
     check('壊れた控えでは1件も送らない', len(link.sent), 0)
+    check('壊れた控えでは札も閉じない（出したままにする）', len(link.closed), 0)
 
 # ── (c)(d)(e) カードの形 ────────────────────────────────────────────────────
 print('\n【(c)(d)(e) カードの形】')
 with tempfile.TemporaryDirectory() as tmp:
     link = FakeLink()
-    sn.run(write(tmp, 'ng.last', NG_LINE + '\n'), datalink=link)
+    sn.run(write(tmp, 'ng.last', NG_LINE + '\n'), datalink=link, state_path=state(tmp))
     p = link.sent[0]
     q = p['question']
     # (c) 管制が本文として取り出す見出し語（ai-kana: NOTICE_BODY_LABELS）。
@@ -109,7 +163,9 @@ with tempfile.TemporaryDirectory() as tmp:
     # 失敗の理由・時刻・版が読める＝(2) 適用version/時刻を確認可能にする。
     check_true('うまくいかなかった理由が載る', 'write-failed' in q)
     check_true('最後に試した時刻が載る', '2026-09-16T11:00:00+0900' in q)
-    check_true('配ろうとした版が載る', '0.12.7' in q)
+    check_true('入っている版が載る', '入っている版: 0.12.7' in q)
+    # ★控えに公開の版が無い種類では、その行を出さない（「不明」と書いて読む人を惑わせない）。
+    check('控えに無い「公開の版」は行ごと出さない', '公開の版' in q, False)
     # (d) ボタンを1つも出さない形（kind=message かつ choices なし）。
     check('種別は message', p['kind'], 'message')
     check('選択肢を付けない（押せないボタンを置かない）', 'choices' in p, False)
@@ -119,7 +175,7 @@ with tempfile.TemporaryDirectory() as tmp:
     # (e) 鍵が機体ごとに固定。
     check_true('鍵が付いている', p['requestKey'].startswith(sn.REQUEST_KEY_PREFIX + ':'))
     link2 = FakeLink()
-    sn.run(write(tmp, 'ng2.last', NG_LINE + '\n'), datalink=link2)
+    sn.run(write(tmp, 'ng2.last', NG_LINE + '\n'), datalink=link2, state_path=state(tmp, 'b.json'))
     check('2回目も同じ鍵（カードが増えない）', link2.sent[0]['requestKey'], p['requestKey'])
     # ★控えの中身（パス）以外の余計な物を載せない＝秘密は1文字も入らない。
     check('本文にトークンは入らない', CFG['token'] in q, False)
@@ -128,9 +184,11 @@ with tempfile.TemporaryDirectory() as tmp:
 print('\n【★2種類目＝配り元の配り損ね（便 4061dd71）】')
 DIST_NG = ('2026-09-16T12:00:00+0900 status=failed reason=version-drift what=dist-source '
            'version=0.12.6 published=0.12.8 root=/n/@tyhld/conductor')
+DIST_OK = ('2026-09-16T13:00:00+0900 status=ok reason=verified what=dist-source '
+           'version=0.12.8 published=0.12.8 root=/n/@tyhld/conductor')
 with tempfile.TemporaryDirectory() as tmp:
     link = FakeLink()
-    sn.run(write(tmp, 'dist.last', DIST_NG + '\n'), datalink=link)
+    sn.run(write(tmp, 'dist.last', DIST_NG + '\n'), datalink=link, state_path=state(tmp))
     p = link.sent[0]
     q = p['question']
     check_true('見出しが配り元の話になっている', '安全装置を配れていません' in p['summary'])
@@ -138,35 +196,181 @@ with tempfile.TemporaryDirectory() as tmp:
     check_true('本文に「再開のしかた」がある', '再開のしかた:' in q)
     check_true('何を配れていないかが書いてある', '番人' in q and '権限ルール' in q)
     check_true('うまくいかなかった理由が載る', 'version-drift' in q)
+    check_true('入っている版と公開の版が並ぶ', '入っている版: 0.12.6' in q and '公開の版: 0.12.8' in q)
     check_true('鍵が種類ごとに分かれている', p['requestKey'].startswith('dist-source-unverified:'))
     # ★鉄則の配り損ねとは別の鍵＝2種類が同じ1枚に潰れない。
     link2 = FakeLink()
-    sn.run(write(tmp, 'skill.last', NG_LINE + '\n'), datalink=link2)
+    sn.run(write(tmp, 'skill.last', NG_LINE + '\n'), datalink=link2, state_path=state(tmp, 'b.json'))
     check('鉄則の配り損ねとは別の鍵', p['requestKey'] == link2.sent[0]['requestKey'], False)
     # ★知らない種類は、従来どおり鉄則の配り損ねとして扱う（増やしても壊れない）。
     link3 = FakeLink()
     unknown = DIST_NG.replace('what=dist-source', 'what=まだ無い種類')
-    sn.run(write(tmp, 'unknown.last', unknown + '\n'), datalink=link3)
+    sn.run(write(tmp, 'unknown.last', unknown + '\n'), datalink=link3, state_path=state(tmp, 'c.json'))
     check_true('知らない種類でも落ちずにカードは出る', bool(link3.sent))
     check_true('知らない種類は従来の文面へ倒れる',
                '職人の決まりが古いままです' in link3.sent[0]['summary'])
 
+# ── (h) 本文は【いつもその回の値】＝閉じてから出し直す（便 675e2d05）──────────
+print('\n【(h) 失敗の回は前の札を閉じてから出し直す】')
+DRIFT_OLD = ('2026-09-16T12:00:00+0900 status=failed reason=version-drift what=dist-source '
+             'version=0.12.6 published=0.12.8 root=/n/@tyhld/conductor')
+DRIFT_NEW = ('2026-09-20T09:00:00+0900 status=failed reason=version-drift what=dist-source '
+             'version=0.12.6 published=0.12.31 root=/n/@tyhld/conductor')
+with tempfile.TemporaryDirectory() as tmp:
+    st = state(tmp)
+    link = FakeLink(ids=['req-old', 'req-new'])
+    check('1回目の失敗: 札を出す',
+          sn.run(write(tmp, 'a.last', DRIFT_OLD + '\n'), datalink=link, state_path=st), 'req-old')
+    check('1回目は閉じに行かない（まだ何も出ていない）', link.closed, [])
+
+    check('2回目の失敗: 別のIDで出し直す',
+          sn.run(write(tmp, 'b.last', DRIFT_NEW + '\n'), datalink=link, state_path=st), 'req-new')
+    check('2回目は前の札を閉じた', link.closed, ['req-old'])
+    # ★順序が肝。出し直してから閉じると、閉じたのが新しい札になって何も残らない。
+    check('★閉じる→出し直す の順である', link.log[1:], [('close', 'req-old'),
+                                                   ('register', link.sent[1]['requestKey'])])
+    q2 = link.sent[1]['question']
+    check_true('本文がその回の値になっている', '公開の版: 0.12.31' in q2)
+    check('前の回の値が本文に残らない', '0.12.8' in q2, False)
+    check_true('時刻もその回のもの', '2026-09-20T09:00:00+0900' in q2)
+    check('覚えているのは最後に出した札だけ',
+          json.load(open(st, encoding='utf-8')), {'dist-source-unverified': 'req-new'})
+
+    # ★空振り: 閉じる手当てを外すと、前の札が管制に残ったまま＝本文が古いまま延命される。
+    orig_close = sn._close
+    sn._close = lambda *a, **k: False
+    try:
+        link2 = FakeLink(ids=['req-x'])
+        sn.run(write(tmp, 'c.last', DRIFT_NEW + '\n'), datalink=link2, state_path=st)
+        check('★空振り: 閉じなくすると1枚も閉じられない', link2.closed, [])
+    finally:
+        sn._close = orig_close
+
+# ── (i) 直ったら札を閉じる ──────────────────────────────────────────────────
+print('\n【(i) 成功の回は出していた札を閉じる】')
+with tempfile.TemporaryDirectory() as tmp:
+    st = state(tmp)
+    link = FakeLink(ids=['req-1'])
+    sn.run(write(tmp, 'ng.last', DRIFT_OLD + '\n'), datalink=link, state_path=st)
+    check('直る前: 札が1枚出ている', link.sent and len(link.sent), 1)
+
+    check('成功の控え: 新しい札は出さない',
+          sn.run(write(tmp, 'ok.last', DIST_OK + '\n'), datalink=link, state_path=st), None)
+    check('成功の控え: 出ていた札を閉じた', link.closed, ['req-1'])
+    check('成功の控え: 送ったのは最初の1枚だけ', len(link.sent), 1)
+    check('閉じた札は覚え書きから外れる', json.load(open(st, encoding='utf-8')), {})
+
+    # 2度目の成功では、もう閉じるものが無い＝管制へ1回も触らない。
+    link2 = FakeLink()
+    sn.run(write(tmp, 'ok2.last', DIST_OK + '\n'), datalink=link2, state_path=st)
+    check('直ったあとの毎時の成功: 管制へ触らない', link2.log, [])
+
+    # ★種類ごとに別々に覚える＝配り元が直っても鉄則の札は閉じない。
+    st2 = state(tmp, 'two.json')
+    link3 = FakeLink(ids=['req-dist', 'req-skill'])
+    sn.run(write(tmp, 'd.last', DRIFT_OLD + '\n'), datalink=link3, state_path=st2)
+    sn.run(write(tmp, 's.last', NG_LINE + '\n'), datalink=link3, state_path=st2)
+    link3.closed.clear()
+    sn.run(write(tmp, 'do.last', DIST_OK + '\n'), datalink=link3, state_path=st2)
+    check('配り元の成功で閉じるのは配り元の札だけ', link3.closed, ['req-dist'])
+    check('鉄則の札は覚えたまま（まだ直っていない）',
+          json.load(open(st2, encoding='utf-8')), {'craftsman-skill-stale': 'req-skill'})
+
+# ── (j) 再開の手順が理由に合っている ────────────────────────────────────────
+print('\n【(j) 再開の手順が、うまくいかなかった理由に合っている】')
+with tempfile.TemporaryDirectory() as tmp:
+    def body_for(reason, what='dist-source'):
+        line = (f'2026-09-20T09:00:00+0900 status=failed reason={reason} what={what} '
+                'version=0.12.6 published=0.12.31 root=/n/@tyhld/conductor')
+        link = FakeLink()
+        sn.run(write(tmp, f'{reason}.last', line + '\n'), datalink=link,
+               state_path=state(tmp, f'{reason}.json'))
+        return link.sent[0]['question']
+
+    drift = body_for('version-drift')
+    # ★版がずれているときに配り直しだけを促すと、配り元の確認でまた弾かれる＝直らない。
+    check_true('版ずれ: 入れ直しを先に案内する', '① npm install -g @tyhld/conductor' in drift)
+    check_true('版ずれ: 取得先まで書いてある（社内の取得先を見に行かせない）',
+               '--@tyhld:registry=https://registry.npmjs.org' in drift)
+    check_true('版ずれ: そのあと配り直しを案内する', '② APPLY=1 bash' in drift)
+    check_true('版ずれ: 入れ直しが配り直しより先に書いてある',
+               drift.index('npm install -g') < drift.index('APPLY=1'))
+
+    check_true('入っていない: 入れ直しから案内する', 'npm install -g' in body_for('not-installed'))
+    check_true('中身が欠けている: 入れ直しから案内する', 'npm install -g' in body_for('incomplete'))
+
+    net = body_for('unverifiable')
+    check_true('公開npmに聞けない: 先に通信を確かめさせる', '通信' in net)
+    check('公開npmに聞けない: 入れ直しは案内しない（入っている版は正しいかもしれない）',
+          'npm install -g' in net, False)
+    check_true('公開npmに聞けない: 配り直しの1行は載る', 'APPLY=1 bash' in net)
+
+    plain = body_for('write-failed', what='craftsman-skill')
+    check('書けなかった: 入れ直しは案内しない', 'npm install -g' in plain, False)
+    check_true('書けなかった: 配り直しの1行だけ', 'APPLY=1 bash' in plain)
+
+    # ★どの理由でも、打たせるのは【入っている配布物の台本】＝作業ツリーの台本ではない。
+    for label, b in (('版ずれ', drift), ('通信不能', net), ('書込失敗', plain)):
+        check_true(f'{label}: 入っている配布物の台本を打たせる', 'npm root -g' in b)
+        check(f'{label}: 作業ツリーへ cd させない', 'cd ~/projects' in b, False)
+
+# ── ★札の覚え書き（壊れていても・書けなくても止まらない）──────────────────
+print('\n【★札の覚え書き】')
+with tempfile.TemporaryDirectory() as tmp:
+    broken = write(tmp, 'broken.json', '{ こわれている')
+    link = FakeLink()
+    check('覚え書きが壊れている: 落ちずに新しく出す',
+          sn.run(write(tmp, 'ng.last', NG_LINE + '\n'), datalink=link, state_path=broken), 'req-1')
+    check('覚え書きが壊れている: 閉じに行かない（番号が分からない）', link.closed, [])
+
+    # 配列など、想定外の形が入っていても辞書として扱わない。
+    odd = write(tmp, 'odd.json', '[1, 2, 3]')
+    check('覚え書きが辞書でない: 空として扱う', sn._load_cards(odd), {})
+
+    # 書けない場所でも止まらない（親がファイル＝ディレクトリを作れない）。
+    blocked = os.path.join(write(tmp, 'afile', 'x'), 'cards.json')
+    link2 = FakeLink()
+    check('覚え書きを書けない: それでも知らせる',
+          sn.run(write(tmp, 'ng2.last', NG_LINE + '\n'), datalink=link2, state_path=blocked),
+          'req-1')
+
+    # ★閉じるのに失敗しても、出し直しは続ける（古い札が残るより無い方がまし、ではなく
+    #   ★新しい本文を必ず出す方を優先する）。
+    st = state(tmp, 'x.json')
+    link3 = FakeLink(ids=['req-1', 'req-2'], abandon_raises=True)
+    sn.run(write(tmp, 'a.last', NG_LINE + '\n'), datalink=link3, state_path=st)
+    check('閉じるのが失敗しても出し直す',
+          sn.run(write(tmp, 'b.last', NG_LINE + '\n'), datalink=link3, state_path=st), 'req-2')
+
+    # ★覚え書きに入るのは番号だけ（秘密は1文字も入らない）。
+    saved = open(st, encoding='utf-8').read()
+    check('覚え書きにトークンは入らない', CFG['token'] in saved, False)
+    check('覚え書きに入るのは鍵と番号だけ', json.loads(saved), {'craftsman-skill-stale': 'req-2'})
+
 # ── (f) 知らせに失敗しても同期は止めない ────────────────────────────────────
 print('\n【(f) 知らせに失敗しても同期を止めない】')
 with tempfile.TemporaryDirectory() as tmp:
     last = write(tmp, 'ng.last', NG_LINE + '\n')
+    st = state(tmp)
 
     # 接続情報が無い機体。
-    check('接続情報が無い: 何もせず終わる', sn.run(last, datalink=FakeLink(cfg=None)), None)
+    check('接続情報が無い: 何もせず終わる',
+          sn.run(last, datalink=FakeLink(cfg=None), state_path=st), None)
     # 管制が受け取らなかった。
-    check('登録が空返事: 何もせず終わる', sn.run(last, datalink=FakeLink(reg=None)), None)
-    check('登録にIDが無い: 何もせず終わる', sn.run(last, datalink=FakeLink(reg={})), None)
+    check('登録が空返事: 何もせず終わる',
+          sn.run(last, datalink=FakeLink(reg=None), state_path=st), None)
+    check('登録にIDが無い: 何もせず終わる',
+          sn.run(last, datalink=FakeLink(reg={}), state_path=st), None)
+    check('受け取られなかった札は覚えない', os.path.exists(st), False)
 
     # ★main() は何があっても 0 を返す（update-guard.sh が止まらない）。
     argv = sys.argv
     sys.argv = ['skill_sync_notify.py', last]
     orig_load, orig_reg = sn.hook_datalink.load_config, sn.hook_datalink.register
+    orig_state = sn.CARD_STATE
     try:
+        # ★本物の置き場へ書かせない（試験が実機の覚え書きを汚さない）。
+        sn.CARD_STATE = state(tmp, 'main.json')
         sn.hook_datalink.load_config = lambda env=None: CFG
 
         def boom(cfg, payload):
@@ -176,6 +380,7 @@ with tempfile.TemporaryDirectory() as tmp:
         check('通信が落ちても exit 0', sn.main(), 0)
     finally:
         sn.hook_datalink.load_config, sn.hook_datalink.register = orig_load, orig_reg
+        sn.CARD_STATE = orig_state
         sys.argv = argv
     check('引数が無くても exit 0', (lambda: (sys.argv.__setitem__(slice(None), ['x']), sn.main())[1])(), 0)
     sys.argv = argv
@@ -183,17 +388,23 @@ with tempfile.TemporaryDirectory() as tmp:
 # ── ★空振り確認 ─────────────────────────────────────────────────────────────
 print('\n【★空振り確認】')
 with tempfile.TemporaryDirectory() as tmp:
+    st = state(tmp)
     # 「status を見ずに必ず出す」ようにしたら (a) が落ちる＝(a) は本当に効いている。
     orig_parse = sn.parse_last
     sn.parse_last = lambda p: dict(orig_parse(p), status='failed')
     try:
         link = FakeLink()
-        sn.run(write(tmp, 'ok.last', OK_LINE + '\n'), datalink=link)
+        sn.run(write(tmp, 'ok.last', OK_LINE + '\n'), datalink=link, state_path=st)
         check('★空振り: 判定を壊すと成功の控えでも出てしまう', len(link.sent), 1)
     finally:
         sn.parse_last = orig_parse
     link = FakeLink()
-    check('★戻したあと: 成功では出ない', sn.run(write(tmp, 'ok2.last', OK_LINE + '\n'), datalink=link), None)
+    check('★戻したあと: 成功では出ない',
+          sn.run(write(tmp, 'ok2.last', OK_LINE + '\n'), datalink=link, state_path=st), None)
+
+# ★試験そのものが実機の覚え書きに触っていないこと（上の state() を1つでも外したら落ちる）。
+#   実機ではこのファイルが在るのが普通なので、「無いこと」ではなく【変わっていないこと】を見る。
+check('試験は本物の覚え書きを書き換えない', real_state_snapshot(), REAL_STATE_BEFORE)
 
 print('\n' + '=' * 72)
 if failures:

package/scripts/update-guard.sh

@@ -119,9 +119,11 @@ dist_record() {
   fi
 }
 
-# 配り損ねを管制へ知らせる（★便 29612ff1 と同じ口・届かなくても止まらない）。
+# 管制の札を、いまの控えに合わせる（★便 29612ff1 と同じ口・届かなくても止まらない）。
 #   ★確認のみのときは知らせない（見ただけでお客さまの画面にカードを出さない）。
-dist_notify_failure() {
+#   ★失敗の回は札を出し直し、成功の回は札を閉じる（便 675e2d05）。どちらも同じ呼び方で、
+#     知らせる側が控えの status を見て決める＝ここに判断を二重に書かない。
+dist_notify() {
   [[ "$APPLY" == "1" ]] || return 0
   [[ -f "$DIST_NOTIFY" ]] || return 0
   python3 "$DIST_NOTIFY" "$DIST_LAST" >/dev/null 2>&1 || true
@@ -138,14 +140,14 @@ if ! dist_source_resolve; then
   esac
   warn "  人の手番: npm install -g @tyhld/conductor --@tyhld:registry=https://registry.npmjs.org"
   dist_record failed "$DIST_REASON"
-  dist_notify_failure
+  dist_notify
   exit 0
 fi
 if ! dist_source_complete "$DIST_ROOT"; then
   warn "配り元の中身が欠けています: $DIST_ROOT（★1バイトも配りません）"
   DIST_REASON='incomplete'
   dist_record failed incomplete
-  dist_notify_failure
+  dist_notify
   exit 0
 fi
 info "   配り元: $DIST_ROOT（版 $DIST_VERSION ＝公開 npm のいまの版）"
@@ -153,6 +155,9 @@ if [[ "$DIST_ROOT" != "$REPO_ROOT" ]]; then
   info "   ★この台本の置き場（$REPO_ROOT）からは配りません。"
 fi
 dist_record ok verified
+# ★直ったので、出ていた「安全装置を配れていません」の札を閉じる（便 675e2d05）。
+#   以前は成功しても閉じに行かず、最大60分出たままだった（実地 2026-09-20・便 8692c586）。
+dist_notify
 
 # 配る中身は、すべて上で確かめた配り元から取る。
 GUARD_SRC_DIR="$DIST_ROOT/scripts/hooks"          # 番人の正本
@@ -369,32 +374,45 @@ craftsman_backup() {
   return 0
 }
 
-# 配り損ねを管制へ知らせる（★届かなくても同期は止めない）。
-craftsman_notify_failure() {
+# 管制の札を、いまの控えに合わせる（★届かなくても同期は止めない）。
+#   ★失敗の回は札を出し直し、成功の回は札を閉じる（便 675e2d05）。どちらも同じ呼び方で、
+#     知らせる側が控えの status を見て決める＝ここに判断を二重に書かない。
+craftsman_notify() {
   [[ -f "$CRAFTSMAN_NOTIFY" ]] || return 0
   python3 "$CRAFTSMAN_NOTIFY" "$CRAFTSMAN_LAST" >/dev/null 2>&1 || true
 }
 
+# 直った回だけの呼び口。★確認のみ（APPLY!=1）のときは管制の札に触らない。
+#   【なぜ分けるか】確認のみは「いまどうなっているかを見るだけ」の操作なので、それで
+#     お客さまの画面の札が消える形にしない（配り元の知らせ dist_notify と同じ流儀）。
+#   ★失敗の回は従来どおり確認のみでも知らせる（古い決まりのまま動いていることは見せ続ける）。
+craftsman_notify_recovered() {
+  [[ "$APPLY" == "1" ]] || return 0
+  craftsman_notify
+}
+
 info "①-d 職人の鉄則スキル: $CRAFTSMAN_SKILL_DST"
 CRAFTSMAN_VER="$(craftsman_skill_version)"
 CRAFTSMAN_SHA="$(craftsman_skill_sha "$CRAFTSMAN_SKILL_SRC")"
 if [[ ! -f "$CRAFTSMAN_SKILL_SRC" ]]; then
   warn "鉄則の正本が見つかりません: $CRAFTSMAN_SKILL_SRC（★古い鉄則のまま動きます）"
   craftsman_record failed src-missing "$CRAFTSMAN_VER" none
-  craftsman_notify_failure
+  craftsman_notify
 elif [[ ! -s "$CRAFTSMAN_SKILL_SRC" ]]; then
   warn "鉄則の正本が空です: $CRAFTSMAN_SKILL_SRC（★古い鉄則のまま動きます）"
   craftsman_record failed src-empty "$CRAFTSMAN_VER" none
-  craftsman_notify_failure
+  craftsman_notify
 elif cmp -s "$CRAFTSMAN_SKILL_SRC" "$CRAFTSMAN_SKILL_DST" 2>/dev/null; then
   info "   最新です（版 ${CRAFTSMAN_VER} / 中身 ${CRAFTSMAN_SHA}）"
   craftsman_record ok already-current "$CRAFTSMAN_VER" "$CRAFTSMAN_SHA"
+  # ★配れているので、出ていた「決まりが古いままです」の札を閉じる（便 675e2d05）。
+  craftsman_notify_recovered
 elif [[ "$APPLY" == "1" ]]; then
   # ★消える物が在るなら、上書きの【前】に控えを取る。取れなければ上書きしない。
   if ! craftsman_backup; then
     warn "上書きの前の控えを取れませんでした: $CRAFTSMAN_BACKUP_DIR（★鉄則は上書きしません）"
     craftsman_record failed backup-failed "$CRAFTSMAN_VER" "$CRAFTSMAN_SHA"
-    craftsman_notify_failure
+    craftsman_notify
   elif mkdir -p "$(dirname "$CRAFTSMAN_SKILL_DST")" 2>/dev/null \
      && cp -f "$CRAFTSMAN_SKILL_SRC" "$CRAFTSMAN_SKILL_DST" 2>/dev/null \
      && cmp -s "$CRAFTSMAN_SKILL_SRC" "$CRAFTSMAN_SKILL_DST" 2>/dev/null; then
@@ -403,10 +421,12 @@ elif [[ "$APPLY" == "1" ]]; then
     fi
     info "   更新しました（版 ${CRAFTSMAN_VER} / 中身 ${CRAFTSMAN_SHA}・この1台の全現場が共有します）"
     craftsman_record ok applied "$CRAFTSMAN_VER" "$CRAFTSMAN_SHA"
+    # ★直ったので札を閉じる。以前は成功しても閉じに行かず、最大60分出たままだった。
+    craftsman_notify_recovered
   else
     warn "鉄則を配れませんでした: $CRAFTSMAN_SKILL_DST（★古い鉄則のまま動きます）"
     craftsman_record failed write-failed "$CRAFTSMAN_VER" "$CRAFTSMAN_SHA"
-    craftsman_notify_failure
+    craftsman_notify
   fi
 else
   info "   （予定）正本の内容へ揃えます（版 ${CRAFTSMAN_VER} / 中身 ${CRAFTSMAN_SHA}）"

package/systemd/conductor-build-runner.service

@@ -50,5 +50,21 @@ ExecStart=__CONDUCTOR_BIN__ build-runner
 Restart=always
 RestartSec=30
 
+# ★メモリが足りなくなったときに、真っ先に止められないようにする（便 85a9fb64・メモリ対策B）。
+#   【なぜ要るか（実測 2026-09-19・調査 5286ffd5）】機体のメモリが尽きたとき、カーネルは
+#     「使っている量＋落ちやすさの下駄」で止める相手を選ぶ。利用者の常駐は systemd の既定
+#     （DefaultOOMScoreAdjust=200）で下駄を履かされており、200 は「機体の全メモリの20%ぶん
+#     余計に使っている」のと同じ重み＝15.8GB の機体では約3.2GB の下駄になる。
+#     その結果、40MB しか使っていないこの常駐が「3.2GB のプロセス」と見なされ、
+#     本当に重い相手（職人の build・lint が 1〜4.7GB）より先に止められた。実際 2026-09-19 に
+#     常駐18本がまとめて止められ、配達が止まった。
+#   【何をするか】下駄を外して素の値（0）に戻すだけ。特別扱いはしない。
+#     ＝重い相手が先に止められ、配達役は生き残る。★常駐自身が膨らんだ場合は
+#     ふつうに止められる（守りすぎて機体ごと固まる形にしない）。
+#   【なぜ負の値にしないか（実測）】権限のない利用者のプロセスは、落ちやすさを
+#     0 より下げられない（-100 を書くと Permission denied）。負の値を書くと常駐が
+#     起動できなくなるので、下限である 0 にする。
+OOMScoreAdjust=0
+
 [Install]
 WantedBy=default.target

package/systemd/conductor-ear.service

@@ -59,5 +59,21 @@ ExecStart=__CONDUCTOR_BIN__ ear
 Restart=always
 RestartSec=10
 
+# ★メモリが足りなくなったときに、真っ先に止められないようにする（便 85a9fb64・メモリ対策B）。
+#   【なぜ要るか（実測 2026-09-19・調査 5286ffd5）】機体のメモリが尽きたとき、カーネルは
+#     「使っている量＋落ちやすさの下駄」で止める相手を選ぶ。利用者の常駐は systemd の既定
+#     （DefaultOOMScoreAdjust=200）で下駄を履かされており、200 は「機体の全メモリの20%ぶん
+#     余計に使っている」のと同じ重み＝15.8GB の機体では約3.2GB の下駄になる。
+#     その結果、40MB しか使っていないこの常駐が「3.2GB のプロセス」と見なされ、
+#     本当に重い相手（職人の build・lint が 1〜4.7GB）より先に止められた。実際 2026-09-19 に
+#     常駐18本がまとめて止められ、配達が止まった。
+#   【何をするか】下駄を外して素の値（0）に戻すだけ。特別扱いはしない。
+#     ＝重い相手が先に止められ、配達役は生き残る。★常駐自身が膨らんだ場合は
+#     ふつうに止められる（守りすぎて機体ごと固まる形にしない）。
+#   【なぜ負の値にしないか（実測）】権限のない利用者のプロセスは、落ちやすさを
+#     0 より下げられない（-100 を書くと Permission denied）。負の値を書くと常駐が
+#     起動できなくなるので、下限である 0 にする。
+OOMScoreAdjust=0
+
 [Install]
 WantedBy=default.target

package/systemd/conductor@.service

@@ -58,5 +58,21 @@ ExecStart=__CONDUCTOR_BIN__ start -s %i -t working -a "%i常駐"
 Restart=always
 RestartSec=5
 
+# ★メモリが足りなくなったときに、真っ先に止められないようにする（便 85a9fb64・メモリ対策B）。
+#   【なぜ要るか（実測 2026-09-19・調査 5286ffd5）】機体のメモリが尽きたとき、カーネルは
+#     「使っている量＋落ちやすさの下駄」で止める相手を選ぶ。利用者の常駐は systemd の既定
+#     （DefaultOOMScoreAdjust=200）で下駄を履かされており、200 は「機体の全メモリの20%ぶん
+#     余計に使っている」のと同じ重み＝15.8GB の機体では約3.2GB の下駄になる。
+#     その結果、40MB しか使っていないこの常駐が「3.2GB のプロセス」と見なされ、
+#     本当に重い相手（職人の build・lint が 1〜4.7GB）より先に止められた。実際 2026-09-19 に
+#     常駐18本がまとめて止められ、配達が止まった。
+#   【何をするか】下駄を外して素の値（0）に戻すだけ。特別扱いはしない。
+#     ＝重い相手が先に止められ、配達役は生き残る。★常駐自身が膨らんだ場合は
+#     ふつうに止められる（守りすぎて機体ごと固まる形にしない）。
+#   【なぜ負の値にしないか（実測）】権限のない利用者のプロセスは、落ちやすさを
+#     0 より下げられない（-100 を書くと Permission denied）。負の値を書くと常駐が
+#     起動できなくなるので、下限である 0 にする。
+OOMScoreAdjust=0
+
 [Install]
 WantedBy=default.target