runops 1.2.0__tar.gz → 2.0.0__tar.gz

runops-2.0.0/.agents/skills/check/SKILL.md

@@ -0,0 +1,34 @@
+---
+name: check
+description: "Run runops quality gates (ruff format, ruff check, mypy, pytest with branch coverage) after code changes, and the extra checks for filesystem, adapter, or migration changes. Report pass/fail per step and fix failures."
+---
+
+# 品質チェック
+
+## 常に実行する
+
+```bash
+uv run ruff format --check src/ tests/
+uv run ruff check src/ tests/
+uv run mypy src/
+uv run pytest -q --cov=runops --cov-branch --cov-fail-under=80
+```
+
+pytest は 60 秒以内が目標（SPEC §13.1）。Slurm は `tests/conftest.py` の `FakeSlurm` で
+mock する。実際の `sbatch` を呼ぶテストを書かない。
+
+## 変更内容に応じて追加する
+
+| 変更 | 追加の確認 |
+|---|---|
+| rename / move / archive / 作成など filesystem 操作 | `uv run pytest -q -p no:cacheprovider --basetemp=/LARGE0/gr20001/b36291/claude_scratch/pytest-lustre` で Lustre 上でも通す（`RENAME_NOREPLACE` が EINVAL になる経路） |
+| adapter 解決、`.venv` の entry point、skill 展開 | `tests/test_skills.py` と `tests/test_adapters.py`。必要なら scratch project で `uv venv` + `uv pip install -e <simulator>` して `runo doctor` |
+| `migrate-v1` | `tests/test_migrate.py`。実 project には `runo migrate-v1 --dry-run` だけを実行し、適用は `work/` を除いたコピーで行う |
+| job.sh 生成 | `tests/golden/*.sh` との差分を目視し、意図した変更なら `UPDATE_GOLDEN=1 uv run pytest tests/test_jobgen.py` |
+| project に展開する skill / AGENTS.md block | `tests/test_skills.py`（行数上限）と `sync-docs` skill |
+| 開発ハーネス | `tests/test_dev_harness.py` |
+
+## 報告
+
+各ステップの pass / fail を示し、失敗はエラー出力と修正内容を添える。
+`ruff format` の違反は `uv run ruff format src/ tests/` で直してよい。

runops-2.0.0/.agents/skills/improve-harness/SKILL.md

@@ -0,0 +1,34 @@
+---
+name: improve-harness
+description: "Audit or improve the runops agent harnesses: the development harness of this repository (AGENTS.md, .agents/skills, .claude, .codex) and the project harness runops generates (src/runops/harness.py, src/runops/skills). Use when instructions drift from the code, repeat friction appears, or a new workflow needs a skill."
+---
+
+# ハーネスの改善
+
+runops には 2 つのハーネスがある。どちらを直すかを先に決める。
+
+| ハーネス | 正本 | 読む人 |
+|---|---|---|
+| 開発ハーネス | `AGENTS.md`、`.agents/skills/*/SKILL.md`、`.claude/rules/*.md`、`.codex/rules/runops.rules`、`.claude/settings.json`、`.codex/config.toml` | runops を開発するエージェント |
+| project ハーネス | `src/runops/harness.py`（AGENTS.md の管理 block）、`src/runops/skills/*/SKILL.md` | runops を使う project のエージェント |
+
+## 開発ハーネスの構造
+
+- skill の正本は `.agents/skills/<name>/SKILL.md`（Codex が読む）。`.claude/skills/<name>/SKILL.md`
+  は同じ `name` / `description` の frontmatter と、正本を読むよう指示する 1 文だけを持つ。
+- 専門 agent（`spec-reviewer`）も同様に、`.claude/agents/*.md` と `.codex/agents/*.toml` は
+  `.agents/skills/<name>/SKILL.md` を指す入口に留める。
+- 規約の正本は `.claude/rules/*.md`（Claude Code が自動で読む）。Codex 向けには `AGENTS.md` の表から
+  同じ file を参照する。`.codex/rules/` には execpolicy の `runops.rules` だけを置く。
+- `AGENTS.md` は 80 行程度の入口に保つ。`CLAUDE.md` は `@AGENTS.md` だけ。
+- `tests/test_dev_harness.py` が、入口と正本の対応、参照先の存在、AGENTS.md の長さを検査する。
+
+## 進め方
+
+1. 摩擦を具体的に特定する（どの作業で、何を誤り、何を読み直したか）。
+2. 直す場所を 1 か所に決める。恒久規約は rules、繰り返す手順は skill、project の利用者向けは
+   project ハーネス。同じ内容を 2 か所に書かない。
+3. skill を足すときは description に発火条件を書き、手順は判断に必要な分だけにする。
+   `.claude/skills/` に入口を作る。
+4. project ハーネスを変えたら `sync-docs` に従い、SPEC §8.3 / §10 と README も確認する。
+5. `uv run pytest -q tests/test_dev_harness.py tests/test_skills.py` を通す。

