Project Status

StatusGlance

StatusGlance は Openly Useful の可視化ファミリーです。StatusGlance / Readiness は、リポジトリ内の単一マニフェストから、証拠に裏付けられたデリバリー準備状況を把握できます。StatusGlance / RunGlance は、モデルへのポーリングを行わず、観測された実行アクティビティを表示します。どちらも Claude、OpenAI/Codex、汎用 CLI で利用でき、オプションで範囲を限定した読み取り専用の MCP エントリーポイントも利用できます。

この互換性優先のブランド変更リリースでは、project-status と runglance のプラグイン ID、npm/MCP 名、コマンド、ストレージパス、リポジトリ URL、Apache-2.0 ライセンスを維持しています。既存の統合に名前変更の移行は必要ありません。ステータスのリクエストでは既存の証拠を一度読み取ります。作業、検証、監視、インストールは開始しません。

デリバリーループ

Conductor Swarm は実行を担います。変更を観察 → 一貫性のある作業を組み立てる → 準備が整った独立レーンを並行して実行する → マイルストーンで検証と統合を行う → 適応する → 承認済みの作業を継続するか完了する、という流れです。Pickup は不足しているコンテキストを補い、Continuity は実際の引き継ぎを処理します。これらは相互に補完するツールであり、必須の追加エージェントや順番に実行する段階ではありません。Agent Workflow Swarms が実行フレームワークを定義します。

StatusGlance はこのループを観察します。既存のホストイベント、タスク ID、マイルストーンの証拠を使用します。イベントストリームがない場合、アクティビティは不明です。ローカルのセットアップファイルは、ホストへのインストールや接続を証明するものではありません。修正を繰り返す必要がある場合は、レビューのループを際限なく拡大するのではなく、承認済みの実行範囲内でアプローチを変更します。Operations Pulse はオプトインで定期的に実行する運用面の補完ツールです。Skill Feedback Engine は、依頼された場合にのみ、永続的な改善案を提示します。

Alpha、Beta、Live の準備状況

オプションのバージョン管理された delivery 拡張機能 は、既存のマニフェストタスクを参照します。順序付けられたステージスコープでは、受け入れ済みの作業を一度だけ累積します。各ステージには、そのステージ固有の分母、残りのタスクとマイルストーン、次に統合されるマイルストーン、受け入れ条件の未達項目が表示されます。スコープが空の場合は不明のままです。現在のステージの受け入れには、条件を満たす証拠と、解消済みのゲートが必要です。実装の進捗と、過去の重み付きクレジットは分けて扱います。

同梱のダッシュボードは過去のデモであり、ユーザーの現在の製品準備状況を示す証拠ではありません。Alpha、Beta、Live の完了を宣言する前に、実際の製品スコープを設定して検証してください。

このリポジトリには、関連する以下 8 つの成果物が含まれています。

• skill/project-status にある正規のポータブルスキル。
• skill/runglance にあるスタンドアロンの RunGlance スキル。
• 依存関係のない RunGlance ランタイム、ホストアダプター、HUD プリセット、検証ランナー、最終レシート。
• packages/mcp にあるオプションの読み取り専用 Project Status および RunGlance MCP エントリーポイント。
• plugins/ にある、生成された OpenAI/Codex および Claude のプラグインラッパー。
• scripts/package-skill.mjs と scripts/package-runglance.mjs が生成する、決定的な Project Status および RunGlance の ZIP 配布パッケージ。
• React/Vite のステータスプロトタイプと、その OpenAI Sites ワーカービルド。

信頼と安全性のモデル

準備状況、証拠の有効性、ライブ状態、デリバリーアクティビティは、別々のシグナルとして扱います。ブラウザーの更新は監視としてカウントされません。読み取り専用の確認がデフォルトです。マニフェストの編集、スケジュール設定、インストール、公開、デプロイ、コミット、リモートへの書き込みには、それぞれ別途明示的な操作が必要です。

アクティビティでは、コンテキストウィンドウの容量、プロバイダークォータ、タスク予算、金銭的コスト、進捗、ハートビートの鮮度、明示的なロック所有権も個別に扱います。ホストからのデータがない場合は unknown のままとし、ゼロとして表示したり、別の指標から推測したりすることはありません。検証の合格が証明するのは、レシートに記録されたチェックとタスクの結果であり、プロジェクト全体の準備状況ではありません。

