pmokeDOCS

監視TUI

コンフィグ・run参照・解析出力を扱うlive terminal dashboard。

pmoke monitor (引数なしのpmokeも同じ) でlive terminal dashboardを開く。 手実行と同じworkflow commandを実行し、その出力を表示する。コンフィグファイルの 編集は行わず、選択command自体の動作を越えたhardware操作も行わない。

配置

  • Header: 状態 (コンフィグが読めればRUNNABLE、diagnosticsがあればBLOCKED)、 実行中runのlabel、分:秒timer。
  • Context bar: 作業directoryとコンフィグpath。狭いterminalではcompact表示。
  • WORKFLOW: command一覧と選択行のDETAIL説明。/でfilter、Enterで実行。
  • RUNS: S2 run browser (後述)。
  • INSPECTOR: 選択commandまたはpin留めrun preview用のSUMMARY、CONFIG、 DIAGNOSTICS、ARTIFACTS、REPORTS tab。
  • ACTIVITY: LIVE、PAUSED、HISTORY状態を持つcommand出力。
  • Footer: focus中paneのkey hint。?でhelp overlayを開く。overlayはevent loopと同じkey registryから生成されるため、表示と実装の乖離がない。

Focus

4 paneが空間順のringを共有する: workflow、runs、inspector、activity。

Key効果
1 / 2 / 3 / 4 (bもrunsへ)workflow / inspector / activity / runsへfocus
Tab / Shift-Tab (l / h、Right / Left)次 / 前paneへfocus
iInspector tab巡回 (inspectorへfocus)
Inspector focus中の1-5Inspector tab直接選択 (5はREPORTS)

Key

全pane共通:

Key効果
?Help overlay切替 (qまたはEscで閉じる)
q終了。command実行中は確認待ち (q再押下で終了、Escで残留)
/Focus中listのfilter (workflowまたはruns)
Enter選択command実行。runs focus中は選択runのpreview pin留め
[ / ]過去run / live activityへ戻る
rコンフィグとfile再読込
Ctrl+C実行中commandの中断
EndLive activity追従
EscDialogを閉じ、検索・選択解除、pane離脱 (実行中commandは中断しない)

List key (j/k移動、g/G先頭・末尾) はfocus中listに適用: workflow 選択、run選択、inspector scroll、activity選択。Activityにはv visual-line選択、y copy、K/J選択拡張、PageUp/PageDownと Ctrl+U/Ctrl+D scrollが加わる。検索入力中は文字がfilterに追加され、 Enter確定、Backspace削除、Esc解除。

Run browser

RUNSは現runと同じ階層のrun directory一覧。scan rootはrun directoryの 親、なければコンフィグfileの親、さらに startup directory。scanはread-onlyで budget付き (最大512 directory、深さ3、200 entry、manifest毎64 KiB)。 部分listにはTRUNC表示を付け、黙って欠落させない。/で名前・path・ 状態・stageをfilterし、Enterで選択runをread-only inspector previewに pin留めする。空状態はno run dirs under scan rootと no runs match the filterの表示。

Reports inspector

S3 のREPORTS tabは、選択中runの内部で何が起きたかを表示する。何も実行 しない。inspector focus中に5で選択 (iで巡回、j/kでscroll)。 上部に選択中runの情報、続いてStagesにrun manifest由来のstage lifecycle 状態、Reportsに各laneのstandalone report要約 (calibrate-report.json、noise diagnostics.json、compare-report.json、 m6-evaluation-report.json) とcalibration.json artifact、 analysis/manifestの公開状態を表示する。probeはすべて上限付き read-only file read。欠落・超過・parse不可のfileは描画を失敗させず、 not found / unreadable表示に劣化する。run未選択時はscan rootと budget、runs browserへのhintを表示する。

安全と環境

  • Command実行中の終了には2度目のqが必要。確認待ち中footerに q again to stop + quit表示。Escでcommandが止まることはない。
  • PMOKE_MOUSE=off (0、no、false、disabledも可) でmouse capture 無効。既定ではclick、drag、wheel有効。
  • PMOKE_MOTION=full|reduced|offで実行中live animationを抑制。
  • 表示truncationはcell基準のため、wide文字でもpaneを溢れない。画面文言は 英語のみ。

目次