{runops-1.2.0/.claude → runops-2.0.0/.agents}/skills/release/SKILL.md

@@ -5,7 +5,7 @@ description: "Prepare and publish a new runops release from main. Bump version,
 
 # runops リリース
 
-`/release` は新しいバージョンの runops をリリースするスキル。
+新しいバージョンの runops をリリースするスキル（Codex では `$release`、Claude Code では `/release`）。
 
 ## リリースノート方針
 
@@ -17,16 +17,17 @@ description: "Prepare and publish a new runops release from main. Bump version,
 ## 使い方
 
 ```
-/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      # 明示的にバージョン指定
+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 レベルを自動判定し、
 main release commit → main push → CI 確認 → tag → GitHub Release → publish 確認まで一気通貫で実行する。
 
-現在は個人開発のため main-first。release commit は `main` 上で作り、
+現在は個人開発のため main-first。v2 の作業 branch（`v2`）は、最初の 2.0.0 リリース前に
+`main` へ fast-forward または merge しておく。release commit は `main` 上で作り、
 品質ゲートと CI green を確認してから、その release commit に tag を切る。
 `--force`、non-fast-forward push、`--no-verify` は使わない。
 
@@ -42,6 +43,7 @@ git status --porcelain
 uv run pytest tests/ -x -q
 
 # lint / type check
+uv run ruff format --check src/ tests/
 uv run ruff check src/ tests/
 uv run mypy src/
 ```

runops-2.0.0/.agents/skills/simulator-adapter/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: simulator-adapter
+description: "Add or update runops v2 support in a simulator's own Python package (runops.adapters entry point, agent_context_dir packaging, tests), or adjust runops.legacy_adapters. Use when a simulator such as MPIEMSES3D, BEACH, or a new code needs to work with runops."
+---
+
+# simulator 側の adapter
+
+runops 本体には simulator 固有の adapter を置かない（SPEC §8.1）。adapter は simulator の
+Python package に置き、`runops.adapters` entry point で公開する。
+
+## 手順
+
+1. simulator repo の規約（AGENTS.md、テスト、ログインノードでの実行可否）を読み、作業中の branch を
+   壊さないよう `git worktree add -b <branch> <scratch> main` で作業する。
+2. `<package>/runops_adapter.py` に `Adapter` を書く。runops は関数内で遅延 import し、
+   module の import 時に runops を要求しない。契約は `docs/adapter.md`。
+   - `render_inputs` は `runops.adapters.toml_override` で dotted key を適用する
+   - `build_command` は run_dir を cwd とした argv、`detect_status` は job 終了後の判定
+   - 既存の移植元は `src/runops/legacy_adapters/<name>.py`
+3. `pyproject.toml` に entry point を足す:
+   `[project.entry-points."runops.adapters"] <name> = "<package>.runops_adapter:Adapter"`
+4. skill と reference を wheel に入れ、`agent_context_dir()` で返す。候補は
+   `<package>/agent_context`（wheel）→ repo の `plugins/<name>-context`（source checkout）の順。
+   - package dir の外にある場合: setuptools の `package-dir` で data-only package に対応付ける
+     （BEACH: `"beach.agent_context" = "plugins/beach-context"`）
+   - 配布 workflow が package をコピーして build する場合: build 前に stage する script
+     （MPIEMSES3D: `tools/stage_agent_context.py`）
+5. テスト: `build_command`、`detect_status`、`summarize`、`agent_context_dir` は runops 無しで、
+   `render_inputs` は runops があるときだけ（skip）。wheel の中身を確認できるなら
+   `agent_context/skills/*/SKILL.md` と `entry_points.txt` の `[runops.adapters]` を見る。
+6. E2E: scratch project で `uv venv` → `uv pip install --no-deps <wheel or -e path>` →
+   `runo init <name> --no-install` → `runo doctor`（`resolved via entry-point`）→ skill 展開と
+   `runo new` の job.sh を確認する。
+7. entry point を持つ版が出たら、runops 側の `legacy_adapters/<name>.py` と
+   `ops/setup.py` の `KNOWN_PACKAGES` を見直す。

