cli-anything-mubu

cli-anything-mubu

Mubu ライブブリッジの正規パッケージ版エントリーポイントです。

インストール

この CLI は正規の agent-harness ソースツリーからパッケージ化されています:

pip install -e .

前提条件:

• Python 3.10 以上
• このマシン上でアクティブな Mubu デスクトップセッション
• CLI から利用可能なローカルの Mubu プロファイルデータ
• 引数なしのデイリーヘルパーを使用する場合は MUBU_DAILY_FOLDER を設定してください

エントリーポイント

cli-anything-mubu
python -m cli_anything.mubu

サブコマンドなしで呼び出された場合、CLI は対話型 REPL セッションに入ります。

コマンドグループ

Discover

フォルダ、ドキュメント、最近の項目、デイリードキュメントの解決のための検出コマンドです。

コマンド	説明

| docs | ローカルバックアップから最新の既知のドキュメントスナップショットを一覧表示します。 |

| folders | ローカルの RxDB ストレージからフォルダメタデータを一覧表示します。 |

| folder-docs | 1 つのフォルダのドキュメントメタデータを一覧表示します。 |

| path-docs | 1 つのフォルダパスまたはフォルダ ID のドキュメントを一覧表示します。 |

| recent | バックアップ、メタデータ、同期ログを使用して最近アクティブなドキュメントを一覧表示します。 |

| daily | Daily 形式のフォルダを検索し、その中のドキュメントを一覧表示します。 |

| daily-current | 1 つの Daily 形式のフォルダから現在のデイリードキュメントを解決します。 |

Inspect

ツリービュー、検索、リンク、同期イベント、ライブノードのターゲティングのための検査コマンドです。

コマンド	説明

| show | 1 つのドキュメントの最新バックアップツリーを表示します。 |

| search | 最新バックアップから一致するノードテキストまたはノート内容を検索します。 |

| changes | ローカルログから最近のクライアント同期変更イベントを解析します。 |

| links | 1 つのドキュメントバックアップから Mubu ドキュメントの外部リンクを抽出します。 |

| open-path | 完全パス、サフィックスパス、タイトル、またはドキュメント ID で 1 つのドキュメントを開きます。 |

| doc-nodes | ライブドキュメントのノードをノード ID と更新ターゲットパスとともに一覧表示します。 |

| daily-nodes | 現在のデイリードキュメントのライブノードを 1 ステップで一覧表示します。 |

Mutate

Mubu API に対するドライラン優先のアトミックなライブ編集のための変更コマンドです。

コマンド	説明

| create-child | ライブ Mubu API に対して 1 つの子ノード作成を構築または実行します。 |

| delete-node | ライブ Mubu API に対して 1 つのノード削除を構築または実行します。 |

| update-text | ライブ Mubu API に対して 1 つのテキスト更新を構築または実行します。 |

Session

現在のドキュメント/ノードのコンテキストとローカルコマンド履歴のためのセッションおよび状態コマンドです。

コマンド	説明

| status | 現在のセッション状態を表示します。 |

| state-path | セッション状態ファイルのパスを表示します。 |

| use-doc | 現在のドキュメント参照を永続化します。 |

| use-node | 現在のノード参照を永続化します。 |

| use-daily | 現在のデイリードキュメント参照を解決して永続化します。 |

| clear-doc | 現在のドキュメント参照をクリアします。 |

| clear-node | 現在のノード参照をクリアします。 |

| history | セッション状態に保存された最近のコマンド履歴を表示します。 |

推奨エージェントワークフロー

discover daily-current '<daily-folder-ref>' --json
        ->
inspect daily-nodes '<daily-folder-ref>' --query '<anchor>' --json
        ->
session use-doc '<doc_path>'
        ->
mutate update-text / create-child / delete-node --json
        ->
--execute only after payload inspection

安全ルール

1. エージェントでの使用にはグループ化されたコマンドを優先してください。フラットなレガシーコマンドは互換性のために残されています。
2. エージェントが出力を解析する場合は常に --json を使用してください。
3. mutate コマンドの前には discover または inspect コマンドを優先してください。
4. ライブ変更はデフォルトでドライランであり、--execute を指定した場合にのみ実行されます。
5. テキストマッチングよりも --node-id と --parent-node-id を優先してください。
6. delete-node は対象のサブツリー全体を削除します。
7. 同一テキストの更新であっても、ドキュメントのバージョン履歴が進むことがあります。
8. 引数なしのデイリーヘルパーを使用する前に、デイリーフォルダ参照を明示的に渡すか MUBU_DAILY_FOLDER を設定してください。

例

対話型 REPL セッション

永続的なドキュメントおよびノードのコンテキストを持つ対話型セッションを開始します。

cli-anything-mubu
# Enter commands interactively
# Use 'help' to see builtins
# Use session commands to persist current-doc/current-node

現在のデイリーノートを検出する

明示的なフォルダ参照から現在のデイリーノートを解決します。

cli-anything-mubu --json discover daily-current '<daily-folder-ref>'

ドライランによるアトミック更新

ライブ変更の前に、送信される正確なペイロードを検査します。

cli-anything-mubu mutate update-text '<doc-ref>' --node-id <node-id> --text 'new text' --json

セッション状態

CLI は軽量なセッション状態を JSON で保持します。

• current_doc
• current_node
• ローカルコマンド履歴

この状態を確認または更新するには、session コマンドグループを使用します。

AI エージェント向け

1. mutate ではなく、discover または inspect から始めてください。
2. 永続化されたコンテキストを復元するには、session status --json を使用します。
3. 生成されるプロンプトや自動化では、グループ化されたコマンドを使用してください。
4. 実際の変更を行った後は、事後条件を確認してください。
5. より厳密な運用上の詳細が必要な場合は、パッケージの TEST.md と README.md を参照してください。

バージョン

0.1.1