「成功」と記録されたのに成果がゼロだった — Cowork スケジュールタスクの無音失敗を終了前アサーションで止める

#!/usr/bin/env bash
# verify_done.sh — 定期処理の「完了条件」を終了前に検証するハーネス
# 使い方: 処理の最後に source して assert_* を並べ、finish_run で締める
set -uo pipefail
 
EVIDENCE_LOG="${EVIDENCE_LOG:-/tmp/run_evidence_$(date +%s).log}"
FAILED=0
 
# 失敗を「握りつぶさず」記録する。第1引数=条件名, 第2引数=実測値の説明
fail() {
  FAILED=1
  printf '[FAIL] %s | %s\n' "$1" "$2" | tee -a "$EVIDENCE_LOG" >&2
}
pass() {
  printf '[ OK ] %s | %s\n' "$1" "$2" | tee -a "$EVIDENCE_LOG"
}
 
# 条件1: ファイルが存在し、下限バイト数を超えている
assert_file_min() {
  local path="$1" min="${2:-200}"
  if [ ! -f "$path" ]; then
    fail "file_exists" "missing: $path"; return
  fi
  local size; size=$(wc -c < "$path")
  if [ "$size" -lt "$min" ]; then
    fail "file_min_size" "$path = ${size}B (< ${min}B)"; return
  fi
  pass "file_min_size" "$path = ${size}B"
}
 
# 条件2: 二つの件数が一致している（例: 日英セット）
assert_count_match() {
  local label="$1" a="$2" b="$3"
  if [ "$a" != "$b" ]; then
    fail "count_match:$label" "left=$a right=$b"; return
  fi
  pass "count_match:$label" "$a == $b"
}
 
# 条件3: コミット SHA が事前値から変化している
assert_sha_changed() {
  local before="$1" after="$2"
  if [ "$before" = "$after" ]; then
    fail "sha_changed" "commit did not advance: $after"; return
  fi
  pass "sha_changed" "$before -> $after"
}
 
# 締め: 一つでも FAIL があれば非ゼロで落とす
finish_run() {
  if [ "$FAILED" -ne 0 ]; then
    printf '\n🛑 完了条件を満たしていません。SUCCESS を記録せず終了します。\n' >&2
    printf '   証拠ログ: %s\n' "$EVIDENCE_LOG" >&2
    exit 1
  fi
  printf '\n✅ 全ての完了条件を満たしました。\n'
}

source verify_done.sh
 
OUT="content/articles/ja/cowork/example.mdx"
SHA_BEFORE=$(git rev-parse HEAD)
 
# ... ここで生成・コミット・push ...
 
SHA_AFTER=$(git rev-parse HEAD)
REMOTE_SHA=$(git rev-parse '@{u}')
 
assert_file_min "$OUT" 800
assert_count_match "ja_en" \
  "$(find content/articles/ja -name '*.mdx' | wc -l)" \
  "$(find content/articles/en -name '*.mdx' | wc -l)"
assert_sha_changed "$SHA_BEFORE" "$SHA_AFTER"
assert_count_match "local_remote_sha" "$SHA_AFTER" "$REMOTE_SHA"
 
finish_run   # ← ここで初めて成功か失敗かが確定する

import hashlib
import os
 
def idempotency_key(*parts: str) -> str:
    """入力の組み合わせから安定したキーを作る。同じ入力なら同じキー。"""
    raw = "\x1f".join(parts).encode("utf-8")
    return hashlib.sha256(raw).hexdigest()[:16]
 
def already_done(key: str, ledger: str = ".run_ledger") -> bool:
    """この入力を以前に完了済みなら True。台帳に1行1キーで記録する。"""
    if not os.path.exists(ledger):
        return False
    with open(ledger, encoding="utf-8") as f:
        return any(line.strip() == key for line in f)
 
def mark_done(key: str, ledger: str = ".run_ledger") -> None:
    with open(ledger, "a", encoding="utf-8") as f:
        f.write(key + "\n")
 
# 使い方: 生成対象を一意に表す入力からキーを作る
key = idempotency_key("cowork", "2026-06-27", "example-topic")
if already_done(key):
    print(f"⏭ 既に完了済み: {key} — スキップします")
else:
    # ... 生成処理 ...
    mark_done(key)   # 完了条件を満たした「後で」だけ台帳に書く
    print(f"✅ 完了を記録: {key}")