runops-2.0.0/.agents/skills/spec-reviewer/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: spec-reviewer
+description: "Review runops changes against SPEC.md: design principles, command budget, manifest/state semantics, adapter contract, filesystem safety, and missing acceptance tests. Use before merging non-trivial changes."
+---
+
+# SPEC レビュー
+
+毎回 `SPEC.md` を読み直す。正本は SPEC 本文と §14、実装、テストの順。
+
+## 観点
+
+- **原則（§1.2）**: 作成をゲートしていないか。case / run / sweep 以外の永続 entity、ID 空間、
+  ledger を足していないか。simulator 固有の知識を runops 本体に入れていないか。
+- **command（§7.3, §13.1）**: 数が 25 を超えないか。read-only と状態変更を同じ名前で兼ねていないか。
+  破壊的操作が確認（`-y` 以外）を経るか。exit code が 0 / 1 / 2 の規約通りか。
+- **manifest（§6）**: runops だけが書き、atomic write か。未知 field を落とさないか
+  （`Manifest` は dict を保持する）。状態遷移が `_TRANSITIONS` に沿うか。`run_dir` は project 相対か。
+- **filesystem**: run の公開・移動は `move_noreplace`。別 filesystem へ黙ってコピーしない。
+  `runs/` 外や pinned を消さない。Lustre（NOREPLACE 非対応）でも正しいか。
+- **adapter（§8）**: Protocol だけに依存し、任意 hook は `optional()` で呼ぶか。解決順
+  （entry point → `adapters/X.py` → generic）を変えていないか。
+- **ops / cli 境界**: `ops/` は print / prompt せず、Slurm は runner 引数で注入されるか。
+- **テスト**: SPEC §13.2 の受け入れ基準に対応するテストがあるか。失敗系（不正入力、既存 path、
+  Slurm 失敗、状態違い）も見ているか。
+
+## 報告
+
+finding ごとに severity（Critical / Important / Minor）、file:line、根拠（SPEC の節か再現手順）、
+修正案を書く。推測だけで blocker にしない。style の好みは報告しない。

runops-2.0.0/.agents/skills/sync-docs/SKILL.md

