runops 1.2.0__tar.gz → 1.3.0__tar.gz

{runops-1.2.0/.codex → runops-1.3.0/.claude}/rules/commands.md

@@ -53,7 +53,7 @@
 | `runo runs jobs [PATH] [--watch SECS]` | 実行中ジョブ一覧 |
 | `runo runs dashboard [TARGETS...] [--watch SECS] [--all]` | 複数 run の進捗表。`--all` では cached analysis / next action も表示 |
 | `runo runs history [PATH]` | 投入履歴表示 |
-| `runo runs list [PATHS...] [--include-archived]` | run 一覧と cached analysis / next action を表示。既定では archived / purged を除外 |
+| `runo runs list [PATHS...] [--include-archived]` | run 一覧と cached analysis / next action を表示。既定では archived / purged と archived bundle 配下を除外 |
 
 ## 解析・知見
 
@@ -100,8 +100,8 @@
 
 | コマンド | 説明 |
 |---------|------|
-| `runo runs archive [RUNS...] [--keep-in-place] [--move-to DIR]` | run アーカイブ (completed のみ。既定で `runs/_archive/` へ移動) |
-| `runo runs restore RUN` | archived run を archive 前の場所へ artifact ごと復元 |
+| `runo runs archive [RUNS...] [--keep-in-place] [--move-to DIR] [--bundle] [--adopt-archived]` | 通常は completed run を archive。`--bundle` は親ディレクトリ全体を移動し、配下 run state を保持。`--adopt-archived` は同じ親から個別 archive 済みの run を検証して bundle へ採用 |
+| `runo runs restore RUN [--bundle]` | 通常は archived run を復元。`--bundle` は親ディレクトリ全体を archive 前の場所へ復元 |
 | `runo runs purge-work [RUN] [--discard-incomplete --reason WHY]` | work/ 内の不要ファイル削除。既知の non-ready output を破棄する場合は理由必須 |
 | `runo runs cancel [RUN]` | scancel + sync (submitted/running を停止) |
 | `runo runs delete [RUN]` | run ディレクトリ削除 (created/cancelled/failed のみ) |

{runops-1.2.0/.claude → runops-1.3.0/.codex}/rules/commands.md

@@ -53,7 +53,7 @@
 | `runo runs jobs [PATH] [--watch SECS]` | 実行中ジョブ一覧 |
 | `runo runs dashboard [TARGETS...] [--watch SECS] [--all]` | 複数 run の進捗表。`--all` では cached analysis / next action も表示 |
 | `runo runs history [PATH]` | 投入履歴表示 |
-| `runo runs list [PATHS...] [--include-archived]` | run 一覧と cached analysis / next action を表示。既定では archived / purged を除外 |
+| `runo runs list [PATHS...] [--include-archived]` | run 一覧と cached analysis / next action を表示。既定では archived / purged と archived bundle 配下を除外 |
 
 ## 解析・知見
 
@@ -100,8 +100,8 @@
 
 | コマンド | 説明 |
 |---------|------|
-| `runo runs archive [RUNS...] [--keep-in-place] [--move-to DIR]` | run アーカイブ (completed のみ。既定で `runs/_archive/` へ移動) |
-| `runo runs restore RUN` | archived run を archive 前の場所へ artifact ごと復元 |
+| `runo runs archive [RUNS...] [--keep-in-place] [--move-to DIR] [--bundle] [--adopt-archived]` | 通常は completed run を archive。`--bundle` は親ディレクトリ全体を移動し、配下 run state を保持。`--adopt-archived` は同じ親から個別 archive 済みの run を検証して bundle へ採用 |
+| `runo runs restore RUN [--bundle]` | 通常は archived run を復元。`--bundle` は親ディレクトリ全体を archive 前の場所へ復元 |
 | `runo runs purge-work [RUN] [--discard-incomplete --reason WHY]` | work/ 内の不要ファイル削除。既知の non-ready output を破棄する場合は理由必須 |
 | `runo runs cancel [RUN]` | scancel + sync (submitted/running を停止) |
 | `runo runs delete [RUN]` | run ディレクトリ削除 (created/cancelled/failed のみ) |

