前読みを head -150 で切っていた朝、読んだ 15.6KB のうち最新日は 3.3KB でした

日付ブロックで読む小さなリーダー

次が、置き換えに使っているスクリプトです。最新日は全文、過去日は指定した節だけを出し、最後に読んだバイト数を標準エラーへ残します。

#!/usr/bin/env python3
"""日次メモを「日付ブロック」単位で読む。
最新日は全文、過去日は指定したセクション（A〜G）だけを出す。
使い方: refpeek.py <file> [過去日数=2] [残すセクション=AE] [バイト上限=8000]"""
import re
import sys
 
 
def load_blocks(path):
    blocks, cur = [], None
    with open(path, encoding="utf-8") as f:
        for line in f.read().split("\n"):
            m = re.match(r"## (\d{4}-\d{2}-\d{2})", line)
            if m:
                cur = {"date": m.group(1), "lines": [line]}
                blocks.append(cur)
            elif cur is not None:
                cur["lines"].append(line)
    return blocks
 
 
def pick_sections(lines, keep):
    out, on = [lines[0]], True
    for line in lines[1:]:
        m = re.match(r"### ([A-G])\.", line)
        if m:
            on = m.group(1) in keep
        if on:
            out.append(line)
    return out
 
 
def main(path, past_days=2, keep="AE", budget=8000):
    blocks = load_blocks(path)
    if not blocks:
        sys.exit("FATAL: 日ブロック見出し (## YYYY-MM-DD) が0件。形式が変わった可能性")
    out = list(blocks[0]["lines"])
    for b in blocks[1:1 + past_days]:
        out += pick_sections(b["lines"], set(keep))
    text = "\n".join(out)
    size = len(text.encode("utf-8"))
    note = "" if size <= budget else f" 上限{budget}超過"
    sys.stderr.write(f"blocks={1 + min(past_days, len(blocks) - 1)} bytes={size}{note}\n")
    print(text)
 
 
if __name__ == "__main__":
    a = sys.argv
    main(a[1],
         int(a[2]) if len(a) > 2 else 2,
         a[3] if len(a) > 3 else "AE",
         int(a[4]) if len(a) > 4 else 8000)

定期タスクの手順書では、head -150 daily_notes.md の 1 行を、次のように差し替えました。

python3 "$WS/_tools/refpeek.py" "$WS/daily_notes.md" 2 AE 8000

標準エラーに blocks=3 bytes=5664 のような 1 行が残るので、実行ログを見れば、その朝に何バイト読んだかを後から確かめられます。バイト上限を超えたときも、出力は止めずに「上限超過」と書き添えるだけにしています。前読みが途中で欠けるより、多めに読んでログに残るほうが、あとで原因を追いやすいと考えたためです。

切り方を変えたら、読むバイト数はこう動きました

同じファイルで、過去日の数と残す節を変えて測った結果です。

過去日から残すのを A（一次情報）と E（期限）だけにすると、3 日ぶんで 5,664 バイト、従来の 36% で済みます。一次情報は「最新版の確認」や訂正を拾うため、期限は日をまたいで残るため、過去日からも拾いたい節でした。

最新日のブロックがいちばん小さい 3,262 バイトに収まることも、改めて分かりました。表の 2 行目と従来の差は、読まなくても今日の判断が変わらなかった量にあたります。

ただし、この数字の読み方には注意が要ります。減ったのは「読んだバイト数」であって、判断の質が同じだったかどうかは、バイト数からは分かりません。そこで次の節の確認が必要でした。

直感に反した点 — 日付で落とすと、まだ使っていない案も一緒に落ちます

過去日から B（困りごと）を外すとき、私は「古い日の B は、もう使い終わっているはず」と思い込んでいました。

確かめるために、過去 3 日の B の中身を見ました。10-17 と 10-16 の B は、どちらも「該当なし」と書かれた 300 バイト台と 420 バイトのメモだけで、案はありませんでした。ところが 10-15 の B には、まだ形にしていない困りごとの候補が 4 件、1,698 バイトぶん並んでいました。

past_days=2 で読むと、10-15 のブロックは丸ごと対象外です。つまり、日付で線を引いたとたん、その 4 件は前読みから見えなくなります。10-15 の 4 件に対応しそうな語が、その後に書き上げた成果物の名前に見当たるかも確かめました。語の一致だけの照合なので、取り上げ済みかどうかの確証ではありませんが、少なくとも見つかったものはありませんでした。