@@ -0,0 +1,34 @@
+---
+name: sync-docs
+description: "Keep runops specs, user docs, and agent-facing text consistent after a change to commands, options, config fields, manifest fields, adapter contract, or project layout. Use before committing such a change."
+---
+
+# 仕様と文書の同期
+
+runops の挙動は複数の場所に書かれている。変更の種類から直す場所を決め、正本から順に直す。
+
+| 変更 | 正本 | 追随させる場所 |
+|---|---|---|
+| command / option の追加・変更 | `SPEC.md` §7.3（先に更新。§13.1 の上限 25 を確認） | `docs/reference.md` の command 表、`src/runops/skills/runops-reference/SKILL.md`、`src/runops/harness.py` の `COMMANDS` |
+| `runops.toml` / `case.toml` の field | `SPEC.md` §4, §5 | `docs/reference.md`、`config.py` / `case.py` の既知 key 集合 |
+| manifest の field | `SPEC.md` §6.2 | `docs/reference.md` の manifest 表、`ops/migrate.py` の変換 |
+| adapter 契約・skill 同梱 | `SPEC.md` §8 | `docs/adapter.md`、`adapters/base.py` の docstring、`legacy_adapters/` |
+| エージェントの使い方・規則 | `src/runops/harness.py`（project の AGENTS.md block） | `src/runops/skills/*/SKILL.md`、README の依頼例 |
+| 実装中の判断で SPEC 本文と違う結論になった | `SPEC.md` 本文を直し、§14 に理由を 1 行追加 | — |
+
+## 規則
+
+- README は利用者向けで、人が覚えるコマンドは `runo init` だけという前提で書く。それ以外は
+  エージェントへの依頼例として書く。
+- `docs/` は `reference.md` と `adapter.md` の 2 本だけ。ページを増やす前に既存ページの節で収める。
+- project に展開する skill は各 60 行以内、AGENTS.md block は 120 行以内（テストあり）。
+- 経緯は書かない（commit message と SPEC §14 に残す）。現在の挙動だけを書く。
+
+## 確認
+
+```bash
+uv run pytest -q tests/test_skills.py tests/test_dev_harness.py
+uv run runo --help
+```
+
+`--help` の command 一覧と SPEC §7.3、`docs/reference.md` の表が一致することを確認する。

runops-2.0.0/.claude/agents/spec-reviewer.md

@@ -0,0 +1,7 @@
+---
+name: spec-reviewer
+description: "Review runops changes against SPEC.md: design principles, command budget, manifest/state semantics, adapter contract, filesystem safety, and missing acceptance tests. Use before merging non-trivial changes."
+tools: Read, Grep, Glob, Bash
+---
+
+Read `.agents/skills/spec-reviewer/SKILL.md` and review the requested change as it instructs. Do not edit files; report findings only.

runops-2.0.0/.claude/rules/architecture.md

@@ -0,0 +1,29 @@
+# アーキテクチャ（runops v2）
+
+正本は `SPEC.md`。ここには実装時に守る境界だけを書く。
+
+## 層
+
+```text
+cli.py  ──>  ops/*  ──>  config / project / manifest / case / runtime / jobgen / launchers / slurm / util
+                    └─>  adapters/ (base, registry, generic)
+```
+
+- `cli.py`: 引数の解釈、確認 prompt、表示だけ。処理は `ops/` を呼ぶ。`RunopsError` の
+  `exit_code`（1: 実行時エラー、2: 使い方・設定）を `main()` が終了コードにする。
+- `ops/`: command ごとの処理。print / prompt をしない。Slurm を呼ぶ関数は `runner` 引数を取り、
+  CLI は `slurm.default_runner` を呼び出し時に参照して渡す（テストは monkeypatch で差し替える）。
+- 基盤 module は `ops/` と `cli.py` を import しない。`adapters/` は runops の他 module に依存しない
+  （`base.py` は `util.load_toml` のみ）。
+- `legacy_adapters/` は registry に登録しない。`ops/migrate.py` と `ops/setup.py` がファイルとして
+  project にコピーするだけ。
+
+## 不変条件
+
+- run directory が主単位、`manifest.toml` が正本。書き込みは `Manifest.save()`（atomic）。
+  `Manifest` は dict を保持し、知らない field を落とさない。
+- run の発見は `runs/` 配下の走査。`.runops/index.toml` は捨ててよい cache。
+- run の公開・移動は `util.move_noreplace`。`shutil.move` で別 filesystem へコピーしない。
+- run id の採番と作成は `Project.id_lock()` の中で行い、staging は対象と同じ親 directory に置く。
+- adapter の任意 hook は `registry.optional()` 経由で呼ぶ（Protocol を満たすだけの class も動く）。
+- simulator 固有の知識（入力形式、完了判定、skill）を runops 本体に足さない。

runops-2.0.0/.claude/rules/dev-workflow.md