{runops-1.2.0 → runops-1.3.0}/PKG-INFO

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

{runops-1.2.0 → runops-1.3.0}/SPEC.md

@@ -489,9 +489,15 @@ runs/**/work/*.err
 runs/**/work/*.log
 
 # analysis cache
-runs/**/analysis/cache/
-runs/**/analysis/.ipynb_checkpoints/
-```
+runs/**/analysis/cache/
+runs/**/analysis/.ipynb_checkpoints/
+```
+
+`runs/_archive/` 自体は ignore しない。bundle archive 後も
+`survey.toml`、`manifest.toml`、source input、curated analysis、
+`.runops-archive.toml` は Git 管理可能とする。一方、上記の `runs/**` pattern は
+archive 配下にも同様に適用し、`work/`、`status/`、cache / scratch、生成済み input は
+Git 管理対象へ戻さない。
 
 ---
 
@@ -841,6 +847,14 @@ scientific evidence の受理条件にしない。
 
 active view から退避済み。既定では run directory 全体を `runs/_archive/` へ移し、
 入力・出力・restart・解析 artifact は保持する
+
+親ディレクトリを `--bundle` で退避する操作は run lifecycle と直交する。
+bundle 配下の `completed` / `cancelled` / `failed` / `created` 等の状態は変更せず、
+`.runops-archive.toml` を親ディレクトリの archive marker とする。
+archive destination が既に存在する場合は既定で拒否する。`--adopt-archived` を明示した
+場合に限り、同じ親から同じ相対パスへ個別 archive 済みで、状態が `archived` または
+`purged` の run のみを bundle へ採用できる。destination 内に対象 run 外の path がある、
+元 path と相対位置が一致しない、または source 側と衝突する場合は全体を変更せず拒否する。
 
 ### `purged`
 
@@ -1133,8 +1147,8 @@ single-target モードでは "nothing to sync" notice を出してエラー扱
 
 ## 18.5 一覧
 
-* `runo runs list [PATHS...]` — 既定では archived / purged を除く active view
-* `runo runs list [PATHS...] --include-archived` — archived / purged を含める
+* `runo runs list [PATHS...]` — 既定では archived / purged と archived bundle 配下を除く active view
+* `runo runs list [PATHS...] --include-archived` — archived / purged と archived bundle 配下を含める
 * `runo runs list --status failed`
 * `runo runs list --status archived` — 明示した archived run だけを表示する
 * `runo runs list --tag production`
@@ -1163,7 +1177,10 @@ single-target モードでは "nothing to sync" notice を出してエラー扱
 * `runo runs archive <run_dir or run_id>` — completed → archived。既定では `runs/_archive/<元の runs/ 相対パス>` へ移動する
 * `runo runs archive <run_dir or run_id> --keep-in-place` — completed → archived の状態変更のみ行う
 * `runo runs archive <run_dir or run_id> --move-to <archive_root>` — custom archive root へ移動する
+* `runo runs archive <parent_dir> --bundle` — `survey.toml` と配下 run を親ごと `runs/_archive/<元の runs/ 相対パス>` へ移動する。run state は保持し、submitted / running を含む場合は全体を変更せず拒否する
+* `runo runs archive <parent_dir> --bundle --adopt-archived` — 同じ親から個別 archive 済みの archived / purged run を検証して bundle へ採用する。確認前に対象 run ID と状態を表示し、競合や所有不明 path があれば変更せず拒否する
 * `runo runs restore <run_dir or run_id>` — archived → completed。`archived_from` へフォルダごと戻し、全 artifact を保持する。in-place archive は状態だけ戻す
+* `runo runs restore <archived_parent_dir> --bundle` — `.runops-archive.toml` の `archived_from` へ親ごと戻し、各 run state を保持する
 * `runo runs purge-work [<run_dir or run_id>]` — archived → purged。cached readiness が
   incomplete / unknown の場合は `--discard-incomplete --reason <WHY>` を同じ command に指定して
   review provenance を残す

