Daily Update — Wiki Maintenance Cycle

ウィキの軽量メンテナンス パスを実行します: ソースの更新状況を確認し、インデックスをリフレッシュし、hot.md を更新し、ターミナル通知が読み取る状態ファイルを書き込みます。

Before You Start

1. 設定の解決 — llm-wiki/SKILL.md の Config Resolution Protocol に従います (CWD で .env → ~/.obsidian-wiki/config → プロンプト設定を検索)。これにより OBSIDIAN_VAULT_PATH と OBSIDIAN_WIKI_REPO が得られます。
2. ボルトスコープの状態ディレクトリを導出 — すべてのランタイム状態は、グローバルではなく、解決されたボルトにスコープされます:

   VAULT_ID=$(echo "$OBSIDIAN_VAULT_PATH" | md5sum 2>/dev/null | cut -c1-8 || md5 -q - <<< "$OBSIDIAN_VAULT_PATH" | cut -c1-8)
   STATE_DIR="$HOME/.obsidian-wiki/state/$VAULT_ID"
   mkdir -p "$STATE_DIR"
   

3. $OBSIDIAN_VAULT_PATH/.manifest.json を読み取ります。

Modes

Run Mode (デフォルト — cron または /daily-update によってトリガー)

メンテナンス サイクルを実行します:

ステップ 1: ソースの更新状況チェック

.manifest.json の各ソースをそのファイルの更新時刻と比較します。以下のように分類します:

• Fresh — mtime ≤ ingested_at
• Stale — mtime > ingested_at (新しいコンテンツが存在しますが、まだ取り込まれていません)
• Missing — ソース ファイルがもう存在しません

ステップ 2: インデックスのリフレッシュ

$OBSIDIAN_VAULT_PATH/index.md を読み取ります。ボルト内のいずれかのページがインデックスに見つからない場合 (またはその逆)、インデックスを更新します。find $OBSIDIAN_VAULT_PATH -name "*.md" -not -path "*/_*" を使用してボルト ページを列挙し、インデックスと照合します。

ステップ 3: hot.md の更新

hot.md を読み取ります。フロントマターの updated: に基づいて 48 時間以上古い場合は、再生成します: 最近に変更された 10 個のウィキ ページを読み取り、ウィキがカバーする内容の新しい ~500 語のセマンティック スナップショットを書き込みます。これにより、完全なボルト クロールなしで、次のセッションのコンテキストを温かく保ちます。

ステップ 4: 状態を書き込む

"Before You Start" で導出されたボルトスコープの $STATE_DIR に書き込みます:

date +%s > "$STATE_DIR/.last_update"
echo "<stale_count>" > "$STATE_DIR/.pending_delta"
echo "$OBSIDIAN_VAULT_PATH" > "$STATE_DIR/.vault_path"

ステップ 5: impl-validator をスポーン

サイクル後、impl-validator をサブエージェントとしてスポーンします:

impl-validator check:
  goal: "Daily wiki maintenance — index reconciled, hot.md refreshed, state file written"
  artifacts:
    - $OBSIDIAN_VAULT_PATH/index.md
    - $OBSIDIAN_VAULT_PATH/hot.md
    - $STATE_DIR/.last_update
    - $STATE_DIR/.pending_delta
  checks:
    - Does .last_update contain a recent Unix timestamp (within the last 60 seconds)?
    - Does .pending_delta contain a non-negative integer?
    - Does hot.md have an updated: frontmatter field set to today?
    - Does index.md list at least as many pages as exist in the vault?

ログ記録の前に FAILs を適用します。

ステップ 6: ログ

$OBSIDIAN_VAULT_PATH/log.md に追記します:

- [TIMESTAMP] DAILY-UPDATE fresh=N stale=N missing=N index_added=N hot_refreshed=true|false

ステップ 7: ユーザーに報告

## Daily Wiki Update

- Sources: N fresh · N stale · N missing
- Index: N pages (N added, N removed)
- hot.md: refreshed / up to date

Stale sources (run to sync):
  /wiki-history-ingest claude   — N sessions since last ingest
  /wiki-history-ingest codex    — N sessions since last ingest

Setup Mode ("set up the daily cron" または "install terminal notification" によってトリガー)

ユーザーを初回セットアップのプロセスで案内します:

ステップ 1: スクリプトの存在を確認

$OBSIDIAN_WIKI_REPO/scripts/daily-update.sh が存在し、実行可能であることを確認します。存在しない場合は、ユーザーをそこへ指させます。

ステップ 2: launchd plist をインストール

# plist 内のプレースホルダを置換
sed "s|OBSIDIAN_WIKI_REPO|$OBSIDIAN_WIKI_REPO|g" \
  "$OBSIDIAN_WIKI_REPO/scripts/com.obsidian-wiki.daily-update.plist" \
  > "$HOME/Library/LaunchAgents/com.obsidian-wiki.daily-update.plist"

# ロード
launchctl load "$HOME/Library/LaunchAgents/com.obsidian-wiki.daily-update.plist"

ステップ 3: ターミナル通知をインストール (オプション)

ユーザーに尋ねます: "ウィキが古い場合、ターミナル リマインダーが必要ですか? (y/n)" — ユーザーが "no" と言った場合、またはヘッドレス/VPS 環境の場合はこのステップをスキップします。

"yes" の場合は、ユーザーのシェルを検出し、正しい rc ファイルをターゲットにします:

SHELL_NAME=$(basename "$SHELL")   # zsh, bash, fish, etc.
case "$SHELL_NAME" in
  zsh)  RC_FILE="$HOME/.zshrc" ;;
  bash) RC_FILE="$HOME/.bashrc" ;;
  *)    echo "Shell '$SHELL_NAME' not auto-detected. Add the source line manually to your shell rc file." ; return ;;
esac

wiki-notify.sh が既にそのの rc ファイルでソースされているかどうかをチェックします。そうでない場合は、追記します:

echo "" >> "$RC_FILE"
echo "# obsidian-wiki terminal notification" >> "$RC_FILE"
echo "source $OBSIDIAN_WIKI_REPO/scripts/wiki-notify.sh" >> "$RC_FILE"

Fish シェルの場合、ソース構文は異なります — マニュアル命令を提供します:

# Add to ~/.config/fish/config.fish:
bass source $OBSIDIAN_WIKI_REPO/scripts/wiki-notify.sh
# (requires bass plugin, or copy the logic natively)

ステップ 4: スクリプトを 1 回実行

bash "$OBSIDIAN_WIKI_REPO/scripts/daily-update.sh"

これにより $STATE_DIR/.last_update を初期化して、ターミナル通知が直ちに機能するようにします。

ステップ 5: 確認

ユーザーに以下を伝えます:

• cron は毎日午前 9 時に実行されます (見落とされた場合は次のログイン時に実行)
• ターミナル通知は、ウィキが 20 時間以上古い場合に表示されます
• 状態は ~/.obsidian-wiki/state/<vault-id>/ に保存されます — 複数のボルトを個別にサポートします
• /daily-update でいつでも強制的に同期を実行できます
• ログは /tmp/obsidian-wiki-daily.log に保存されます