@@ -0,0 +1,32 @@
+# 開発ワークフロー
+
+## 品質ゲート
+
+コミット前に `check` skill の手順を通す。CI（`.github/workflows/ci.yml`）も同じ
+ruff format / ruff check / mypy / pytest（branch coverage 80%）を Python 3.10–3.13 で実行する。
+
+## コーディング
+
+- Python 3.10+。`tomllib` は `runops.util.tomllib` を使う（3.10 は `tomli`）。
+- 型ヒントを付ける（mypy は `disallow_untyped_defs`）。line length 100。
+- 新しい command / option / field は先に `SPEC.md` を更新し、`sync-docs` skill の表に沿って
+  文書と skill を揃える。command は合計 25 を超えない。
+- 新しい永続 entity、ID 空間、ledger、作成前のゲートを足さない（SPEC §1.2）。
+
+## テスト
+
+- 受け入れ基準（SPEC §13.2）ごとにテストがある。挙動を変えたら対応するテストを直す。
+- CLI は `tests/conftest.py` の `cli` fixture（`runops.cli.main` を呼び exit code と出力を返す）、
+  Slurm は `fake_slurm`、project は `project_dir`（generic simulator と `demo` case）を使う。
+- job.sh は `tests/golden/`、v1 移行は `tests/fixtures/v1-project/` を使う。
+- 実際の Slurm、ネットワーク、計算ノードを必要とするテストを書かない。
+
+## Git
+
+- 1 コミット 1 論理変更。message は英語の Conventional Commits（`feat:`, `fix:`, `docs:` ...）。
+- main-first。大きな変更だけ branch を切る。`--no-verify`、`--force`、`git reset --hard` は使わない。
+- コミットや push はユーザーの依頼があるときだけ行う。
+
+## リリース
+
+`release` skill に従う。`pyproject.toml` と `src/runops/__init__.py` の version を同時に更新する。

runops-2.0.0/.claude/rules/gotchas.md

@@ -0,0 +1,37 @@
+# Gotchas
+
+## KUDPC の Lustre は RENAME_NOREPLACE に未対応
+
+`/LARGE0`、`/LARGE1` では `renameat2(RENAME_NOREPLACE)` が EINVAL を返す。
+`util.move_noreplace` は存在確認 + `rename` に落とす。`/tmp` 上のテストだけでは
+この経路を通らないので、filesystem を触る変更は `--basetemp=/LARGE0/...` でも確認する。
+
+## importlib.metadata のキャッシュ
+
+`.venv` の dist-info 一覧は directory の mtime でキャッシュされる。Lustre の mtime は秒単位のため、
+同じ秒に入れ替えた package を見落とす。`registry._entry_point` は探索前に
+`importlib.invalidate_caches()` と `MetadataPathFinder.invalidate_caches()` を呼ぶ
+（Python 3.10 では前者だけでは metadata のキャッシュが消えない）。`.pth`（editable install）を効かせるため
+`sys.path.append` ではなく `site.addsitedir` を使う。
+
+## project ローカル adapter の module 名
+
+`adapters/X.py` は `runops_project_adapters.X` として読み込まれる。同じ process で別 project を
+開くと `sys.modules` が上書きされる（テストでは問題にならないが、長寿命 process では注意）。
+
+## typer の `standalone_mode=False`
+
+`main()` は `app(..., standalone_mode=False)` で呼ぶため、`typer.Exit` は例外ではなく戻り値の
+終了コードになる。`--version` の callback も同じ経路を通る。
+
+## ログインノードでの実行
+
+pytest は軽量なのでログインノードで実行してよい。simulator の build（`runo build`、
+`local_source`）や他 repo の重いテストは、各 repo の規約に従い計算ノード（`tssrun`）で行う。
+
+## v1 project を触るとき
+
+実運用の v1 project（例: `~/large1/project_dust_release`）には `runo migrate-v1 --dry-run` だけを
+実行する。適用は `work/`、`.venv`、`refs/`、`materials/` を除いたコピーで行う。v1 の
+`.runops/work/<build>/src` は simulator repo の git worktree のことがある（migrate が
+`git worktree repair` する）。

