Operations Pulse

Operations Pulse

有用で説明可能な運用のための、ローカルファーストなループオーケストレーターです。

Operations Pulse は、定期的なチェックを証拠に、証拠を永続的なチケットに、そしてチケットをレビュー可能な運用メモリーに変換します。デフォルトでは有料サービスなしで動作します。Node.js、SQLite、Git、ローカルファイル、ローカルログがあれば、有用な状況把握ができます。

これは Openly Useful プロジェクトです。有用なものを、オープンに作っています。

認証情報を安全に扱うライブセットアップガイドは、 operations-pulse-five.vercel.app をご覧ください。

v0.1 で提供するもの

• SQLite のチケットおよびパルス台帳。
• リポジトリの状態、ドキュメント、設定済みログファイルを対象とする、読み取り専用のローカルチェック。
• 自己記述型のツールと構造化された結果を備えた MCP サーバー。
• Codex および互換性のあるエージェント向けの、ポータブルな operations-pulse スキル。
• 運用、シグナルレビュー、トリアージ、インテグレーション向けのオプションのロール定義。
• 無料／ローカル、サブスクリプション、ホストの OAuth、セルフホスト可能、独自の認証情報を持ち込む各経路を区別する、接続カタログとガイド付きセットアップ。
• 完全な移行台帳：インポート済み、書き換え済み、参照済み、または除外済みの項目を記録します。

無料優先のクイックスタート

要件：Node.js 24 以降。デフォルトのワークフローでは API キーは不要です。

npm install
npm run build
node packages/core/dist/cli.js init
node packages/core/dist/cli.js pulse run --root .
node packages/core/dist/cli.js tickets list

認証情報をリポジトリ、SQLite データベース、MCP 引数、チャットの記録に含めずに、オプションの読み取り専用アダプターを設定します。

export OPERATIONS_PULSE_GITHUB_TOKEN='stored by your shell or secret manager'
node packages/core/dist/cli.js connections configure \
  --id github --mode env-token \
  --credential-env OPERATIONS_PULSE_GITHUB_TOKEN
node packages/core/dist/cli.js connections test --id github
node packages/core/dist/cli.js pulse run --root . --connections github

GitHub CLI で認証済みのローカルマシンでは、ゼロコピーの代替手段として、そのセッションを読み取り専用チェックにのみ使用できます。トークンが保存または表示されることはありません。

gh auth login
node packages/core/dist/cli.js connections configure --id github --mode github-cli
node packages/core/dist/cli.js connections test --id github

apps/site のブラウザーベースのピッカーで、安全なセットアップ手順を生成できます。認証情報を収集することはありません。ホストの OAuth は、ホスト独自の同意画面で引き続き処理されます。

MCP サーバーを stdio 経由で実行します。

npm run mcp

データベースのデフォルトは .operations-pulse/pulse.sqlite です。OPERATIONS_PULSE_DB で変更できます。

安全性モデル

ツールまたはコマンドが書き込みを行うと明記していない限り、Operations Pulse は読み取り専用です。--create-tickets（または同等の MCP 引数）が明示的に有効化されていない限り、パルスの実行でチケットが作成されることはありません。接続は設定が完了するまで無効で、認証情報がカタログに保存されることはありません。また、外部から見える操作や有料の操作には、別途人間による承認が必要です。

接続レコードには、ID、秘密情報ではない設定、エンドポイント、環境変数への参照のみが保持されます。connections disconnect を実行すると、ローカル台帳からその参照が削除されます。初期アダプターは読み取り専用です。IMAP の未読件数メタデータ、GitHub の本人確認、Linear の閲覧者本人確認、Sentry のプロジェクトアクセス、PostHog のプロジェクトアクセスに対応しています。v0.1 にはリモート変更用アダプターは含まれません。

オプションのハートビート

Node が実行できる環境で、実行範囲を制限したフォアグラウンドのハートビートを実行します。

node packages/core/dist/cli.js heartbeat serve --interval-minutes 30 --root .

macOS では、ユーザーレベルの LaunchAgent を確認してから、明示的にインストールします。

node packages/core/dist/cli.js schedule plan --interval-minutes 30 --root .
node packages/core/dist/cli.js schedule install --confirm-install --interval-minutes 30 --root .

スケジューラーが MCP ツール、モデルの応答、ページの読み込みによってインストールされることはありません。削除するには schedule uninstall --confirm-uninstall が必要です。

