runops 0.2.1__tar.gz → 0.3.0__tar.gz

{runops-0.2.1 → runops-0.3.0}/.claude/rules/commands.md

@@ -23,7 +23,7 @@
 | `runops case new CASE [--minimal] [--survey]` | case のスキャフォールド生成 |
 | `runops runs create CASE` | case から単一 run を生成 |
 | `runops runs sweep [DIR] [--dry-run]` | survey.toml からパラメータ直積で全 run 生成 |
-| `runops runs submit [RUN]` | run を sbatch で投入 (`-qn`, `--afterok` 対応) |
+| `runops runs submit [RUN]` | run を sbatch で投入 (`-qn`, `--qos`, `--afterok` 対応) |
 | `runops runs submit --all [DIR]` | created な run を一括投入 |
 | `runops runs clone` | run 複製・派生 |
 | `runops runs extend` | スナップショットから継続 run 生成 |
@@ -33,7 +33,7 @@
 | コマンド | 説明 |
 |---------|------|
 | `runops runs status [RUNS...]` | run 状態確認 (複数指定可) |
-| `runops runs sync [RUNS...]` | Slurm 状態を manifest に反映 |
+| `runops runs sync [RUNS...]` | Slurm 状態を manifest に反映 (複数 run 時はサマリ表示) |
 | `runops runs log [RUN]` | 最新 job の stdout/stderr 表示 + 進捗% |
 | `runops runs jobs [PATH] [--watch SECS]` | 実行中ジョブ一覧 |
 | `runops runs dashboard [TARGETS...] [--watch SECS]` | 複数 run の進捗表 |

{runops-0.2.1 → runops-0.3.0}/.claude/rules/dev-workflow.md