runops-2.0.0/.claude/skills/check/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: check
+description: "Run runops quality gates (ruff format, ruff check, mypy, pytest with branch coverage) after code changes, and the extra checks for filesystem, adapter, or migration changes. Report pass/fail per step and fix failures."
+---
+
+Read `.agents/skills/check/SKILL.md` and follow it. That file is the single source for this skill; files it references are relative to `.agents/skills/check/`.

runops-2.0.0/.claude/skills/improve-harness/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: improve-harness
+description: "Audit or improve the runops agent harnesses: the development harness of this repository (AGENTS.md, .agents/skills, .claude, .codex) and the project harness runops generates (src/runops/harness.py, src/runops/skills). Use when instructions drift from the code, repeat friction appears, or a new workflow needs a skill."
+---
+
+Read `.agents/skills/improve-harness/SKILL.md` and follow it. That file is the single source for this skill; files it references are relative to `.agents/skills/improve-harness/`.

runops-2.0.0/.claude/skills/python-package-refactor/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: python-package-refactor
+description: Safely refactor Python packages and libraries with repository inspection, public API preservation, import-boundary cleanup, packaging modernization, tests, typing, linting, and behavior-preserving code changes. Use when working on Python package architecture, module layout, pyproject/setup configuration, dependency boundaries, circular imports, API compatibility, large-module decomposition, or refactoring pull requests. Do not use for isolated Python snippets or unrelated bug fixes unless the user asks for package-level refactoring.
+---
+
+Read `.agents/skills/python-package-refactor/SKILL.md` and follow it. That file is the single source for this skill; files it references are relative to `.agents/skills/python-package-refactor/`.

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

@@ -0,0 +1,6 @@
+---
+name: release
+description: "Prepare and publish a new runops release from main. Bump version, sync __init__.py, draft Japanese release notes, push main, tag the release commit, create GitHub Release, and verify PyPI publish."
+---
+
+Read `.agents/skills/release/SKILL.md` and follow it. That file is the single source for this skill; files it references are relative to `.agents/skills/release/`.

runops-2.0.0/.claude/skills/simulator-adapter/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: simulator-adapter
+description: "Add or update runops v2 support in a simulator's own Python package (runops.adapters entry point, agent_context_dir packaging, tests), or adjust runops.legacy_adapters. Use when a simulator such as MPIEMSES3D, BEACH, or a new code needs to work with runops."
+---
+
+Read `.agents/skills/simulator-adapter/SKILL.md` and follow it. That file is the single source for this skill; files it references are relative to `.agents/skills/simulator-adapter/`.

runops-2.0.0/.claude/skills/spec-reviewer/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: spec-reviewer
+description: "Review runops changes against SPEC.md: design principles, command budget, manifest/state semantics, adapter contract, filesystem safety, and missing acceptance tests. Use before merging non-trivial changes."
+---
+
+Read `.agents/skills/spec-reviewer/SKILL.md` and follow it. That file is the single source for this skill; files it references are relative to `.agents/skills/spec-reviewer/`.

runops-2.0.0/.claude/skills/sync-docs/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: sync-docs
+description: "Keep runops specs, user docs, and agent-facing text consistent after a change to commands, options, config fields, manifest fields, adapter contract, or project layout. Use before committing such a change."
+---
+
+Read `.agents/skills/sync-docs/SKILL.md` and follow it. That file is the single source for this skill; files it references are relative to `.agents/skills/sync-docs/`.

runops-2.0.0/.codex/README.md