{runops-1.2.0 → runops-1.3.0}/docs/architecture.md

@@ -413,6 +413,13 @@ class RunState(str, Enum):
 directory と全 artifact を復元する。`purged` は削除済み artifact を復元できないため
 restore 対象外とする。
 
+`runo runs archive/restore --bundle` はこの state machine を変更しない container 操作とする。
+親ディレクトリへ `.runops-archive.toml` を置いて物理的な active/archive view を表し、
+配下 run の `cancelled` 等の実行結果を保持する。submitted / running を含む bundle は
+移動前の precondition check で拒否する。
+`--adopt-archived` は provenance と相対 path が一致する個別 archive 済み run だけを
+明示的に bundle へ統合する。
+
 `update_state()` は以下を実行します:
 1. manifest.toml から現在の状態を読み取り
 2. 遷移の正当性を検証

{runops-1.2.0 → runops-1.3.0}/docs/get-started-with-agent.md

@@ -167,6 +167,31 @@ runo runs restore R2026...           # archive 前の場所へ全 artifact を
 
 出力を今後も使う場合は `runo runs purge-work` を実行しないでください。
 
+survey 一式を `survey.toml` や cancelled / failed run も含めて退避する場合は、
+親ディレクトリを bundle として移動します。配下の run state は変わりません。
+
+```bash
+runo runs archive runs/scan --bundle
+runo runs list --include-archived
+runo runs restore runs/_archive/scan --bundle
+```
+
+submitted / running を含む bundle は移動されません。`runs/_archive/` は Git 管理可能で、
+`survey.toml`、manifest、入力パラメータ、解析スクリプトは記録できます。
+`work/`、`status/`、cache / scratch は active run と同様に `.gitignore` 対象です。
+
+配下の run を先に個別 archive しており、`runs/_archive/scan` が既にある場合、通常の
+bundle archive は競合として拒否します。元の親と相対パスが一致する archived / purged
+run だけを bundle に取り込むには、明示的に次を使います。
+
+```bash
+runo runs archive runs/scan --bundle --adopt-archived
+```
+
+確認前に採用対象の run ID と状態が表示されます。archive destination に対象 run 以外の
+ファイルがある場合や、元 path が別の親を指す場合は何も移動しません。bundle restore
+では採用した run も元の相対パスへ戻りますが、個々の `archived` / `purged` 状態は保持します。
+
 ## SKILL を明示するとき
 
 通常は「何をしてほしいか」を書けば十分です。意図がずれるときだけ、ひと言添えてください。

{runops-1.2.0 → runops-1.3.0}/docs/layers/interface.md

@@ -193,12 +193,17 @@ service ではありません。
 | `runo analyze new-story NAME [--id ID] [--title TITLE] [--source PATH]` | strict source/schema の story acceptance workspace を作成 |
 | `runo analyze audit-story [STORY_DIR]` | source artifact を照合し `audit.json` / `audit.md` を生成 |
 | `runo runs cancel [RUN]` | submitted/running な run を `scancel` + `sync` で停止 |
-| `runo runs archive [RUNS...] [--keep-in-place] [--move-to DIR]` | completed run を archived にし、既定で `runs/_archive/` へ移動 |
-| `runo runs restore RUN` | archived run を元のパスへ artifact ごと戻して completed にする |
+| `runo runs archive [RUNS...] [--keep-in-place] [--move-to DIR] [--bundle] [--adopt-archived]` | 通常は completed run を archived にする。`--bundle` は親と全内容を移動し、各 run state を保持。`--adopt-archived` は一致する個別 archive 済み run を検証して採用 |
+| `runo runs restore RUN [--bundle]` | 通常は archived run を completed に戻す。`--bundle` は親と全内容を元のパスへ戻す |
 | `runo runs purge-work [RUN] [--discard-incomplete --reason WHY]` | archived run の work 削除。既知 non-ready output の破棄は理由必須 |
 | `runo runs delete [RUN]` | created / cancelled / failed run を削除 |
 
 completed / archived run には `delete` を使わず、`archive` → `purge-work` の経路を使います。
