slivingdoc

テストカバレッジ: 83.7% 😍👌

機能

• Gitライクなセマンティクス: slivingdoc は私たち（およびエージェント）が皆知っている用語を使用し、使いやすさを考慮して設計されています。

• 自動競合解決: 恐れずにコミットしてください。すべての競合が解決されるまで受け入れられないことを信頼してください。

• 高速処理: ソリューションは概念的には非常にシンプルで、非常に高いスケールと並列処理を可能にします。

• プラグアンドプレイ: バケットをセットアップし、それを指定して、ノートの同期を開始するだけです。

docs/slivingdoc-v1.md は、これらの保証の背後にある完全な承認済み契約です。

Related MCP server: Cellar

はじめに

エージェンティックハーネスに追加します:

{
  "mcpServers": {
    "slivingdoc": {
      "command": "npx",
      "args": [
        "-y",
        "slivingdoc",
        "serve",
        "--bucket",
        "my-notes",
        "--workspace-root",
        "/srv/notes"
      ],
      "env": {
        "AWS_ACCESS_KEY_ID": "<your-access-key-id>",
        "AWS_SECRET_ACCESS_KEY": "<your-secret-access-key>",
        "AWS_REGION": "us-east-1"
      }
    }
  }
}

バケットは存在している必要があり、認証情報は通常のAWSチェーンから取得されます。まだS3アカウントをお持ちでない方は、examples/seaweedfs/ でステップバイステップのチュートリアルとともにローカルのSeaweedFSコンテナを実行します。GitHubリリース からネイティブバイナリを直接ダウンロードすることもできます（slivingdoc-v<semver>-<os>-<arch>）。

対応プラットフォーム: Linux (amd64, 32ビットARMv7, arm64), macOS (amd64, arm64), Windows (amd64)。32ビットLinux ARMアーティファクトはRaspberry Pi OS armhfをサポートします。

仕組み

サーバーはstdioを介して2つのMCPツールを公開します:

notes_pull は現在のノートブックをディレクトリに書き込みます。notes_commit は変更を公開し、同時発生した競合のない変更を取り込みます。呼び出し間にはまったくプロトコルがありません。エージェントは既に持っているツールでファイルを編集し、人間は任意のエディタで同じディレクトリに書き込むことができます。次のコミットでは、それらの変更も反映されます。

人間は、MCPホストなしで両方の操作を直接実行することもできます。相対パスは、作業ディレクトリに対して解決されます:

slivingdoc pull notes
# edit UTF-8 text files under notes/
slivingdoc commit notes -m "meeting summary"

成功すると、統合された結果レポートが出力されます: OK ステータス、受け入れられたリモート世代、ファイルごとの挿入および削除カウント、および合計トレーラーです。ドメインエラーが発生した場合、ゼロ以外で終了し、率直なレポート（エラーカテゴリ、再試行可能な判定、競合した各ファイルとその行範囲）を出力します。色は実際のターミナルでのみ表示され、空でない NO_COLOR によって無効になります。

git部分

すべてのエージェントが同時に書き込むことも可能ですが、レースコンディションに追い越されてしまいます。そのため、slivingdoc には libgit2 を介した組み込みgitがあり、実質的に以下を実行します:

1. git pull

2. （ローカルでの潜在的な競合解決）

3. git add .

4. git commit -m "<agent message>"

5. git push

6. （ローカルでの潜在的な競合解決）

これらのgit操作はすべて、ノートディレクトリのプライベートミラー内でローカルに処理され、「合理化された」gitシーケンスを残します。これは2つの妥協点により機能します。第一に、ローカルノートディレクトリは notes_pull で変更される可能性があり、優先順位はリモート状態にあり、競合マーカーが残ります。第二に、システムはテキスト（クリーンなUTF-8）に対してのみ機能します。

設定

serve、pull、commit は同じフラグと環境変数を読み取ります。--bucket は必須です。最も一般的なフラグ:

slivingdoc serve -h で完全なリファレンスが出力され、docs/running.md でオペレーターに必要なすべて（すべてのフラグ、正確なS3権限、ロギング（stderrの LOG_LEVEL）、ノートブックルール、競合回復、チェックポイント保持）をカバーしています。terraform/ のTerraformモジュールは、1つのノートブック用にバケットと最小権限のIAMユーザーをプロビジョニングします。

開発

• AGENTS.md — 開発者およびエージェントガイド: パッケージマップ、操作フロー、規約、QAゲート。

• docs/slivingdoc-v1.md — 承認済みアーキテクチャ契約。

• docs/build.md — ネイティブビルド、固定されたlibgit2ソースから依存関係検査まで。

• docs/testing.md — テストコマンド、テストレイヤー、ライブAWS禁止ルール。

• docs/releasing.md — リリースアーティファクト、npmトラステッドパブリッシング、make release。

make qa #lint plus the full Go and npm test suites

ライセンス

MIT — LICENSE を参照。静的にリンクされたlibgit2のサードパーティ通知は NOTICE にあります。

Paris Hiltonとは提携していません。