runops 2.5.0__tar.gz → 2.6.0__tar.gz

{runops-2.5.0 → runops-2.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: runops
-Version: 2.5.0
+Version: 2.6.0
 Summary: Run ledger and Slurm job submission for HPC simulation projects
 Project-URL: Homepage, https://github.com/Nkzono99/runops
 Project-URL: Documentation, https://github.com/Nkzono99/runops/blob/main/docs/reference.md
@@ -76,6 +76,7 @@ runo init
 | 資源を変えて作り直す | R20261015-0003 を 256 並列・72 時間で作り直して（case はそのまま） |
 | 片付ける | 古い run を整理して。消すものと archive するものを先に見せて |
 | 作り直した旧系列を片付ける | 旧系列は新系列で置き換えたので、対応を記録して archive して |
+| 解析する | この系列の速度を比較して。図とスクリプト、調査メモを系列の `_analysis/` にまとめて |
 | simulator を足す | パッチを当てた ~/BEACH-dev をビルドして、別の simulator として登録して |
 | 更新する | runops と simulator を最新にして |
 | v1 から移る | この project を runops v2 に移行して（`runo migrate-v1` を dry-run で確認してから） |
@@ -100,15 +101,19 @@ lunar-sheath/
 │   │   │   ├── work/            Slurm のログと出力
 │   │   │   └── analysis/
 │   │   └── wc-phiz-scan/        sweep はまとめて 1 階層
+│   │       └── _analysis/      系列・sweep の比較調査（topic ごと）
 │   ├── _scratch/                smoke / debug（期限付き）
 │   └── _archive/                archive した run
 ├── LOG.md                       run をまたぐ結論と次の判断
 ├── notes/                       再利用する知見
+├── analysis/                    複数系列にまたがる調査。共通コードは lib/
 └── AGENTS.md, .agents/skills/, .claude/skills/
 ```
 
 run は ID が変わらないので、directory を移動してもエージェントは見つけられます。
 `work/` は Git の対象外で、`manifest.toml`、`input/`、`job.sh` は Git で追えます。
+解析は依存する run の範囲で置き場所を選び、調査ごとに `README.md`、`scripts/`、`out/`、
+`logs/` をまとめます。判断は `LOG.md` からリンクし、古い解析 job の log は整理候補になります。
 
 ## 対応 simulator
 

{runops-2.5.0 → runops-2.6.0}/README.md

@@ -45,6 +45,7 @@ runo init
 | 資源を変えて作り直す | R20261015-0003 を 256 並列・72 時間で作り直して（case はそのまま） |
 | 片付ける | 古い run を整理して。消すものと archive するものを先に見せて |
 | 作り直した旧系列を片付ける | 旧系列は新系列で置き換えたので、対応を記録して archive して |
+| 解析する | この系列の速度を比較して。図とスクリプト、調査メモを系列の `_analysis/` にまとめて |
 | simulator を足す | パッチを当てた ~/BEACH-dev をビルドして、別の simulator として登録して |
 | 更新する | runops と simulator を最新にして |
 | v1 から移る | この project を runops v2 に移行して（`runo migrate-v1` を dry-run で確認してから） |
@@ -69,15 +70,19 @@ lunar-sheath/
 │   │   │   ├── work/            Slurm のログと出力
 │   │   │   └── analysis/
 │   │   └── wc-phiz-scan/        sweep はまとめて 1 階層
+│   │       └── _analysis/      系列・sweep の比較調査（topic ごと）
 │   ├── _scratch/                smoke / debug（期限付き）
 │   └── _archive/                archive した run
 ├── LOG.md                       run をまたぐ結論と次の判断
 ├── notes/                       再利用する知見
+├── analysis/                    複数系列にまたがる調査。共通コードは lib/
 └── AGENTS.md, .agents/skills/, .claude/skills/
 ```
 
 run は ID が変わらないので、directory を移動してもエージェントは見つけられます。
 `work/` は Git の対象外で、`manifest.toml`、`input/`、`job.sh` は Git で追えます。
+解析は依存する run の範囲で置き場所を選び、調査ごとに `README.md`、`scripts/`、`out/`、
+`logs/` をまとめます。判断は `LOG.md` からリンクし、古い解析 job の log は整理候補になります。
 
 ## 対応 simulator
 

{runops-2.5.0 → runops-2.6.0}/SPEC.md

@@ -119,12 +119,14 @@ v1 で運用した 2 つの project（`project_dust_release`: BEACH、run 120、
       <run_id>--<label>/           # 単発 run
       <sweep_label>/
         <run_id>--<label>/         # sweep で生成された run
+        _analysis/<topic>/        # この group に依存する調査（§9.1）
     _scratch/
       <run_id>--<label>/           # scratch run
     _archive/
       <case_name>/...              # archive された run（元の相対 path を保つ）
   adapters/                # 任意。project ローカル adapter `<name>.py`（§8.1）
   notes/                   # 永続的な知見。1 topic 1 file。runops は管理しない（§9）
+  analysis/<topic>/        # 複数 group にまたがる調査。共通コードは analysis/lib/（§9.1）
   LOG.md                   # project 全体の追記専用ログ（§9）
   AGENTS.md                # agent 向け入口（§10）
   CLAUDE.md                # `@AGENTS.md` のみ
@@ -147,7 +149,8 @@ v1 で運用した 2 つの project（`project_dust_release`: BEACH、run 120、
   `runs/` 配下の任意の場所に移動してよい。runops は manifest の `run.id` で run を
   見つける（§7.2）。
 - 既定の配置先は `runs/<case_name>/`。`--dest` で上書きできる。`_` で始まる
-  directory（`_scratch`、`_archive`）は runops が予約する。
+  directory（`_scratch`、`_archive`、`_analysis`）は runops が予約する。
+  `_analysis` は group の調査用で、run の発見・作成先から除く。
 - run directory の中（自身と子孫）には run を置けない。`--dest` が既存 run の中なら拒否し、
   `delete` は中に別の run があれば拒否する（§7.2 の走査は manifest のある directory で止まる）。
 - run id は `R<YYYYMMDD>-<NNNN>`。その日の既存 run と `.runops/last_run_id` の大きい方に 1 を足す。
@@ -160,7 +163,8 @@ v1 で運用した 2 つの project（`project_dust_release`: BEACH、run 120、
 - `materials/`、`refs/`、`scripts/` などユーザーが置く directory は runops の関知外。
   runops は `runs/`、`cases/`、`.runops/`、`.agents/skills/`、`.claude/skills/`、
   `AGENTS.md`、`CLAUDE.md`、`runops.toml` 以外を作成・変更しない（`LOG.md`、`notes/`
-  は `init` の雛形生成のみ）。
+  は `init` の雛形生成のみ）。例外として `tidy --apply --only analysis-logs` は
+  §7.5 の解析 log を削除できる。解析のスクリプト・結果・README は agent が書く。
 
 ---
 
@@ -503,7 +507,7 @@ adapter が `progress(run_dir)` を持つとき、`sync` は running の run と
 - `runs/` 配下（`_archive/` を含む）を再帰的に走査し `manifest.toml` を集める。
   `.runops/index.toml` に `run_id -> run_dir` の cache を持ち、manifest が cache の
   path に無ければ再走査して cache を更新する。cache は常に再生成可能で、
-  壊れていても動作に影響しない。
+  壊れていても動作に影響しない。`_analysis/` は走査せず、そこにある manifest は run と扱わない。
 - 走査対象は `runs/` のみ。project 外や `runs/` 外の run は扱わない。
 
 ### 7.3 command 一覧
@@ -514,7 +518,7 @@ adapter が `progress(run_dir)` を持つとき、`sync` は running の run と
 | `runo doctor [--json]` | `runops.toml` の妥当性、adapter の import 可否、executable の存在、`sbatch` の有無、skill の鮮度を検査 |
 | `runo update [--skills-only] [-y]` | adapter package を upgrade し、skill を再展開する |
 | `runo build SIM [--force]` | `local_source` simulator を `.runops/build/` に build する（§4.1） |
-| `runo context [--json]` | agent 向け現在地。project 名、simulator、active run 数、直近 run 5 件、scratch 期限切れ数、`LOG.md` 末尾 20 行。配置した runops skill が install 済みの runops より古ければ `runo update --skills-only` を促す warning |
+| `runo context [--json]` | agent 向け現在地。project 名、simulator、active run 数、直近 run 5 件、scratch 期限切れ数、`LOG.md` 末尾 20 行、現用 group の解析 topic 名（§9.1）。配置した runops skill が install 済みの runops より古ければ `runo update --skills-only` を促す warning |
 | `runo case new NAME --simulator SIM [--from CASE]` | case をスキャフォールド。adapter の `case_template()` を展開 |
 | `runo case list` | case 一覧 |
 | `runo new CASE [--why TEXT] [--label L] [--set k=v]... [--job k=v]... [--tag T]... [--scratch] [--dest DIR] [--submit] [--created-by WHO] [--json]` | 単発 run を作る |
@@ -552,7 +556,7 @@ adapter が `progress(run_dir)` を持つとき、`sync` は running の run と
 
 ### 7.5 `tidy` の規則
 
-`tidy` は候補を 4 種に分けて表示する。`--apply` はすべてを実行し、
+`tidy` は候補を 6 種に分けて表示する。`--apply` はすべてを実行し、
 `--apply --only KIND` で絞れる。
 
 | kind | 条件 | 動作 |
@@ -562,8 +566,14 @@ adapter が `progress(run_dir)` を持つとき、`sync` は running の run と
 | `old-completed` | `completed` で `defaults.tidy_archive_days`（既定 90）日より古く、`pinned = false` | archive |
 | `orphan-job` | `submitted`/`running` だが squeue/sacct に job が無い | sync（state 確定） |
 | `unused-build` | `.runops/build/*` のうち、非 archived run の manifest から参照されないもの | delete |
+| `analysis-logs` | §9.1 の解析 directory 配下の `logs/` にある `*.<jobid>.out/err`。組の最終更新が `tidy_failed_days` より古く、同じ log directory・job 名の最新の組ではない | log file のみ delete |
 
 - `--older-than AGE`（例 `14d`）はその回だけ、上の 2 つの日数をどちらもこの値で置き換える。
+- `analysis-logs` は project の `analysis/`、group の `_analysis/`、run の `analysis/`
+  （topic の下も含む）を対象にする。stdout/stderr は同じ job id の組として更新時刻を比較し、
+  最新の組は常に残す。同時刻なら job id が大きい組を最新とする。片方だけの log も同じ扱い。
+  archived / pinned / submitted / running run の解析と、symlink は対象外。
+  適用直前にも対象範囲・更新時刻・最新組を再確認し、条件が変われば削除せず止まる。
 - `--purge-work RUN...` は指定 run の `work/` の中身を削除し `work_purged_at` を記録する。
   adapter が `keep_patterns()` を返す場合、一致するファイルは残す。`completed` 以外は拒否。
   adapter を読み込めない（残すファイルを判定できない）ときは何も消さずにエラーにする。
@@ -710,7 +720,7 @@ runops は `init` と `update` で次を行う。
 
 ### 8.3 runops 自身の skill
 
-runops は次の 5 skill だけを同梱し、simulator skill と同じ仕組みで展開する。
+runops は次の 6 skill だけを同梱し、simulator skill と同じ仕組みで展開する。
 利用者が覚えるコマンドは `runo init` だけとし、それ以外（simulator の追加、更新、v1 移行を含む）は
 エージェントへの依頼で行う。
 各 SKILL.md は 60 行以内に収める。
@@ -720,6 +730,7 @@ runops は次の 5 skill だけを同梱し、simulator skill と同じ仕組み
 | `runops-create-run` | `new` / `sweep` の使い方。`--why` を必ず書く、scratch の使い分け |
 | `runops-check-status` | `sync` → `list` → `log` の順。失敗時の `retry` と `tidy --purge-work` |
 | `runops-tidy` | `tidy` を定期的に実行する判断基準。pin の使い方 |
+| `runops-analyze` | 依存する run の範囲で調査の置き場所を決め、script・結果・log・README をまとめる |
 | `runops-reference` | command 一覧（§7.3 の表をそのまま載せる） |
 | `runops-maintain` | simulator の追加、runops と simulator package の更新、`migrate-v1`、`doctor` の読み方 |
 
@@ -748,7 +759,7 @@ v1 の `emses` / `beach` adapter は次の順で runops 本体から出す。
    見つかると使われなくなる（解決順 1 が優先）ので、ユーザーが消せばよい。
 ---
 
-## 9. ノート
+## 9. ノートと解析
 
 置き場所は 3 つに固定し、runops はどれも「管理」しない（schema、budget、rotation、
 seal、index を持たない）。
@@ -766,10 +777,33 @@ seal、index を持たない）。
   - 複数 run にまたがる結論と次の判断は `LOG.md` に日付付きで追記する
   - 再利用する式・手法・環境の落とし穴は `notes/<topic>.md` に書く。既存 file があれば追記し、
     似た topic の file を増やさない
-  - それ以外の場所（`research/`、`analysis/*.md`、`runs/` 直下など）に note file を作らない
+  - 調査の詳細は §9.1 の README にまとめ、LOG.md からリンクする
 - v1 の `research/results/`、`.runops/insights/`、`research/archive/legacy/` は移行時に
   `notes/legacy/` 配下へ **移動せず** そのまま残し、`notes/README.md` から path を案内する（§11）。
 
+### 9.1 解析の置き場所
+
+| 結果が依存する範囲 | 置き場所 |
+|---|---|
+| 1 run | `runs/.../<RUN>/analysis/`（必要なら `<topic>/`） |
+| 1 group（同じ directory に並ぶ系列・sweep） | `runs/<group>/_analysis/<topic>/` |
+| 複数 group・case または project 全体 | `analysis/<topic>/` |
+| 共通コード | `analysis/lib/` |
+
+- group は directory であり、新しい entity / ID / ledger を持たない。
+- 調査 directory は `README.md`（問い・対象 run id・方法・結果・制約）、`scripts/`
+  （Python、sbatch）、`out/`（図・JSON・CSV）、`logs/`（job の stdout/stderr）からなる。
+  topic は内容で名付け、同じ問いは README に日付付きで追記する。
+- `init` の `.gitignore` は `**/logs/`、`__pycache__/`、`.runops/analysis-env/` を含む。
+  既存 project のファイルは自動で再配置しない。
+- `context` は現用 group の `_analysis/*/README.md` がある topic 名を表示し、
+  `--json` では `group_analysis` に project 相対の group path → topic 名一覧を返す。
+  README 本文や `out/`、simulator の `work/` は読まない。
+- `archive DIR` が group 配下の全 run を移す場合、その group と配下の group の
+  `_analysis/` も同じ相対 path の `runs/_archive/` に移す。run が残る group の解析は残す。
+  確認表示に解析の移動先を含め、移動前に run と解析の全移動先を検査し、既存なら上書きしない。
+  `archive RUN...` / `--older-than` は group の解析を動かさず、`restore RUN` は run のみを戻す。
+
 ---
 
 ## 10. harness 生成
@@ -916,7 +950,7 @@ src/runops/
 | 項目 | 目標 |
 |---|---|
 | `src/runops/` の行数（skill の md を除く） | 8,000 行以下 |
-| CLI command 数（`case new` / `case list` を含む。同じ command の option 違いは数えない） | 25 以下。§7.3 の表の distinct command は 24 |
+| CLI command 数（`case new` / `case list` を含む。同じ command の option 違いは数えない） | 25 以下。§7.3 の表の distinct command は 25 |
 | ユーザーが編集する TOML | `runops.toml`、`case.toml` の 2 種 |
 | runops が書く TOML | `manifest.toml`、`.runops/skills.lock`、`.runops/index.toml` の 3 種 |
 | 依存 | `typer`、`rich`、`tomli-w`、`tomlkit`、`jinja2`、`packaging`（`mcp` を外す） |
@@ -954,6 +988,9 @@ src/runops/
 9b. 同名 adapter が entry point と `adapters/X.py` の両方にあるとき entry point が優先される。
    どちらも無く `generic` でもなければ exit code 2 で案内が出る。
 10. `manifest.toml` の書き込み途中で例外が起きても元のファイルが壊れない。
+11. 解析 log の tidy は最新組・新しい組・対象外ファイルを残し、確認後の更新も削除しない。
+    group の archive は全 run が対象のときだけ解析も移し、衝突時は何も動かさない。
+    context は調査の名前だけを読み、解析内の manifest を run と誤認しない。
 
 ### 13.3 ドキュメント
 
@@ -974,6 +1011,7 @@ v2 の文書は次の 4 ファイルだけにする。
 
 | 項目 | 決定 | 理由 |
 |---|---|---|
+| 解析の配置 2.6.0（2026-10-23） | 依存する run の範囲に応じて run 内 `analysis/`、group の `_analysis/<topic>/`、project の `analysis/<topic>/` にまとめる。skill、log の tidy、group archive、context を対応させる（§9.1） | 報告・図・script・job log が分散・混在していた。group は既存の directory として扱い、新しい entity や command は足さない。既存ファイルの整理は移動一覧を提示してから行う |
 | job の cwd | run_dir（v1 と同じ）。Slurm log は `work/` | v1 adapter の path 規約と実 project の job.sh をそのまま使える |
 | adapter の追加 hook | `configure(sim_config)`、`job_prelude(run_dir)` | generic の `command` 取得と、EMSES の `rm -f *_0000.h5` など v1 の setup command を表す |
 | launcher `kind = "none"` | MPI launcher を使わず program を直接実行 | OpenMP のみの BEACH run 用 |

{runops-2.5.0 → runops-2.6.0}/docs/guide.md

@@ -192,7 +192,7 @@ project の run だけが対象です。同じアカウントの別 project の
 前の job が終わるのを待って投入したいときは、「R20261016-0005 が成功したら投げて」と頼めば
 `runo submit RUN --afterok <job_id>` になります。
 
-## 6. 記録を残す
+## 6. 解析して記録を残す
 
 記録の置き場所は 3 つに決まっています。
 
@@ -202,10 +202,40 @@ project の run だけが対象です。同じアカウントの別 project の
 | 複数の run をまたぐ結論と次の判断 | `LOG.md` に日付見出しで追記 | 今日の scan の結論を LOG にまとめて |
 | 再利用する式、手法、落とし穴 | `notes/<topic>.md`（1 topic 1 file） | Debye 長の見積もり方を notes に残して |
 
-エージェントはこれ以外の場所（`research/`、`analysis/*.md`、`runs/` の下など）にノートを作りません。
 `notes/` に似た topic の file があれば、新しく作らずに追記します。
 
-`runo context` は `LOG.md` の末尾と `notes/` の file 名を表示します。エージェントは作業の始めに
+調査の詳細と図・スクリプトは、結果が依存する run の範囲に合わせてまとめます。
+
+> この系列の速度を比較して。図とスクリプト、調査メモを系列の `_analysis/` にまとめて。
+
+| 依存する範囲 | 置き場所 |
+|---|---|
+| 1 run | `<run_dir>/analysis/`（必要なら topic を切る） |
+| 1 系列・sweep | `runs/<group>/_analysis/<topic>/` |
+| 複数系列・case、project 全体 | `analysis/<topic>/` |
+| 共通コードとそのテスト | `analysis/lib/` |
+
+group は run が並ぶ directory です。登録や新しい ID は要りません。
+topic は `speed-by-version` のように問いの内容で名付け、同じ問いをやり直すときは
+同じ directory の結果を更新し、README に日付付きで追記します。
+
+```text
+<topic>/
+  README.md   問い・対象 run id と path・方法・結果・制約
+  scripts/    Python と sbatch
+  out/        図、JSON、CSV、HTML
+  logs/       解析 job の stdout/stderr（Git 管理外）
+```
+
+エージェントは `runops-analyze` skill を使い、調査の README と、そこへのリンクを含む
+`LOG.md` の判断を更新します。`notes/` は run に依存しない知見に使います。
+解析の追加依存は `.runops/analysis-env/` に置き、重い読み込みや作図はサイトの規則に従って
+計算ノードで実行します。sbatch は調査 directory から投入し、事前に `logs/` を作って
+`#SBATCH -o logs/%x.%j.out` と `#SBATCH -e logs/%x.%j.err` を指定します。
+既存 project のファイルは自動で移動しません。整理を頼むと、移動前に一覧を提示します。
+
+`runo context` は `LOG.md` の末尾、`notes/` の file 名、現用 group の
+`_analysis/*/README.md` がある topic 名を表示します。エージェントは作業の始めに
 これを読むので、前回の続きから話を始められます。
 
 ## 7. 整理する
@@ -221,6 +251,7 @@ run は消さなくても `runo list` が古いものを隠しますが、direct
 | `expired-scratch` | 期限切れの scratch run（archive したものは除く） | 削除 |
 | `stale-failed` | 30 日より古い failed / cancelled で、`why` もノートも無い | 削除 |
 | `old-completed` | 90 日より古い completed | archive |
+| `analysis-logs` | 30 日より古い解析 job の log（各 job 名の最新組は保持） | log のみ削除 |
 | `orphan-job` | 投入済みなのに Slurm が知らない | `sync` で状態を確定 |
 | `unused-build` | どの run も使っていない build cache | 削除 |
 
@@ -239,6 +270,14 @@ run id で引き続き見つかり、`runo restore` で戻せます。
 記録され、理由はノートに残ります。比較用に派生しただけの run は置き換えとは扱わないので、
 旧系列が不要かどうかは毎回確かめます。
 
+directory 指定で group の全 run を archive すると、その `_analysis/` も同じ相対 path で
+移動します。run が残る group の解析は元の場所に残り、移動先に既存の解析があれば、run を
+動かす前に停止します。`archive RUN...` と `restore RUN` は run だけを移動します。
+
+解析 log だけの整理は「古い解析 log を整理して」で `runo tidy --only analysis-logs` に
+なります。各 `logs/` の `*.<jobid>.out/err` を組で比較し、job 名ごとに最新の組を残します。
+片方が新しければ両方とも残し、README、script、結果は削除しません。
+
 論文の図に使う run や基準にする run は pin しておくと、`list` に常に表示され、`tidy` や `delete`
 の対象になりません。
 

{runops-2.5.0 → runops-2.6.0}/docs/reference.md

@@ -6,7 +6,7 @@
 ## runops.toml
 
 project root にあり、`runo` はここを上方向に探して project を特定します。
-command はこの project の `runs/` 配下だけを扱い、別 project の run directory や
+run を対象にする command はこの project の `runs/` 配下だけを扱い、別 project の run directory や
 directory を path で渡すとエラーになります。run id は project ごとなので、同じ id が
 別 project にあっても cwd の project の run を指します。
 
@@ -153,7 +153,7 @@ run id は削除後も再利用しません。`--dest` に既存 run の中は
 | `runo doctor [--json]` | 設定、adapter の解決経路、executable、sbatch、skill の鮮度とリンク切れを点検 |
 | `runo update [--skills-only] [-y]` | simulator package を更新し skill と AGENTS.md の管理 block を再生成 |
 | `runo build SIM [--force]` | `local_source` の simulator を build |
-| `runo context [--json]` | agent 向けの現在地 |
+| `runo context [--json]` | agent 向けの現在地と現用 group の解析 topic 名（JSON の `group_analysis` は group path → topic 名一覧） |
 | `runo case new NAME [-s SIM] [--from CASE]` / `runo case list` | case の作成と一覧 |
 | `runo new CASE [--why] [--label] [--set k=v]... [--job k=v]... [--tag] [--scratch] [--dest DIR] [--submit] [--json]` | run を 1 つ作る。`--job` はこの run の `[job]` の値 |
 | `runo new --from RUN [--set k=v]... [--job k=v]... [--job-from-case] [--continue]` | 既存 run の params と `[job]` から派生（`--job-from-case` で `[job]` は case から）。置き場所の既定は元 run と同じ directory。`--continue` は adapter の restart 対応が必要 |
@@ -173,7 +173,11 @@ run id は削除後も再利用しません。`--dest` に既存 run の中は
 `list` は既定で active、created、直近 `list_since_days` 日、pinned の run を表示し、
 scratch と archived は表示しません。
 
-`tidy` の候補は次の 5 種類です。
+`archive DIR` が group 配下の全 run を移すときは、group の `_analysis/` も同じ相対 path で
+移動します。run が残る group の解析は残し、移動先が存在すれば全 run の移動前に拒否します。
+`archive RUN...` / `--older-than` と `restore RUN` は group の解析を移動しません。
+
+`tidy` の候補は次の 6 種類です。
 
 | kind | 条件 | 動作 |
 |---|---|---|
@@ -182,9 +186,17 @@ scratch と archived は表示しません。
 | `old-completed` | `tidy_archive_days`（既定 90）日より古い completed | archive |
 | `orphan-job` | Slurm が知らない submitted / running | sync |
 | `unused-build` | 非 archived run が参照しない `.runops/build/*` | delete |
+| `analysis-logs` | `tidy_failed_days` より古い解析 log。各 log directory・job 名の最新組は保持 | log のみ delete |
 
 日数は `runops.toml` の `[defaults]` で変えられます。`--older-than 14d` のように指定すると、
 その回だけ両方の日数をその値で置き換えます。pinned の run は `tidy` と `delete` の対象になりません。
 `--purge-work` は adapter を読み込めないと何も消さずにエラーにします。
 
+`analysis-logs` は project の `analysis/`、group の `_analysis/`、run の `analysis/` 配下の
+`logs/*.<jobid>.out/err`（topic の下も含む）に限定します。組の新しい方の更新時刻で年齢を判定し、
+最新組を残します。同時刻なら job id が大きい組を最新とします。片方だけの log も同じ扱いです。
+archived / pinned / submitted / running run の解析と symlink は対象外で、適用直前にも条件を
+確認します。`--json` の解析 log 候補は `files`（削除する project 相対 path）と `cutoff`
+（ISO 日時）も持ちます。確認後に条件が変われば削除せず、再度 tidy を実行するよう案内します。
+
 exit code は 0 が成功、1 が実行時エラー（sbatch 失敗など）、2 が使い方や設定のエラーです。

{runops-2.5.0 → runops-2.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "runops"
-version = "2.5.0"
+version = "2.6.0"
 description = "Run ledger and Slurm job submission for HPC simulation projects"
 readme = "README.md"
 license = "Apache-2.0"

{runops-2.5.0 → runops-2.6.0}/src/runops/__init__.py

@@ -1,3 +1,3 @@
 """runops: run ledger and Slurm job submission for HPC simulation projects."""
 
-__version__ = "2.5.0"
+__version__ = "2.6.0"

{runops-2.5.0 → runops-2.6.0}/src/runops/cli.py

@@ -263,6 +263,8 @@ def context(as_json: bool = typer.Option(False, "--json")) -> None:
         )
     if data["notes_files"]:
         out.print("notes/: " + ", ".join(data["notes_files"]))
+    for group, topics in data["group_analysis"].items():
+        out.print(f"{group}/_analysis/: {', '.join(topics)}", markup=False)
     if data["log_tail"]:
         out.print("--- LOG.md (tail) ---")
         out.print(data["log_tail"], markup=False)
@@ -869,12 +871,22 @@ def archive(
         if m.id in plan.superseded_by:
             line += f"  -> {', '.join(plan.superseded_by[m.id])}"
         out.print(line)
+    for directory in plan.analysis_dirs:
+        dest = project.runs_dir / "_archive" / directory.relative_to(project.runs_dir)
+        out.print(f"  analysis {project.rel(directory)} -> {project.rel(dest)}", markup=False)
     _confirm(f"Archive {len(plan.targets)} runs?", yes)
     archived = archive_runs(
-        project, plan.targets, superseded_by=plan.superseded_by, why=why, by=_actor()
+        project,
+        plan.targets,
+        superseded_by=plan.superseded_by,
+        why=why,
+        by=_actor(),
+        analysis_dirs=plan.analysis_dirs,
     )
     for run_id, dst in archived:
         out.print(f"archived {run_id} -> {project.rel(dst)}")
+    for directory in plan.analysis_dirs:
+        out.print(f"archived analysis {project.rel(directory)}", markup=False)
 
 
 @app.command("mv")

{runops-2.5.0 → runops-2.6.0}/src/runops/harness.py

@@ -12,7 +12,7 @@ END = "<!-- runops:end -->"
 COMMANDS = """\
 | command | effect |
 |---|---|
-| `runo context --json` | where the project stands: active runs, recent runs, LOG.md tail |
+| `runo context --json` | active runs, recent runs, group analysis topics, LOG.md tail |
 | `runo case list` / `runo case new NAME --simulator SIM [--from CASE]` | list / scaffold cases |
 | `runo new CASE --why TEXT [--set k=v]... [--job k=v]... [--scratch] [--submit]` | create one run |
 | `runo new --from RUN --why TEXT [--set k=v]... [--job k=v]... [--continue]` | derive a run (keeps its params and [job]) |
@@ -23,7 +23,7 @@ COMMANDS = """\
 | `runo cancel RUN [--why T]` / `runo retry RUN` | stop a job / reset failed or cancelled to created |
 | `runo note RUN "text"` / `runo pin RUN --reason TEXT` | append an observation / protect a key run |
 | `runo summarize RUN` | adapter summary into analysis/summary.json |
-| `runo tidy` / `runo tidy --apply` | list / apply cleanup (expired scratch, stale failures, old runs) |
+| `runo tidy` / `runo tidy --apply` | list / apply cleanup (runs, builds, old analysis logs) |
 | `runo mv RUN... [--dest DIR] [--label L] --why TEXT` | rename / move runs, keeping ids and inputs |
 | `runo archive RUN\\|DIR... [--superseded-by RUN\\|DIR --why T]` | move created or finished runs (or a series) to runs/_archive |
 | `runo restore RUN` / `runo delete RUN` | move back / remove |
@@ -78,7 +78,7 @@ the project found from the current directory.
   stopped. When a new series replaces an old one, ask whether the old one is still
   needed and archive it with `--superseded-by`.
 
-## Notes
+## Notes and analysis
 
 Notes live in three places, where `runo context` and the next session find them:
 - one run: `runo note RUN "..."`;
@@ -86,6 +86,18 @@ Notes live in three places, where `runo context` and the next session find them:
 - reusable knowledge (formulas, methods, pitfalls): `notes/<topic>.md`, extending the
   existing file for a topic.
 
+Place analysis by the runs its results depend on:
+
+| Scope | Location |
+|---|---|
+| One run | `runs/.../<RUN>/analysis/` |
+| One group (series or sweep directory) | `runs/<group>/_analysis/<topic>/` |
+| Multiple groups or the project | `analysis/<topic>/`; shared code in `analysis/lib/` |
+
+Keep each investigation's question, run ids, method, results and limits in its
+`README.md`, with `scripts/`, `out/` and `logs/` beside it. Link it from `LOG.md`.
+Use `runops-analyze` for this workflow; `runo context` lists group topics with a README.
+
 Analysis tools the simulator package does not bring go in `.runops/analysis-env/`
 (`uv venv .runops/analysis-env`), so `.venv` stays as `runo update` manages it. Run heavy
 reading and plotting where the site allows compute jobs.

runops-2.6.0/src/runops/ops/analysis.py

@@ -0,0 +1,113 @@
+"""Discover conventional analysis directories and disposable job logs (SPEC §9.1)."""
+
+from __future__ import annotations
+
+import os
+import re
+from collections.abc import Iterator
+from datetime import datetime
+from pathlib import Path
+
+from runops.manifest import ACTIVE_STATES, MANIFEST_FILE, Manifest, RunState
+from runops.project import ARCHIVE_DIR, Project
+
+GROUP_ANALYSIS = "_analysis"
+_JOB_LOG = re.compile(r"^(.+)\.([0-9]+(?:_[0-9]+)?)\.(out|err)$")
+
+
+def plain_path(path: Path, root: Path) -> bool:
+    """Within *root*, with no symlink components (including broken links)."""
+    try:
+        relative = path.absolute().relative_to(root.absolute())
+    except ValueError:
+        return False
+    current = root
+    for part in relative.parts:
+        if part == "..":
+            return False
+        current /= part
+        if current.is_symlink():
+            return False
+    return True
+
+
+def group_analysis_dirs(project: Project, under: Path | None = None) -> Iterator[Path]:
+    """Walk current groups, stopping at runs and analysis; never visit work/ outputs."""
+    base = under or project.runs_dir
+    if not plain_path(base, project.root) or ARCHIVE_DIR in base.relative_to(project.root).parts:
+        return
+    for directory, dirs, files in os.walk(base):
+        parent = Path(directory)
+        if MANIFEST_FILE in files:
+            dirs[:] = []
+            continue
+        analysis = parent / GROUP_ANALYSIS
+        if GROUP_ANALYSIS in dirs and not analysis.is_symlink():
+            yield analysis
+        dirs[:] = sorted(
+            d
+            for d in dirs
+            if d not in (GROUP_ANALYSIS, ARCHIVE_DIR)
+            and not d.startswith(".")
+            and not (parent / d).is_symlink()
+        )
+
+
+def group_topics(project: Project) -> dict[str, list[str]]:
+    result = {}
+    for directory in group_analysis_dirs(project):
+        topics = sorted(
+            p.name
+            for p in directory.iterdir()
+            if not p.name.startswith(".")
+            and plain_path(p / "README.md", project.root)
+            and (p / "README.md").is_file()
+        )
+        if topics:
+            result[project.rel(directory.parent)] = topics
+    return result
+
+
+def log_directories(project: Project, runs: list[Manifest]) -> Iterator[Path]:
+    roots = [project.root / "analysis", *group_analysis_dirs(project)]
+    roots += [
+        m.run_dir / "analysis"
+        for m in runs
+        if not m.pinned
+        and m.status not in (*ACTIVE_STATES, RunState.ARCHIVED)
+        and ARCHIVE_DIR not in m.run_dir.relative_to(project.runs_dir).parts
+    ]
+    for root in roots:
+        if not plain_path(root, project.root):
+            continue
+        for directory, dirs, _ in os.walk(root):
+            parent = Path(directory)
+            dirs[:] = sorted(
+                d for d in dirs if not d.startswith(".") and not (parent / d).is_symlink()
+            )
+            if parent.name == "logs":
+                yield parent
+                dirs[:] = []
+
+
+def old_log_pairs(directory: Path, cutoff: datetime) -> dict[str, list[Path]]:
+    """Old job-name/id pairs, retaining the most recently modified pair per job name."""
+    jobs: dict[str, dict[str, list[tuple[Path, float]]]] = {}
+    for path in sorted(directory.iterdir()):
+        match = _JOB_LOG.fullmatch(path.name)
+        if match and not path.is_symlink() and path.is_file():
+            name, job_id, _ = match.groups()
+            jobs.setdefault(name, {}).setdefault(job_id, []).append((path, path.stat().st_mtime))
+    result = {}
+    for name, pairs in jobs.items():
+        newest = max(
+            pairs,
+            key=lambda job: (
+                max(mtime for _, mtime in pairs[job]),
+                tuple(int(n) for n in job.split("_")),
+            ),
+        )
+        for job_id, files in pairs.items():
+            if job_id != newest and max(mtime for _, mtime in files) < cutoff.timestamp():
+                result[f"{name}.{job_id}"] = [path for path, _ in files]
+    return result

{runops-2.5.0 → runops-2.6.0}/src/runops/ops/common.py

@@ -49,6 +49,8 @@ def resolve_dest(project: Project, dest: str) -> Path:
         raise UsageError(f"--dest must be inside {project.runs_dir}")
     if inside(path, project.runs_dir / ARCHIVE_DIR):
         raise UsageError("--dest must not be inside runs/_archive")
+    if "_analysis" in path.resolve().relative_to(project.runs_dir.resolve()).parts:
+        raise UsageError("--dest must not be inside _analysis (reserved for group analysis)")
     enclosing = project.enclosing_run(path)
     if enclosing is not None:
         # Discovery stops at a run directory, so a run nested in it would be lost.

{runops-2.5.0 → runops-2.6.0}/src/runops/ops/create.py

@@ -185,9 +185,7 @@ def _split_values(raw: str) -> list[str]:
 def _dest_parent(project: Project, case: Case, dest: str, scratch: bool) -> Path:
     if scratch and not dest:
         return project.runs_dir / SCRATCH_DIR
-    if not dest:
-        return project.runs_dir / case.name
-    return resolve_dest(project, dest)
+    return resolve_dest(project, dest or case.name)
 
 
 def _beside(project: Project, source: Manifest) -> Path | None:

{runops-2.5.0 → runops-2.6.0}/src/runops/ops/notes.py

@@ -10,6 +10,7 @@ from runops import __version__
 from runops.adapters.registry import optional
 from runops.errors import UsageError
 from runops.manifest import ACTIVE_STATES, Manifest, RunState
+from runops.ops.analysis import group_topics
 from runops.ops.common import run_sim_context
 from runops.ops.skills import stale_runops_skills
 from runops.project import Project
@@ -91,6 +92,7 @@ def project_context(project: Project, *, log_lines: int = 20) -> dict[str, Any]:
         "expired_scratch": expired,
         "recent_runs": [m.to_summary(project.root) for m in recent],
         "notes_files": note_files,
+        "group_analysis": group_topics(project),
         "log_tail": log_tail,
         "warnings": [w for w in [stale_runops_skills(project)] if w],
     }

{runops-2.5.0 → runops-2.6.0}/src/runops/ops/setup.py

@@ -82,6 +82,9 @@ def resolve_site(site: str) -> tuple[str, bool]:
 
 GITIGNORE = """\
 .venv/
+.runops/analysis-env/
+**/logs/
+__pycache__/
 .runops/build/
 .runops/index.toml
 .runops/*.lock