@@ -37,3 +37,12 @@ CI でも同じチェックが走る。ruff format 違反は自動修正可 (`uv
 - commit message は英語推奨 (`fix:`, `feat:`, `refactor:`, `test:`, `docs:`)
 - `--no-verify` / `--force` は使わない
 - PR は main ブランチへ
+
+## リリース
+
+`/release` スキルで実施する。手順の概要:
+
+1. 品質ゲート通過を確認
+2. `pyproject.toml` と `src/runops/__init__.py` のバージョンを **同時に** 更新
+3. `git commit -m "chore: bump version to X.Y.Z"` + `git tag vX.Y.Z`
+4. `git push origin main --tags` で CI が PyPI にパブリッシュ

{runops-0.2.1 → runops-0.3.0}/.claude/rules/gotchas.md

@@ -35,6 +35,17 @@ local が team を **マージ上書き** する。同じキーを両方に書
 Adapter が返すリストは **累積** (重複排除) される。
 同じ package を複数 adapter が返しても 1 回だけ install される。
 
+## バージョン二重管理
+
+`pyproject.toml` の `version` と `src/runops/__init__.py` の `__version__` は
+**必ず同時に更新する**。片方だけ変えるとランタイム (`runops --version`) と
+PyPI パッケージのバージョンがずれる。`/release` スキルを使えば自動で両方更新される。
+
+## read_text() の encoding
+
+`Path.read_text()` は `encoding` 引数を省略するとシステムロケール依存になる。
+日本語を含むファイルを読むときは必ず `encoding="utf-8"` を明示する。
+
 ## ハーネス lock
 
 `harness.lock` は **テンプレートの hash** を記録する。

{runops-0.2.1 → runops-0.3.0}/.claude/settings.json

@@ -13,7 +13,14 @@
       "Bash(git branch*)",
       "Bash(git checkout*)",
       "Bash(git stash*)",
+      "Bash(git add *)",
+      "Bash(git tag *)",
+      "Bash(gh issue *)",
+      "Bash(gh pr *)",
+      "Bash(gh run *)",
+      "Bash(mkdir *)",
       "Bash(python -c *)",
+      "Bash(uv run python *)",
       "Bash(wc -l *)",
       "Bash(ls *)",
       "Edit(src/**)",

runops-0.3.0/.claude/skills/release/SKILL.md

@@ -0,0 +1,104 @@
+---
+name: release
+description: "Prepare and publish a new runops release. Bump version, sync __init__.py, generate changelog, create commit and tag, and push to trigger PyPI publish."
+---
+
+# runops リリース
+
+`/release` は新しいバージョンの runops をリリースするスキル。
+
+## 使い方
+
+```
+/release patch      # 0.2.1 -> 0.2.2
+/release minor      # 0.2.1 -> 0.3.0
+/release major      # 0.2.1 -> 1.0.0
+/release 0.3.0      # 明示的にバージョン指定
+```
+
+引数なしで呼んだ場合は、変更内容から bump レベルを自動判定し、
+確認 → リリースまで一気通貫で実行する。
+
+## 手順
+
+### 1. リリース可否を確認する
+
+```bash
+# 未コミットの変更がないか
+git status --porcelain
+
+# テストが全て通るか
+uv run pytest tests/ -x -q
+
+# lint / type check
+uv run ruff check src/ tests/
+uv run mypy src/
+```
+
+品質ゲートが通らなければリリースを中止する。
+
+### 2. 変更内容を把握する
+
+```bash
+# 前回リリースタグからの変更
+git log $(git describe --tags --abbrev=0 2>/dev/null || echo HEAD~20)..HEAD --oneline
+```
+
+commit message から以下を分類する:
+
+- **Breaking changes** (`feat!:`, `BREAKING CHANGE`) → major bump 候補
+- **New features** (`feat:`) → minor bump 候補
+- **Bug fixes** (`fix:`) → patch bump 候補
+- **Other** (`refactor:`, `test:`, `docs:`, `chore:`)
+
+### 3. バージョンを決定する
+
+引数で指定されていればそれを使う。なければ以下のルールで自動判定する:
+
+- `feat!:` or `BREAKING CHANGE` あり → **major**
+- `feat:` あり → **minor**
+- `fix:` のみ → **patch**
+- `docs:` / `chore:` のみ → **patch**
+
+### 4. バージョンを更新する
+
+2 箇所を同時に更新する (**ずれ防止**):
+
+1. `pyproject.toml` の `version = "X.Y.Z"` — pip / PyPI が参照する正本
+2. `src/runops/__init__.py` の `__version__ = "X.Y.Z"` — ランタイム参照
+
+### 5. コミットとタグ
+
+```bash
+git add pyproject.toml src/runops/__init__.py
+git commit -m "chore: bump version to X.Y.Z"
+git tag vX.Y.Z
+```
+
+### 6. push してリリース
+
+ユーザーの確認を得てから push する:
+
+```bash
+git push origin main
+git push origin vX.Y.Z
+```
+
+`v*` タグの push により `.github/workflows/publish.yml` が起動し、
+CI が自動で PyPI にパブリッシュする。
+
+### 7. 確認
+
+```bash
+gh run list --workflow=publish.yml --limit 1
+```
+
+## 引数なしの場合
+
+変更内容を分類し、bump レベルを自動判定して、リリースまで実行する。
+具体的には:
+
+1. 前回タグからのコミットを分類 (breaking / feat / fix / other)
+2. bump レベルを自動判定
+3. 変更サマリとバージョンをユーザーに提示して確認
+4. 確認が取れたら手順 4〜7 を順に実行 (バージョン更新 → コミット → タグ → push)

runops-0.3.0/.claude/skills/triage/SKILL.md

@@ -0,0 +1,106 @@
+---
+name: triage
+description: "Triage open GitHub issues: review new issues, assess priority, filter spam/malicious content, suggest which to tackle, and close resolved or invalid issues."
+---
+
+# Issue トリアージ
+
+`/triage` は runops リポジトリの GitHub issue を一括レビューし、
+対応方針を提案するスキル。
+
+## 手順
+
+### 1. Open issue を一覧取得
+
+```bash
+gh issue list --state open --limit 30
+```
+
+### 2. 各 issue を評価
+
+issue ごとに以下の観点で評価する:
+
+| 観点 | 判定 |
+|------|------|
+| **正当性** | 悪意・スパム・無関係な内容でないか |
+| **再現性** | バグなら再現手順があるか、実際にコードベースで確認できるか |
+| **影響度** | 影響を受けるユーザー・ワークフローの範囲 |
+| **難易度** | 修正の複雑さ (軽微 / 中 / 大) |
+| **重複** | 既存の issue や実装済み機能と重複していないか |
+
+### 3. 悪意ある issue のフィルタリング
+
+以下に該当する issue は close を提案する:
+
+- スパム (無関係な宣伝、bot 投稿)
+- 悪意のあるコード・リンクを含む
+- プロジェクトと無関係な内容
+- 個人攻撃・ハラスメント
+
+```bash
+gh issue close <NUMBER> --comment "Closed: <理由>"
+```
+
+### 4. 優先度付けと対応方針の提案
+
+ユーザーに以下の形式で報告する:
+
+```
+## トリアージ結果
+
+### 対応推奨 (高)
+- #N: <タイトル> — <理由・工数見積>
+
+### 対応推奨 (中)
+- #N: <タイトル> — <理由・工数見積>
+
+### 保留 / 要議論
+- #N: <タイトル> — <保留理由>
+
+### Close 推奨
+- #N: <タイトル> — <close 理由>
+```
+
+### 5. ユーザー判断を仰ぐ
+
+トリアージ結果を提示した後、ユーザーに以下を確認する:
+
+- どの issue に取り掛かるか
+- close してよい issue はどれか
+- 追加情報が必要な issue はあるか
+
+## 対応完了時の処理
+
+issue に対応した後は以下の手順で close する:
+
+### コミットでの紐づけ
+
+commit message に `Closes #N` を含めると、push 時に自動 close される:
+
+```
+feat: add --qos option to runs submit
+
+Closes #15
+```
+
+### 手動 close
+
+push 前に close する場合や、コミットに紐づけない場合:
+
+```bash
+gh issue close <NUMBER> --comment "Fixed in <commit-hash> — <概要>"
+```
+
+### 対応しないと決めた issue
+
+理由を明記して close する:
+
+```bash
+gh issue close <NUMBER> --comment "Won't fix: <理由>"
+```
+
+## 注意事項
+
+- ユーザーの確認なしに issue を close しない (スパム除く)
+- close 時は必ずコメントで理由を残す
+- 対応済み issue は対応コミットのハッシュを記載する

runops-0.3.0/.claude/skills/update-docs/SKILL.md

@@ -0,0 +1,73 @@
+---
+name: update-docs
+description: "Reflect code changes into documentation. Scan recent commits or staged changes, identify which docs need updating, and apply the updates. Use after implementing features, fixing bugs, or adding skills/commands."
+---
+
+# ドキュメント反映
+
+`/update-docs` はコード変更に伴うドキュメント更新を行うスキル。
+機能追加・修正・スキル追加の後に呼ぶことで、ドキュメントの整合性を保つ。
+
+## 対象ドキュメント
+
+### このリポジトリ (runops 開発者向け)
+
+| ファイル | 内容 | 更新タイミング |
+|---------|------|---------------|
+| `CLAUDE.md` | プロジェクト概要・主要コマンド表 | コマンド追加・変更時 |
+| `.claude/rules/commands.md` | 全コマンド一覧 | CLI 引数追加・変更時 |
+| `.claude/rules/dev-workflow.md` | 開発ワークフロー | ビルド手順・品質ゲート変更時 |
+| `.claude/rules/architecture.md` | アーキテクチャ原則 | レイヤ構造変更時 |
+| `docs/toml-reference.md` | TOML 設定リファレンス | case.toml / survey.toml 等のフィールド追加時 |
+| `docs/extending.md` | 拡張ガイド | Adapter / Launcher の追加方法変更時 |
+| `docs/project-flow.md` | プロジェクトフロー | ワークフロー変更時 |
+| `src/runops/sites/*.md` | サイト固有ドキュメント | サイト機能追加・制限事項更新時 |
+
+### プロジェクト側ハーネス (runops ユーザー向け)
+
+| テンプレート | 内容 | 更新タイミング |
+|------------|------|---------------|
+| `src/runops/templates/agent.md` | プロジェクト側 CLAUDE.md | コマンド体系変更時 |
+| `src/runops/templates/scaffold/rules/runops-workflow.md` | ワークフロー rule | コマンド追加時 |
+| `src/runops/templates/scaffold/rules/cookbook.md` | cookbook | 頻出パターン追加時 |
+
+## 手順
+
+### 1. 変更内容を把握する
+
+```bash
+# 直近のコミットから (デフォルト)
+git log --oneline HEAD~5..HEAD
+
+# または未コミットの変更
+git diff --stat
+```
+
+### 2. 影響するドキュメントを特定する
+
+変更の種類と対応するドキュメント:
+
+| 変更の種類 | 更新対象 |
+|-----------|---------|
+| CLI オプション追加・変更 | `commands.md`, `CLAUDE.md`, `toml-reference.md` |
+| TOML フィールド追加 | `toml-reference.md` |
+| 新スキル追加 | プロジェクト側テンプレートの CLAUDE.md (スキル一覧があれば) |
+| サイト固有の変更 | `src/runops/sites/<site>.md` |
+| Adapter / Launcher 追加 | `docs/extending.md`, `CLAUDE.md` |
+| アーキテクチャ変更 | `architecture.md` |
+
+### 3. ドキュメントを更新する
+
+各対象ファイルを読み、変更を反映する。
+
+### 4. 整合性チェック
+
+- コマンドの `--help` 出力とドキュメントが一致しているか
+- TOML フィールドの型・デフォルト値が正しいか
+- スキルの description がファイル内容と一致しているか
+
+## 注意事項
+
+- ドキュメントの書き方や文体は既存部分に合わせる
+- 日本語ドキュメントと英語ドキュメントの両方を更新する
+- ハーネス二重構造に注意: 開発者向け (`.claude/`) とプロジェクト側 (`src/runops/templates/`) は別物

{runops-0.2.1 → runops-0.3.0}/CLAUDE.md

@@ -93,7 +93,7 @@ completed → archived → purged
 |---------|------|
 | `runops init` / `setup` / `doctor` | プロジェクト管理 |
 | `runops case new` / `runs create` / `runs sweep` | case / run 生成 |
-| `runops runs submit [--all]` | ジョブ投入 |
+| `runops runs submit [--all] [-qn] [--qos]` | ジョブ投入 |
 | `runops runs status` / `sync` / `log` / `dashboard` | モニタリング |
 | `runops analyze summarize` / `collect` | 解析 |
 | `runops notes append` / `knowledge save` | 知見管理 |
@@ -109,7 +109,7 @@ completed → archived → purged
 - docstring は Google style
 - テスト: Slurm はモック、TOML は fixtures、CLI は CliRunner
 - Git: 1 コミット = 1 論理変更、`--no-verify` / `--force` 禁止
-- release 時は `pyproject.toml` version を先に更新
+- release 時は `pyproject.toml` + `__init__.py` の version を同時に更新
 
 ## Adapter 実装時の注意
 

{runops-0.2.1 → runops-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: runops
-Version: 0.2.1
+Version: 0.3.0
 Summary: HPC simulation run management CLI tool for Slurm-based environments
 License-Expression: Apache-2.0
 License-File: LICENSE

{runops-0.2.1 → runops-0.3.0}/docs/agent-user-guide.md

@@ -24,7 +24,7 @@ runops プロジェクトにおける Agent の作業ガイド。
 | sweep 内容を確認だけ | `runops runs sweep <survey> --dry-run` |
 | job 投入 | `runops runs submit` |
 | 全 run 一括投入 | `runops runs submit --all` |
-| キュー上書き / 依存ジョブ | `runops runs submit -qn <queue>` / `--afterok <job_id>` |
+| キュー上書き / QOS / 依存ジョブ | `runops runs submit -qn <queue>` / `--qos <qos>` / `--afterok <job_id>` |
 | 状態確認 (単一/複数/survey 一括) | `runops runs status [RUNS...]` |
 | Slurm 同期 (単一/複数/survey 一括) | `runops runs sync [RUNS...]` (bulk: created + terminal state は silent skip) |
 | ログ確認 | `runops runs log` |

{runops-0.2.1 → runops-0.3.0}/docs/toml-reference.md

@@ -301,6 +301,7 @@ Slurm job parameters. These become `#SBATCH` directives in `job.sh`.
 | Field | Type | Required | Description |
 |-------|------|----------|-------------|
 | `partition` | string | No | Partition/queue name. Can be overridden at submit time with `runops runs submit -qn <name>` |
+| `qos` | string | No | Slurm QOS name. Emits `#SBATCH --qos=<value>`. Can be overridden with `runops runs submit --qos <name>`. Note: camphor では使用不可 (partition 経由で暗黙決定) |
 | `nodes` | integer | No | Number of nodes |
 | `ntasks` | integer | No | Number of MPI tasks |
 | `walltime` | string | Yes | Wall time limit (HH:MM:SS) |
@@ -312,6 +313,7 @@ Slurm job parameters. These become `#SBATCH` directives in `job.sh`.
 | Field | Type | Required | Description |
 |-------|------|----------|-------------|
 | `partition` | string | No | Partition/queue name |
+| `qos` | string | No | Slurm QOS name (camphor では使用不可) |
 | `processes` | integer | No | MPI プロセス数 (`--rsc p=N`) |
 | `threads` | integer | No | プロセスあたりスレッド数 (`--rsc t=T`) |
 | `cores` | integer | No | プロセスあたりコア数 (`--rsc c=C`, ≥ threads) |

{runops-0.2.1 → runops-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "runops"
-version = "0.2.1"
+version = "0.3.0"
 description = "HPC simulation run management CLI tool for Slurm-based environments"
 readme = "README.md"
 license = "Apache-2.0"

{runops-0.2.1 → runops-0.3.0}/src/runops/__init__.py

@@ -2,4 +2,4 @@
 
 from __future__ import annotations
 
-__version__ = "0.1.9"
+__version__ = "0.3.0"

{runops-0.2.1 → runops-0.3.0}/src/runops/adapters/contrib/beach.py

@@ -702,7 +702,7 @@ class BeachAdapter(SimulatorAdapter):
             summary_file = output_dir / "summary.txt"
             if summary_file.is_file():
                 try:
-                    for line in summary_file.read_text().split("\n"):
+                    for line in summary_file.read_text(encoding="utf-8").split("\n"):
                         line = line.strip()
                         if "=" not in line:
                             continue

{runops-0.2.1 → runops-0.3.0}/src/runops/adapters/contrib/emses.py

@@ -765,7 +765,9 @@ class EmseAdapter(SimulatorAdapter):
                 nstep = self._get_expected_nstep(run_dir)
                 lines = [
                     line
-                    for line in energy_file.read_text().strip().split("\n")
+                    for line in energy_file.read_text(encoding="utf-8")
+                    .strip()
+                    .split("\n")
                     if line.strip()
                 ]
                 if lines and nstep:
@@ -814,7 +816,9 @@ class EmseAdapter(SimulatorAdapter):
             try:
                 lines = [
                     line
-                    for line in energy_file.read_text().strip().split("\n")
+                    for line in energy_file.read_text(encoding="utf-8")
+                    .strip()
+                    .split("\n")
                     if line.strip()
                 ]
                 if lines:

{runops-0.2.1 → runops-0.3.0}/src/runops/adapters/generic.py

@@ -273,7 +273,7 @@ class GenericAdapter(SimulatorAdapter):
 
         if exit_code_path.exists():
             try:
-                code = int(exit_code_path.read_text().strip())
+                code = int(exit_code_path.read_text(encoding="utf-8").strip())
             except (ValueError, OSError):
                 return "unknown"
             return "completed" if code == 0 else "failed"
@@ -316,7 +316,9 @@ class GenericAdapter(SimulatorAdapter):
         exit_code_path = run_dir / WORK_DIR / EXIT_CODE_FILE
         if exit_code_path.exists():
             try:
-                summary["exit_code"] = int(exit_code_path.read_text().strip())
+                summary["exit_code"] = int(
+                    exit_code_path.read_text(encoding="utf-8").strip()
+                )
             except (ValueError, OSError) as exc:
                 errors.append(f"exit_code: {exc}")
 

{runops-0.2.1 → runops-0.3.0}/src/runops/cli/knowledge.py

@@ -265,7 +265,7 @@ def show(
         typer.echo(f"Insight not found: {name}", err=True)
         raise typer.Exit(code=1)
 
-    typer.echo(path.read_text())
+    typer.echo(path.read_text(encoding="utf-8"))
 
 
 def sync(
@@ -852,7 +852,7 @@ def render() -> None:
     rel = imports_path.relative_to(root)
     typer.echo(f"Rendered: {rel}")
 
-    content = imports_path.read_text().strip()
+    content = imports_path.read_text(encoding="utf-8").strip()
     if content:
         for line in content.split("\n"):
             if line.startswith("@"):

{runops-0.2.1 → runops-0.3.0}/src/runops/cli/status.py

@@ -129,7 +129,13 @@ def sync(
         RunState.PURGED.value,
     }
 
+    from collections import Counter
+
     failures = 0
+    state_counts: Counter[str] = Counter()
+    changed = 0
+    total = 0
+
     for run_dir in targets:
         try:
             manifest = read_manifest(run_dir)
@@ -138,11 +144,15 @@ def sync(
             failures += 1
             continue
 
+        total += 1
+
         # In multi-target / bulk mode, runs without a job_id are skipped
         # silently — they typically belong to ``created`` runs that haven't
         # been submitted yet.
         if not manifest.job.get("job_id", ""):
             if multi:
+                state = str(manifest.run.get("status", "created"))
+                state_counts[state] += 1
                 continue
             run_id_str = manifest.run.get("id", run_dir.name)
             typer.echo(
@@ -158,6 +168,7 @@ def sync(
         # in bulk mode so the rest of the survey still gets processed.
         current_state = str(manifest.run.get("status", ""))
         if current_state in terminal_states:
+            state_counts[current_state] += 1
             if multi:
                 continue
             run_id_str = manifest.run.get("id", run_dir.name)
@@ -174,14 +185,38 @@ def sync(
             failures += 1
             continue
 
+        after = str(result.state_after or current_state)
+        state_counts[after] += 1
+
         if result.state_before == result.state_after:
             typer.echo(f"{run_id}: state unchanged ({result.state_after})")
         else:
+            changed += 1
             msg = f"{run_id}: {result.state_before} -> {result.state_after}"
             failure_reason = str(result.data.get("failure_reason", ""))
             if failure_reason:
                 msg += f" (reason: {failure_reason})"
             typer.echo(msg)
 
+    # Print summary when multiple targets are involved
+    if multi and total > 0:
+        parts = []
+        for state in (
+            "completed",
+            "running",
+            "submitted",
+            "created",
+            "failed",
+            "cancelled",
+            "archived",
+            "purged",
+        ):
+            count = state_counts.get(state, 0)
+            if count:
+                parts.append(f"{count} {state}")
+        summary_line = ", ".join(parts)
+        typer.echo(f"\nSummary: {summary_line}  ({total} total)")
+        typer.echo(f"         {changed} state(s) changed in this sync")
+
     if failures:
         raise typer.Exit(code=1)