+bundle archive は run state と直交し、submitted / running を含む親は移動しません。
+既存 archive destination は原則拒否し、`--adopt-archived` 指定時だけ同じ親・相対 path の
+archived / purged run を採用します。所有不明 path や source 側の衝突があれば変更しません。
+`runs/_archive/` 自体は Git 管理対象から外さず、active run と同じ `.gitignore` 規則で
+`work/`、`status/`、cache / scratch のみを除外します。
 
 ### Notes / Knowledge
 

{runops-1.2.0 → runops-1.3.0}/docs/toml-reference.md

@@ -721,6 +721,27 @@ status_dir = "status"
 | `archived_at` | datetime string | ISO 8601 timestamp for the latest archive relocation. |
 | `restored_from` | string | Archived directory used for the latest restore. |
 | `restored_at` | datetime string | ISO 8601 timestamp for the latest restore. |
+| `bundle_archived_from` | string | Run path before its parent directory was bundle-archived. Does not change `run.status`. |
+| `bundle_archived_at` | datetime string | ISO 8601 timestamp for the latest parent bundle archive. |
+| `bundle_restored_from` | string | Run path inside the archived parent used for the latest bundle restore. |
+| `bundle_restored_at` | datetime string | ISO 8601 timestamp for the latest parent bundle restore. |
+
+### `.runops-archive.toml`
+
+`runo runs archive PARENT --bundle` が archived parent の直下へ生成する restore marker。
+Git 管理可能な小さな provenance file であり、配下 run の lifecycle state は表さない。
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `bundle.format_version` | integer | Bundle archive metadata format. Currently `1`. |
+| `bundle.archived_from` | absolute path string | Parent directory restored by `runo runs restore --bundle`. |
+| `bundle.archived_at` | datetime string | ISO 8601 archive timestamp. |
+| `bundle.run_count` | integer | Number of run manifests moved with the parent. |
+| `bundle.adopted_run_ids` | array of strings | Individually archived/purged run IDs adopted with `--adopt-archived`; empty for a normal bundle archive. |
+
+`runs/_archive/` 自体は `.gitignore` 対象にしない。ただし `runs/**/work/`、
+`runs/**/status/`、analysis cache / scratch、生成済み input の除外規則は archive 配下にも
+適用される。
 
 ### State Machine
 

{runops-1.2.0 → runops-1.3.0}/pyproject.toml

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

{runops-1.2.0 → runops-1.3.0}/src/runops/__init__.py

@@ -2,4 +2,4 @@
 
 from __future__ import annotations
 
-__version__ = "1.2.0"
+__version__ = "1.3.0"

{runops-1.2.0 → runops-1.3.0}/src/runops/application/actions/__init__.py

@@ -36,6 +36,18 @@ from runops.application.actions.analysis import (
 from runops.application.actions.analysis import (
     summarize_run as summarize_run,
 )
+from runops.application.actions.bundle_archive import (
+    archive_bundle as archive_bundle,
+)
+from runops.application.actions.bundle_archive import (
+    default_bundle_archive_destination as default_bundle_archive_destination,
+)
+from runops.application.actions.bundle_archive import (
+    plan_bundle_archive as plan_bundle_archive,
+)
+from runops.application.actions.bundle_archive import (
+    restore_bundle as restore_bundle,
+)
 from runops.application.actions.knowledge import (
     add_fact as add_fact,
 )
@@ -93,20 +105,24 @@ __all__ = [
     "ActionSpec",
     "ActionStatus",
     "add_fact",
+    "archive_bundle",
     "archive_run",
     "cancel_run",
     "collect_survey",
     "create_run",
     "create_survey",
     "default_archive_destination",
+    "default_bundle_archive_destination",
     "delete_run",
     "execute_action",
     "export_publication",
     "get_action_spec",
     "list_actions",
+    "plan_bundle_archive",
     "plan_retry",
     "promote_fact",
     "purge_work",
+    "restore_bundle",
     "restore_run",
     "retry_run",
     "save_insight",