# Portability: SYSTEM
# Last validated: 2026-05-17
# Next review: 2027-05-17
# 次のチェック: 2026-11-15

DAEMON - バックグラウンド ジョブとスケジューラ
=======================================
注: 「bach デーモン」は「bach スケジューラ」の別名です。
現在のドキュメント: bach --helpスケジューラ

日付: 2026-02-08 (2026-02-28 以降のエイリアス)

重要なポリシー
---------------
**すべてのデーモン ジョブはデフォルトで無効になっています。**

理由: 自動プロセスはアクティブなチャット セッションで動作します。
とプロンプトジェネレーターが衝突します。仕事は手作業のみ
必要に応じてアクティブ化されます。

デーモンは、操作中に OneDrive 同期を自動的に一時停止します。
同期の競合を避けるため。

参照: docs/CONCEPT_daemon_policy.md

CLI コマンド
-----------
  bach daemon jobs              すべてのジョブを表示
  bach daemon status            デーモン ステータス
  bach daemon doctor            スケジューラのプリフライトとリカバリのメモ
  bach daemon start [--bg]      スケジューラを開始 (バックグラウンド用に --bg)
  bach daemon stop              スケジューラを停止
  bach daemon run <ID>          単一ジョブの実行を手動で停止
  bach daemon logs [N]          最後のログ エントリを表示 (デフォルト: 20)

SESSIONシステム [非推奨]
---------------------------
  ⚠️ 2026 年 5 月 17 日以降非推奨になりました。
  理由: キーボード シミュレーション (Ctrl+Alt+Space、Paste、Enter) に pyautogui を使用しました。
  アクティブなセッションへの制御されていないプロンプト インジェクションが作成されました。

  置換: Buddha Control API (:8081/api/chat) または Claude Code /loop.

  CLI コマンドは下位互換性のために引き続き存在します:
  bach daemon session status                   セッション ステータスの表示
  bach daemon session doctor                   セッション プリフライトおよびリカバリ ヒント
  bach daemon session pause/resume/steer       オペレーター制御

ジョブ タイプ
---------
  間隔 一定期間後の繰り返し (例: 24 時間、30 分)
  cron スケジュールベース (例: "0 2 * * *" = 毎日午前 2 時)
  イベント イベントベースのトリガー (外部トリガー)
  手動 手動でのみ実行できます
  チェーン チェーンされたジョブの実行 (チェーン システム)

デーモンは、5 分ごとに定期的なタスクを自動的にチェックします。

利用可能なジョブ (デフォルトではすべてオフ)
-------------------------------------------
注: ジョブ リストは動的です。現在のジョブ経由: bach デーモン ジョブ

ジョブの例:
  ID名 スケジュール機能
  -- ----------------------- -------- --------------------------------
  1 スキャナー 60m タスクのソフトウェアフォルダーをスキャン
  2 バックアップ 24 時間自動バックアップ
  3 つの受信トレイ スキャン プロセス 30m の受信トレイ フォルダー
  4 つの統合ウェイト 24 時間メモリ ウェイト (減衰)
  5 consolidate-archive 24h 古いエントリをアーカイブする
  6 consolidate-index 7d ヘルプ/Wiki インデックスの更新
  7 つの統合圧縮 24 時間圧縮セッション
  8 consolidate-we 7d 毎週の統合
  9 夜間メンテナンス cron 0 2 夜間メンテナンス チェーン
  10 週次バックアップ cron 0 3 0 週次バックアップ

コネクタ ジョブ (v2.0、bach コネクタ セットアップ デーモン経由):
  --connector_poll_and_route 2m コネクタ 花粉 + インボックス ルーティング
  --connector_dispatch 1m 送信キューを再試行して送信します

ジョブを手動で実行
----------------------
自動スケジューラの代わりに推奨される方法:

  # ジョブを 1 回実行します
  bach daemon run 1         # スキャナーを 1 回実行します
  bach daemon run 2         # バックアップを 1 回作成します

  # または直接コマンド
  bach scan run             # Scanner
  bach backup create        # Backup
  bach consolidate run      # Consolidation

GUI
---
  http://127.0.0.1:8000/daemon デーモン ダッシュボード

  - ジョブの有効化/無効化
  - 手動で実行する
  - 最新リリースを参照

関連項目
----------
  docs/CONCEPT_daemon_policy.md デーモン ポリシー
  docs/help/connector.txt コネクタ システム (キュー、リトライ)
  docs/help/maintain.txt メンテナンスツール
  docs/help/backup.txt バックアップ システム
  docs/help/consolidation.txt メモリの統合