「古い日を落とす」は、「使い終わった情報を落とす」と同じではありませんでした。ファイルが日付で積まれていても、案の寿命は日付とは無関係に決まります。

私は今のところ、こう分けています。

• 過去日から毎回残す節（A・E）は、日付で切って構いません。内容が上書きされるか、日をまたいで有効だからです
• B と G のような「案」の節は、日付でなく状態で切ります。使った案には印をつけ、印のない案だけを数日ぶん読みます
• 印の付け方は、各案の行頭に [used] を追記する程度に留めています。ファイルの形式を大きく変えると、別のタスクが同じファイルを読むときに困るためです

案の節を状態で切るリーダーは、まだ試作の段階です。印を忘れる日が出るかもしれませんし、その場合は案が二重に残るだけなので、落とすよりは安全だと考えています。[used] を手で付ける運用が続くかどうかは、数週間ようすを見てから決めるつもりです。

落とし穴

見出しの形式が変わると、静かに空を読みます。 日付見出しが「## 2026/10/18」や「# 2026-10-18」に変わると、正規表現が 1 件も見つけられません。上のリーダーでは 0 件のとき sys.exit で止めていますが、これを入れる前は何も出さずに終わる版でした。前読みが空だったのに、タスクは「成功」と報告してしまう事態です。定期タスクでは、空の出力を失敗として扱ってください。

標準エラーを標準出力に混ぜないようにします。 バイト数の記録を print にすると、前読みの本文にその 1 行が混ざります。ログ用の行は sys.stderr に出し、本文と分けています。タスクのシェルが両方を同じ画面に束ねる場合でも、あとで検索できるよう接頭辞（blocks=）をそろえておくと便利です。

節の文字を A〜G に決め打ちしています。 ### H. が増えても、[A-G] の正規表現には引っかからず、直前の節の続きとして扱われます。節を増やす日は、正規表現も同じ日に直す、と手順書に書いておきました。

バイト上限の値は、環境に合わせて決めるしかありません。 8,000 バイトという上限は、私のファイルで「最新日＋過去 3 日（A・E）」が 7,526 バイトだったことから置いた、ただの目安です。別のファイルでは別の値になります。まず blockstat.py で自分のファイルの形を確かめてから、上限を決めてください。

切り替えの手順 — 私はこの順で進めました

1. blockstat.py を自分のファイルに実行し、日付ブロックのバイト数と、head -N の切れ目が落ちる位置を控えます
2. 過去日の B・G に、まだ使っていない案が残っていないかを目で確かめます（件数とバイト数だけでも控えておくと後で効きます）
3. refpeek.py を、従来の head -N と並べて 1 回だけ動かし、標準エラーのバイト数を比べます
4. 手順書の head -N を refpeek.py に差し替え、バイト上限は「最新日＋過去 3 日（A・E）」の実測より少し大きい値に置きます
5. 数日ぶんの実行ログで blocks= の行を見て、上限超過が続く日がないかを確かめます

過去日の数は、私は 2〜3 日、残す節は A と E を目安にしています。案の節（B・G）を残すかどうかは、2 の確認で決めるのが安全だと感じています。

次の一回で試すこと

まず、前読みに使っている head -N や tail -N が、手元のファイルで何バイトを運んでいるかを、blockstat.py のような短いスクリプトで測ってみてください。日付ブロックのバイト数が日によって 2 倍近く違うなら、行数の上限は予算の代わりになっていません。

そのうえで、過去日を落とす前に、その日に「まだ使っていない案」が残っていないかだけ確かめることをおすすめします。私は今回、確かめていなかったら 4 件の案を知らないうちに手放すところでした。

読む量を減らす考え方そのものは、以前お伝えした定期タスクの手順書を削る前に再読込の回数を数える方法の続きにあたります。あちらは「何回読み直されるか」、この記事は「何を最初の一回で読むか」を扱っています。両方を合わせて見ると、削ってよい場所の見当がつけやすくなります。

日本語ファイル名の濁点が分かれている問題のように、数えてみて初めて分かる偏りは、前読みにも潜んでいました。数字を出してから切る、という順番を、これからも守っていきたいと思います。