ordito-detect-stale
Ordito の 読み出しスキル。IR ストアを走査し、未反映ページ(成果物が IR より古い)を一覧する(§3.4)。
いつ使うか
- 更新(
ordito-update-block)の後、「反映(再生成)しますか?」の確認材料として未反映の件数・対象を提示するとき。 - 生成(
ordito-generate)のonly:"stale"の前段の確認に。 - 読み出しのみで副作用なし。確認は呼び出すAIエージェントが行う。
入力(JSON)
{ "ir_dir": "samples/ir" }
ir_dir(任意)。省略時はリポジトリルートの ordito.config.json の irDir(無ければ samples/ir)で解決する。
出力(JSON)
{ "ok": true, "total": 5, "stale_count": 1,
"stale": [ { "id": "guides/quickstart", "file": "...", "updated_at": "…", "generated_at": "…" } ] }
generated_at が null(未生成)も未反映に含む。
注: 未反映判定は時刻比較(
updated_at > generated_at)。ordito-generateはgenerated_at = max(now, updated_at)で 押印するため、updated_atがマシン時計より未来でも生成後に未反映は解消する(クロックスキュー耐性)。 時刻はミリ秒精度で、連続した update→generate を正しく順序づける。
実行
echo '{}' | node "${CLAUDE_SKILL_DIR}/detect-stale.js"