リポジトリの構成

• packages/core — SQLite 台帳と決定論的なチェック。
• packages/mcp — MCP stdio サーバー。
• skill/operations-pulse — ポータブルなエージェントスキル。
• plugins/openai/operations-pulse — 生成された Codex スキルと MCP ラッパー。
• plugins/claude/operations-pulse — 生成された Claude Code スキルと MCP ラッパー。
• .agents/plugins/marketplace.json — リポジトリローカルの Codex マーケットプレイス。
• .claude-plugin/marketplace.json — リポジトリローカルの Claude マーケットプレイス。
• mcp-registry/operations-pulse/server.json — 公式 MCP Registry に提出予定のメタデータ。
• publisher/publisher.json — 公開パブリッシャーの正式な情報を反映した、リポジトリ内のミラー。
• agents — オプションのロール定義。
• catalog — 起動時に表示されるツールと接続の説明。
• docs — アーキテクチャ、ワークフロー、接続ガイド、リリースチェックリスト。
• migrations — ソースの一覧とサニタイズに関する判断。
• vendor — 出典を明記したサードパーティ製スキルパック。暗黙的に統合されることはありません。
• apps/site — 依存関係のないプロジェクトサイト。

ステータス

このリポジトリは、初回の一般公開に向けて準備中です。ローカルファーストのコア機能が、サポート対象のベースラインです。IMAP、GitHub、Linear、Sentry、PostHog には読み取り専用アダプターのテストがあります。ホストの OAuth には、互換性のあるホストのネイティブな同意フローが必要です。また、リモート書き込みアダプターはデフォルトでは有効になっていません。

パブリッシャーと登録のモデル

Openly Useful は、パブリッシャーおよび開発者向けのブランドです。openlyuseful.org は、オープンソース、パブリッシャー、ポリシー、セキュリティ、サポートに関する情報を提供します。openlyuseful.com は、Studio および商用サービス向けのサイトです。Openly Useful LLC は設立を予定している法人であり、設立済み、または事業活動中とは示されていません。現在、Openly Useful は創業者個人によって運営されており、設立手続き中も創業者兼所有者は外部向けのソースコード公開とレジストリへの登録を承認しています。

publisher/publisher.json のリポジトリ内ミラーは、公開されている正式な情報を https://openlyuseful.org/publisher/manifest.json から取得します。プロバイダーマニフェストは、公開名、連絡先、名前空間、ポリシー URL をこの記録から導き出します。提出予定のプロバイダーメタデータに記載するリポジトリ URL は、公開予定のソース https://github.com/Openly-Useful/operations-pulse です。

正規のスキルは引き続き skill/operations-pulse です。プロバイダー向けのラッパーのコピーは生成された成果物であり、個別に編集するソースではありません。

npm run registration:sync
npm run registration:check

ラッパーは、ポータブルなスキルと、変更不可の stdio コマンド npx --yes @openly-useful/[email protected] を登録します。アカウントの認証、スケジューラーのインストール、アダプターの設定、認証情報の収集は行いません。対応する MCP Registry の ID は org.openlyuseful/operations-pulse です。プラグインのインストールまたはアップグレード後、Codex で新しいタスクを開始するか、Claude Code を再起動して、ホストに MCP ツールを再読み込みさせてください。デフォルトでは、MCP データベースはホストプロセスの作業ディレクトリ内の .operations-pulse/pulse.sqlite にあります。明示的なパスを指定するには、ホスト環境で OPERATIONS_PULSE_DB を設定してください。

ローカルでの生成と検証は可能です。公開リポジトリの作成、パッケージの公開、MCP Registry への提出、マーケットプレイスへの提出、インストール、認証、デプロイは、それぞれ独立した外部作業です。公開可能な両方のワークスペースでは、創業者兼所有者による正確な承認、パブリッシャー ID、ポリシーのソース、名前空間、パッケージ ID、リポジトリの来歴が公開情報と一致しない限り、prepublishOnly で公開が拒否されます。Openly Useful は創業者が運営しており、設立手続き中も承認が明示的に有効であるため、LLC の設立待ちは npm 成果物を公開できない理由にはなりません。名前空間の検証、プロバイダー認証、プロバイダーによる審査は、該当するレジストリまたはプロバイダーのワークフローにおける別個の要件です。