# Portability: UNIVERSAL
# Last validated: 2026-05-17
# Next review: 2027-05-17

CLI 規約 (v2.0 レジストリ ベース)
=======================================

アーキテクチャ:
----------------------------------------
BACH は core/registry.py 経由で自動検出を使用します。
- Hub/*.py 内のハンドラーは自動的に検出されます
- 静的ハンドラー マップは不要です (v1.x のような)
- ルーティング順序: --handler → インラインコマンド → スキルエクスポート →
  バックアップの復元 → レジストリ → ツール フォールバック

標準パターン (git、npm、docker など):
  bach SUBCOMMAND [args]     アクションの実行
  bach --HANDLER [args]      -- プレフィックス付きのハンドラー

2 つのアクセス パス:
----------------------------------------
1。 CLI (人間用):
   python bach.py タスク リスト

2.ライブラリ API (LLM/スクリプト用 - 推奨):
   bach_api インポートタスクから
   task.list()

コア サブコマンド (管理):
----------------------------------------
  タスクタスク管理（追加、リスト、完了、ブロック、次へ）
  mem ワーキングメモリ (書き込み、読み取り、ステータス、アーカイブ)
  メモリ 拡張メモリ ハンドラー (事実、教訓、アーカイブ)
  msg メッセージング システム (送信、リスト、読み取り、ping)
  レッスン 学んだレッスン (追加、リスト、検索、アーカイブ)
  バックアップ データベースのバックアップ
  復元 バックアップから復元
  dist ディストリビューションとリリース管理
  パートナー パートナーネットワーク (コーディネーション クロード/ジェミニ/オラマ)
  セッション セッション管理と概要

エージェントとエキスパート (専門分野):
----------------------------------------
  税務専門家（税務署、期限、領収書）
  ati ATI エージェント (コンセプト開発)
  aboサブスクリプションサービス（解約・契約）
  レポート レポート ジェネレーター (資金レポート ICF)
  健康 健康アシスタント
  家計管理
  保険 保険管理

サービスとインフラストラクチャ:
----------------------------------------
  GUI ダッシュボード コントロール (開始、停止、ステータス)
  メンテナンス用スケジューラ バックグラウンド サービス (旧名: デーモン)
  スキャン入力スキャナー (受信箱、OCR)
  コネクタ コネクタ管理 (ポーリング、ディスパッチ、セットアップ デーモン)
  mount 外部リソースのマウント
  チェーンツールチェーンエンジン（自動化）
  日常業務管理（朝/夕方/プロジェクト開始）
  繰り返し発生する繰り返しタスク

自己拡張とフック:
----------------------------------------
  スキル <名前> --type <タイプ> を作成します 新しい能力を足場にします
                                       タイプ: ツール、エージェント、エキスパート、ハンドラー、サービス
  スキル リロード ホット リロード (レジストリ + ツール + スキル)
  フックステータス すべてのフックとリスナーのステータス
  フックイベント すべてのイベントをリストする
  フックログ 最後のフック実行
  フックテスト <event> テストイベントを発行します
  プラグインリスト ロードされているプラグインを表示
  plugins load <path> plugin.json からプラグインをロードします
  plugins unload <name> プラグインをアンロードします
  プラグインは <名前> Scaffold プラグイン マニフェストを作成します
  プラグイン ツール すべてのプラグイン ツールを表示

システム ツール:
----------------------------------------
  ウィキ知識ベース (wiki/)
  内部スクリプトのツール管理
  tuev 検証およびテスト システム
  ユースケース テスト ケース (tuev の一部)
  時刻システム (現在、フォーマット、解析)
  タイマー タイマーの開始/停止
  カウントダウン カウントダウンを作成する
  ビート統一時間表示（時計、タイマー、カウントダウン、ビトウィーン）
  2 つの時点の間の時間の間
  メンテナンス機能を維持する (データベースの最適化、ログのクリーン化)
  テスト テスト ランナー (スモーク、統合、フル)

HANDLER WITH -- (拡張関数):
----------------------------------------
  --startup セッションの開始 (初期化、ポーリングの --watch)
  --shutdown セッションの終了 (クリーンアップ)
  --status システムの全体的なステータス
  --help [トピック] トピック/モジュールのヘルプを表示します。
  --memory 詳細なメモリ ハンドラー (事実、教訓)
  --db データベース分析 (bach.db スキーマ/統計)
  --tokens トークンコストの管理
  --inject ツール用インジェクター システム
  --context セッションのコンテキスト ローダー
  --logs システムログ分析 (data/logs/)
  --docs ドキュメントの整合性チェック
  --snapshot システム状態をフリーズします
  --ゴミ箱をゴミ箱に捨てて復元する
  --fs ファイル システム保護 (チェック、修復、ステータス)
  --connections 接続とアクター モデル

インライン コマンド (ツールベース、ハンドラーなし):
----------------------------------------
fs ファイル システムの保護 (チェック、修復、分類、スキャン)
  ファイル ファイル マネージャー (読み取り、書き込み、コピー、移動、削除)
  ocr OCR エンジン (ドキュメント ID または PDF パス)
  llm マルチ LLM プロトコル (--partner=<名前>)
  マップ コール グラフ / 依存関係マッパー

特殊なケース:
----------------------------------------
  スキルのエクスポート 依存関係を解決したスキルのエクスポート
  復元バックアップ <ファイル> 復元バックアップ

両方のバリアントが受け入れられます:
----------------------------------------
歴史的な理由から、これらは多くの場合ハイブリッドで動作します:
  bach partner list     = bach --partner list
  bach gui start        = bach --gui start

DID-YOU-MEAN (あいまい一致):
----------------------------------------
タイプミスがある場合、BACH は同様のコマンドを提案します (レーベンシュタイン ≤2):
  $ bach パートナーリスト → 「パートナーという意味ですか?」
  $ bach taks add → "タスクという意味ですか?"

ツールフォールバック:
----------------------------------------
ハンドラーが見つからない場合、BACH は tools/:
  bach skill_export  → tools/skill_export.py からツールを試行します
  bach backup_manager → tools/backup_manager.py

登録されたハンドラー (2026 年 3 月 4 日現在):
----------------------------------------
自動検出 (hub/*.py) 経由で 109 個以上のハンドラー:
abo、エージェント、ati、バックアップ、ビート、レポート、間、カレンダー、チェーン、時計、
接続、コネクタ、統合、連絡先、コンテキスト、カウントダウン、CV、
デーモン (= スケジューラー)、データ、db、dist、doc、docs、電子メール、拡張機能、fs、ヘルス、gui、
家庭、健康チェック、ヘルプ、フック、注入、ロング、レッスン、ログ、メンテナンス、
mem、メモリ、マウント、メッセージ、通知、黒曜石、オラマ、パートナー、パス、プロファイル、
プロファイラー、繰り返し、リフレクション、ルーチン、スキャン、セッション、シャットダウン、スキル、
スキル、スマートホーム、スナップショット、ソース、スタートアップ、ステータス、税金、同期、タスク、
テスト、タイマー、トークン、ツール、ツール、ゴミ箱、tuev、更新、ユースケース、
保険、Wiki

関連項目:
----------------------------------------
  ヘルプ プラクティス ルールのインデックス
  名前付けのヘルプ 命名規則
  ヘルプコーディング コーディング標準
  ヘルプ アクター アクター モデル (接続)
  ヘルプパートナー パートナープロフィール
  ヘルプ フック フック フレームワーク (14 イベント)
  ヘルプ 自己延長 自己延長システム