@@ -0,0 +1,25 @@
+# Codex CLI harness — runops
+
+runops 開発リポジトリ用の Codex 設定。Claude Code と同じ正本を共有する。
+
+| 目的 | 正本 | Codex の入口 | Claude Code の入口 |
+|---|---|---|---|
+| project doc | `AGENTS.md` | `AGENTS.md` | `CLAUDE.md`（`@AGENTS.md`） |
+| 規約 | `.claude/rules/*.md` | `AGENTS.md` の表から参照 | 自動で読まれる |
+| 定型作業 | `.agents/skills/<name>/SKILL.md` | `$name` / 自動発火 | `.claude/skills/<name>/SKILL.md`（正本を指す入口） |
+| 専門 agent | `.agents/skills/spec-reviewer/SKILL.md` | `.codex/agents/spec-reviewer.toml` | `.claude/agents/spec-reviewer.md` |
+| 実行 policy | — | `.codex/config.toml`、`.codex/rules/runops.rules` | `.claude/settings.json` |
+
+`tests/test_dev_harness.py` が入口と正本の対応を検査する。skill を足すときは
+`.agents/skills/` に書き、`.claude/skills/` には同じ frontmatter の入口だけを置く。
+
+`.codex/config.toml` は project を trusted に登録したときだけ読まれる:
+
+```toml
+[projects."<このリポジトリの絶対パス>"]
+trust_level = "trusted"
+```
+
+この repository では unattended な保守作業を優先し、`sandbox_mode = "danger-full-access"`、
+`approval_policy = "never"` を共有設定にしている。高コスト・不可逆な command は
+`.codex/rules/runops.rules` で prompt / forbidden にする。

runops-2.0.0/.codex/agents/spec-reviewer.toml

@@ -0,0 +1,6 @@
+name = "spec-reviewer"
+description = "Review runops changes against SPEC.md: design principles, command budget, manifest/state semantics, adapter contract, filesystem safety, and missing acceptance tests. Use before merging non-trivial changes."
+developer_instructions = """
+Read `.agents/skills/spec-reviewer/SKILL.md` and review the requested change as it instructs.
+Do not edit files; report findings only.
+"""

runops-2.0.0/.codex/rules/runops.rules

@@ -0,0 +1,67 @@
+# Codex execpolicy rules for the runops development repository.
+#
+# Only high-cost or irreversible command prefixes live here. Workflow guidance is
+# in AGENTS.md, .claude/rules/*.md and .agents/skills/.
+
+prefix_rule(
+    pattern = ["runo", "submit"],
+    decision = "prompt",
+    justification = "Submitting spends HPC allocation; confirm targets and resources first.",
+    match = ["runo submit R20261015-0001", "runo submit --all runs/case"],
+)
+
+prefix_rule(
+    pattern = ["uv", "run", "runo", "submit"],
+    decision = "prompt",
+    justification = "Submitting spends HPC allocation; confirm targets and resources first.",
+    match = ["uv run runo submit R20261015-0001"],
+)
+
+prefix_rule(
+    pattern = ["runo", "delete"],
+    decision = "prompt",
+    justification = "Deleting a run removes its directory.",
+    match = ["runo delete R20261015-0001"],
+)
+
+prefix_rule(
+    pattern = ["runo", "tidy", "--apply"],
+    decision = "prompt",
+    justification = "tidy --apply deletes or archives runs.",
+    match = ["runo tidy --apply", "runo tidy --apply --only expired-scratch"],
+)
+
+prefix_rule(
+    pattern = ["runo", "migrate-v1"],
+    decision = "prompt",
+    justification = "Migration rewrites a project; run --dry-run and review first.",
+    match = ["runo migrate-v1 -y"],
+)
+
+prefix_rule(
+    pattern = ["rm", "-rf"],
+    decision = "forbidden",
+    justification = "Avoid broad recursive deletion; use runo delete / tidy.",
+    match = ["rm -rf runs/case"],
+)
+
+prefix_rule(
+    pattern = ["git", "push", "origin", "main"],
+    decision = "allow",
+    justification = "runops is main-first; push only after local quality gates and when the user asked.",
+    match = ["git push origin main"],
+)
+
+prefix_rule(
+    pattern = ["git", "push", "--force"],
+    decision = "forbidden",
+    justification = "Force-pushing rewrites shared history.",
+    match = ["git push --force", "git push --force origin main"],
+)
+
+prefix_rule(
+    pattern = ["git", "reset", "--hard"],
+    decision = "forbidden",
+    justification = "Hard reset discards local work.",
+    match = ["git reset --hard", "git reset --hard HEAD~1"],
+)