リリースツールはリポジトリ内に限定されます。プラグインのインストール、個人用マーケットプレイスの変更、アーカイブの公開、リリースの作成、Sites のデプロイ、選択した成果物ディレクトリ外への書き込みは行いません。

正式なスキルと生成されたラッパー

スキルの動作を変更する場合、編集するソースは skill/project-status だけです。マーケットプレイスのインストーラーはプラグインディレクトリをコピーし、プラグインルート外のパスに安全に依存できないため、2つのプラグインラッパーには skills/project-status に物理コピーが含まれています。

skill/runglance は RunGlance に対応する正式なソースです。生成されたラッパーには skills/runglance と RunGlance 専用の MCP エントリーポイントが含まれ、readiness-manifest ランタイムは含まれません。RunGlance のライフサイクルや HUD の動作を Project Status スキルに戻さないでください。

正式なスキルを変更した後、またはオプションの MCP サーバーをビルドした後は、ラッパーを同期してください。

node scripts/release-sync.mjs sync

CI とローカルの事前チェックでは、読み取り専用の差分チェックを使用します。

node scripts/release-sync.mjs check

同期処理は、ラッパーのマニフェスト、ラッパーのスキルツリー、オプションの同梱 MCP ランタイム、およびリポジトリ内の両方のマーケットプレイスカタログを決定論的に管理します。生成されたラッパーファイルを手作業で編集しないでください。

マーケットプレイスカタログでは、ホストごとに異なるスキーマを使用します。

• .agents/plugins/marketplace.json は OpenAI/Codex リポジトリのマーケットプレイスです。
• .claude-plugin/marketplace.json は Claude Code のマーケットプレイスです。

OpenAI プラグインには常に .codex-plugin/plugin.json が含まれます。両方のプラグインマニフェストで mcpServers が宣言されるのは、packages/mcp/dist/index.js が検証済みの自己完結型バンドルであり、そのロック済みビルドメタデータが存在する場合だけです。それ以外の場合、MCP コンポーネントは壊れたパスを参照するのではなく、省略されます。生成されたラッパーには、その単一のバンドル済みエントリーポイントと共有コアランタイムがパッケージされます。node_modules、パッケージのインストール手順、ソースマップ、宣言ファイルは含まれません。

RunGlance と RunGlance HUD

RunGlance には Node.js 20 以上が必要で、ランタイム依存関係、ネットワーク呼び出し、モデル呼び出し、API キー、リモートストレージ、シェル評価は使用しません。セットアップは確認可能で、リポジトリ内で完結します。

node skill/runglance/scripts/runglance.mjs setup plan --json
node skill/runglance/scripts/runglance.mjs setup instructions --host codex
node skill/runglance/scripts/runglance.mjs setup instructions --host claude
node skill/runglance/scripts/runglance.mjs setup instructions --host generic

setup guided は引き続き読み取り専用です。setup apply --project-root <dir> --host <host> は、そのリポジトリ内の .runglance/setup.json だけを書き込みます。ホストレベルのフックやステータスライン設定には、引き続きユーザーが個別に許可する操作が必要です。

MCP を介さずに、直接実行して開始、描画、検証、完了まで行えます。

node skill/runglance/scripts/runglance.mjs start --name "Release verification"
node skill/runglance/scripts/runglance.mjs watch --preset compact --interval 1000
node skill/runglance/scripts/runglance.mjs verify --name "Unit tests" -- npm run test:unit
node skill/runglance/scripts/runglance.mjs finish \
  --outcome complete \
  --summary "Activity stream verified" \
  --final-summary verified

デフォルトの compact RunGlance HUD には、最も役立つ情報が簡潔に表示されます。standard では実行中と完了済みの作業が拡張表示され、swarm では委任されたエージェントが考慮され、diagnostic ではトラブルシューティングの詳細が表示されます。watch は有用な間だけローカルスナップショットを毎秒更新し、モデルのトークンや MCP 呼び出しを消費しません。描画機能は簡易端末では ASCII に切り替わり、stdout が対話型でない場合は静的な出力を行います。

アダプターは、Codex フック／App Server、Claude フック／ステータスライン、または厳密な汎用プロデューサーからの正規化されたイベントを受け付けます。各メトリックには、exact、derived、estimated、unknown のいずれかの確度区分が保持されます。ランタイム状態はアクセス権が制限され、サイズが制限され、機密情報が除去されます。また、プロンプト、トランスクリプト、環境変数、未加工のツール引数、認証情報、ソースファイルは含まれません。

