woostack-doctor

woostack-doctor

リポジトリの .woostack/ ワークスペースの健全性を診断し、明示的な承認がある場合に限り修復します。Doctor はローカルの整合性と規約を確認するもので、ワークスペースの作成、計画成果物の公開、機能ボードの調整、リモートリソースの修復は行いません。

次の 2 つのレイヤーがあります。

• ヘッドレスの scripts/doctor.sh エンジンは、プロバイダーに依存しません。すべてのチェックは静的で、認証情報を読み取らず、ネットワーク呼び出しも行いません。
• 対話型の修復レイヤーではローカル変更セットを提案し、承認前に変更を加えることはありません。このワークフローの制限のもとで、明示的に承認されたローカル修復のみを適用します。その際、同梱の実装パターンと検証手順を使用します。リモートデータと保持データは、報告のみの対象です。

コマンド

• /woostack-doctor [path] — ワークスペースを診断し、内容を説明できるローカルの検出事項について、承認を条件とする変更セットを提示します。
• /woostack-doctor [path] --check — 診断のみを行い、GitHub 形式の注釈を出力します。error の検出事項がある場合、またはチェックを完了できなかった場合は、ゼロ以外の終了コードで終了します。変更は一切加えません。

エンジンは、ローカルに同梱されたテンプレートと正式な設定リゾルバーを使用します。ほかの Woostack スキルやソースチェックアウトは必要ありません。

手順

1. ワークフローで対象が受け入れられる前に、stat、読み取り、正規化、Git の呼び出しを行わずに、要求された対象を取得します。
2. インストール済みスキルを基準に、scripts/config/resolve-config.sh を通じて、追跡対象とプライマリチェックアウトにあるローカルポリシーを解決します。Doctor は、この権威ある検証結果を使用し、GitHub のスキーマを重複して実装しません。
3. 設定、診断情報、ignore のずれ、保持データについて、静的な読み取り専用チェックを実行します。OMP エージェントの選択はホスト側の責任です。Doctor はプロジェクトのエージェント定義を調査、作成、修復、削除しません。レガシーなプロバイダー設定とミラー時代のマニフェストは保持され、対処可能な廃止案内のみを出します。これらによって移行先が選択されたり、ラッパーが再作成されたり、無関係なローカル診断が妨げられたりすることはありません。
4. .woostack/ がない場合は、ローカルサポートの初期化が明示的に必要であることを報告して停止します。別途要求された初期化ワークフローへの案内は任意であり、前提となるインストールや自動的な引き継ぎではありません。Doctor がひな形を作成することはありません。
5. 検出コード、パス、具体的なローカル変更ごとにグループ化した変更セットを提示します。検出事項で修復方法を説明することはできますが、チェックによって修復が適用されることはありません。
6. 厳格なゲート — 承認。 沈黙は承認ではありません。ローカルファイルの編集に対する承認は、コミット、プッシュ、PR の作成を許可するものではありません。ワークスペースの所有権を確認し、無関係な作業を保持したうえで、承認済みのローカル変更セットのみを適用します。最終検証と必要な独立レビューの前に、同梱の最小限のコードに関するガイダンスに従って、動作を維持するスコープ限定の簡素化を 1 回実施します。変更がないという結果も有効です。同梱の検証手順に従って、影響を受けるチェックを実行します。必須チェックに失敗した場合、成果物を提出できません。コミットまたは PR の提出が明示的に要求された場合に限り、提出手順を使用し、ローカルのみ、またはコミットのみの制限を守ります。ヘルパーコマンドがプロバイダーに接続したり、保持データを変更したりすることはありません。
7. 同じ静的モードで確認し、残存する検出事項を報告します。

厳格な制約

• 設定が欠落していても有効です。github が存在しない場合、Project／Status ポリシーは選択されていません。
• 最上位の正規の github オブジェクトは、同梱のリゾルバーで一度だけ検証されます。レガシーの artifacts.provider、artifacts.linear、artifacts.plane、および以前のルートプロバイダー設定は、 過去のデータとして不透明なまま保持してください。有効なポリシーとして検証せず、該当する境界で廃止について報告してください。
• 静的診断はプロバイダーに依存しません。認可済みの GitHub 機能の証拠は、呼び出し元の ワークフローがネイティブのホストツールまたはホスト認証済みの gh を通じて読み取ります。Doctor は機能の証明情報を受け取らず、プロバイダーセッションを開始することもありません。
• リモートまたは保持対象のレコードを、スキャフォールド、移行、インポート、ミラー、作成、修復、親の変更、書き換え、クローズ、削除のいずれも行わないでください。認証情報の読み取りや、独自の HTTP／GraphQL トランスポートの呼び出しも行わないでください。
• すべての修復にゲートを設けてください。シンボリックリンク／追跡禁止、プライベートファイル、ロック／CAS、ダーティーワークツリー、読み戻しの安全性を維持してください。マージは決して行わないでください。
• 診断エンジンは .woostack/ のサポートファイルを書き込みません。選択した変更セット内で、明示的に承認された対話型修復のみが書き込みを行えます。Doctor は Git ワークツリーの登録を調査、整理、削除しません。ワークスペースのライフサイクル管理は、ホストまたはリポジトリ所有者がワークスペースのガイダンスに従って行います。