最終サマリーは off、concise、verified から設定できます。検証済みのレシートには、修正内容、記録されたチェック、安全なローカル再実行コマンド、残作業、経過時間、エージェント数が含まれます。公開アクティビティ API と MCP 投影では、再実行引数とコマンド出力は省略されます。これらは信頼されたローカル CLI の範囲にとどまります。

オプションの runglance-mcp エントリーポイントが公開するのは、runglance_get_status、runglance_list_work、runglance_get_usage、runglance_get_locks、runglance://status だけです。これはクエリ用の補助機能であり、HUD 更新エンジンではありません。

npm run build --prefix packages/mcp
RUNGLANCE_RUNTIME_DIR=/absolute/runtime/path node packages/mcp/dist/runglance-index.js

生成された OpenAI および Claude の RunGlance プラグインには、標準の .mcp.json 記述子が含まれます。そのため、インストール時には各ホストの通常の接続同意 UI を利用できます。API キー、サブスクリプション、リモートアカウント、有料サービスは必要ありません。

開発と検証

CI では Node.js 22 を使用します。ルートアプリケーションの依存関係をインストールし、存在する場合はオプションの MCP パッケージをビルドし、生成されたラッパーを同期して、Sites の出力をビルドし、テストスイート全体を実行します。

npm ci
npm ci --prefix packages/mcp
npm run build --prefix packages/mcp
node scripts/release-sync.mjs sync
npm run build
node --test tests/*.test.mjs
node scripts/release-check.mjs

packages/mcp のコマンドは、このオプションのパッケージが存在する場合にのみ適用されます。npm run build を実行すると、Sites への引き渡し用ファイルが以下に生成されます。

• dist/client/index.html
• dist/server/index.js
• dist/.openai/hosting.json

scripts/release-check.mjs は、ラッパーの差分、バージョンの一致、ホスト固有のマーケットプレイスおよびマニフェストの形式、MCP バンドルの境界、パッケージの安全性、変更履歴の網羅性、決定論的なアーカイブ計画、パッケージ ID、名前空間、公開ポリシーファイル、創設者による公開承認を検証します。公開可能な MCP パッケージはどちらも、prepublishOnly の境界で scripts/assert-publish-ready.mjs を実行します。LLC の設立が保留中のため、npm への公開は創設者の承認が必要です。実際の公開リクエスト時には、レジストリによるアカウント認証も引き続き適用されます。また、プロバイダーのマーケットプレイス審査は別のワークフローであり、npm の公開を妨げません。テストスイートでは、両方のプラグインアーカイブを分離された一時ディレクトリに展開し、依存関係をインストールせずに、バージョンを固定した MCP ハンドシェイクと、準備状況およびアクティビティのツール呼び出しを実行します。

サードパーティに関する通知は、開発ツールチェーン全体ではなく、バージョンを固定した実行時依存関係グラフから生成されます。

npm run notices:plan
node scripts/third-party-notices.mjs build
npm run notices:verify

この生成ツールは、サイトの実行時依存関係とバンドルされた MCP の実行時依存関係を対象とし、各上流ライセンスの異なるテキストを保持して、決定論的に THIRD_PARTY_NOTICES.md を生成します。パッケージ化では、リポジトリの LICENSE、プライバシー、利用規約、セキュリティ、サポート、通知ファイルがない場合、リリースアーカイブの生成を拒否します。また、これらすべてを各 ZIP に含めます。

決定論的な配布物をビルドする

ファイルを書き込まずにパッケージ計画を確認します。

node scripts/package-skill.mjs plan

デフォルトの無視対象／ローカル成果物ディレクトリにビルドするか、別のディレクトリを指定します。

node scripts/package-skill.mjs build
node scripts/package-skill.mjs build --output /tmp/project-status-artifacts

既存の出力が暗黙に置き換えられることはありません。意図的に置き換える場合にのみ --replace を使用してください。ビルド済みのバイト列を、新しい決定論的な計画と照合して検証するには、次を実行します。

node scripts/package-skill.mjs verify --output /tmp/project-status-artifacts

出力一式は次のとおりです。

• project-status-portable-claude-skill.zip
• project-status-openai-plugin.zip
• project-status-claude-plugin.zip
• checksums.json

各 ZIP には MANIFEST.sha256 が含まれます。ビルダーは、シンボリックリンク、パストラバーサル、絶対パス、テスト、依存関係ツリー、.env ファイル、埋め込みユーザーホームパス、一般的な秘密情報の形式を拒否します。アーカイブ内のエントリ順序、メタデータ、モード、JSON の書式、バイト列は決定論的です。

RunGlance も同じ計画／ビルド／検証の仕様に従います。

node scripts/package-runglance.mjs plan
node scripts/package-runglance.mjs build
node scripts/package-runglance.mjs verify

出力一式は runglance-portable-claude-skill.zip、runglance-openai-plugin.zip、runglance-claude-plugin.zip、checksums.json です。

ローカルマーケットプレイスへのインストール

インストールによってホストの状態が変更されるため、このリポジトリのビルドや検証とは意図的に分けられています。信頼できるチェックアウトから、ユーザーはホストの CLI を使ってインストールを選択できます。

Codex の場合：

codex plugin marketplace add .
codex plugin add project-status@project-status-initiative
codex plugin add runglance@project-status-initiative

Claude Code の場合：

claude plugin marketplace add .
claude plugin install project-status@project-status-initiative
claude plugin install runglance@project-status-initiative

インストールする前に、生成されたマニフェストとスキルの内容を確認してください。マーケットプレイスのプラグインは信頼されたコードです。特に、オプションのローカル MCP サーバーが含まれている場合は注意してください。

バージョン管理とリリースゲート

配布バージョンは、VERSION、両方の正規コンポーネントメタデータファイル、生成されたプラグインマニフェスト、Claude マーケットプレイスのエントリー、MCP およびモニターの付属パッケージ、アーカイブのチェックサムに記録されています。node scripts/release-check.mjs により、これらの値が一致していることを確認できます。リリース 1.2.1 は、創業者が運営する公開ゲートと、v1.2.0 の後にマージされた正規化済み npm CLI マニフェストに対応する、来歴を整合させたパッチリリースです。1.1.0 は未公開のソース識別子でしたが、実質的に異なるキャッシュ済みの Project Status 配布版と衝突したため、1.2.0 系ですでに置き換えられています。

publisher/publisher.json は、https://openlyuseful.org/publisher/manifest.json のリポジトリ内ミラー／コンシューマーです。Openly Useful はパブリッシャー／開発者のブランドです。Openly Useful LLC は予定されているパブリッシャー、運営者、ライセンシーですが、設立手続き中であり、すでに設立されたと説明してはなりません。.org はオープンソース、パブリッシャー、ポリシー、セキュリティ、サポートに関する正規の窓口です。.com はスタジオ／商用の窓口です。コンポーネントメタデータには、正規の公開リポジトリ https://github.com/Openly-Useful/project-status と https://openlyuseful.org/support が記載されています。

RunGlance は創業者のみが執筆し、現在も個人所有です。Openly Useful は現在、個人である創業者が運営しており、LLC の設立手続きが完了するまで、オープンソースおよび npm パッケージの公開を創業者が直接許可しています。知的財産の譲渡、所有権の移転、所有権の確認はいずれも必要ありません。将来的に設立される LLC は、創業者の文書化された許可のもとで RunGlance を公開、運営、ライセンスできますが、著作権者になるわけではありません。

ローカルの配布準備状況と npm パッケージの公開準備状況は、それぞれ別の指標です。distributionReady は、ソース、生成されたラッパー、ライセンス／通知、ポリシー、メタデータ、決定論的パッケージを対象とします。publishReady では、さらに以下が必要です。

1. LLC の設立手続き中に有効な、創業者かつ所有者による直接の許可。
2. npm パッケージおよび MCP 名前空間の正確な契約。
3. 正規のプライバシー、利用規約、セキュリティ、サポートに関するポリシーファイル。
4. 最新のライセンス、通知、生成されたラッパー、テスト、決定論的なパッケージ計画。

静的な準備状況の結果に、アカウント認証があるかのように示すことはありません。実際にレジストリへのリクエストを行う際、npm が別途認証を要求します。

OpenAI／Claude によるプロバイダーレビュー、マーケットプレイスへの申請、MCP Registry への申請、デプロイ、将来的な LLC による運営は、それぞれ独立したワークフローです。これらはどれも npm の公開準備状況から推測されるものではなく、プロバイダーレビューは npm への公開を妨げません。

このリポジトリには、変更されていない Apache License 2.0 の本文と、決定論的なサードパーティ通知の一式が含まれています。Apache-2.0 では、ライセンス本文にプロジェクト固有の著作権者／年のプレースホルダーを記載する必要はありません。

リリース履歴については CHANGELOG.md を、保持されているソースおよび所有権の記録については PROVENANCE.md をご覧ください。