runops 0.2.0__py3-none-any.whl

runops/__init__.py

@@ -0,0 +1,5 @@
+"""runops: HPC simulation run management CLI tool."""
+
+from __future__ import annotations
+
+__version__ = "0.1.9"

runops/_data/README.md

@@ -0,0 +1,476 @@
+# runops
+
+HPC 環境における Slurm ベースのシミュレーション実行管理 CLI ツール。
+
+run ディレクトリを日常運用の主単位とし、パラメータサーベイ展開・job 投入・状態追跡・provenance 記録・解析補助を一貫して管理します。
+
+## 特徴
+
+- **run 中心の管理**: すべての操作は run ディレクトリ (`runs/.../Rxxxx/`) を基点に行う
+- **パラメータサーベイ**: survey.toml による parameter sweep の自動展開（直積生成）
+- **Slurm 連携**: sbatch による job 投入、squeue/sacct による状態同期
+- **Simulator Adapter**: シミュレータ固有処理を Adapter パターンで抽象化。core はシミュレータに依存しない
+- **Launcher Profile**: srun / mpirun / mpiexec の起動方式を Profile で切替可能
+- **Provenance 記録**: git commit、executable hash、パラメータ snapshot を manifest.toml に自動記録
+- **多重ネスト対応**: `runs/` 以下を自由に階層化して分類・整理できる
+- **Agent/AI 対応**: TOML/JSON ベースの構造化データで AI エージェントとの連携が容易
+- **知識層**: シミュレータ知識・実行環境・研究意図の 3 層で AI エージェントにコンテキストを提供
+- **外部知識ソース**: 共有知識リポジトリを project に接続し、profile ベースで必要な知識だけを投影
+- **Lab notebook**: `notes/YYYY-MM-DD.md` に append-only な時系列ノートを残し、curated knowledge (`.runops/insights/`, `facts.toml`) と二層で管理
+- **パラメータバリデーション**: 物理的制約 (CFL 条件, Debye 長等) を run 生成前にチェック
+- **Research Campaign**: campaign.toml で研究仮説・変数・観測量を構造化し、実験設計を明示
+
+## インストール
+
+runops はプロジェクトごとにブートストラップインストールされます。
+事前のグローバルインストールは不要で、[uv](https://docs.astral.sh/uv/) だけあれば始められます。
+
+```bash
+# プロジェクトディレクトリを作成して初期化 (uv だけあれば OK)
+uvx --from runops runops init
+
+# activate して利用開始
+source .venv/bin/activate
+runops doctor
+```
+
+`runops init` が以下を自動的に行います:
+
+1. `.venv/` を作成 (`uv venv`)
+2. `tools/runops/` に runops リポジトリを clone
+3. runops を `.venv` に editable install (`uv pip install -e`)
+4. シミュレータ固有パッケージをインストール
+
+runops の更新は `cd tools/runops && git pull` で行えます。
+
+### 既存プロジェクトのセットアップ
+
+```bash
+uvx --from runops runops setup https://github.com/user/my-project.git
+source my-project/.venv/bin/activate
+runops doctor
+```
+
+### 開発者向け (runops 自体の開発)
+
+```bash
+git clone https://github.com/Nkzono99/runops.git
+cd runops
+uv sync --dev
+```
+
+## クイックスタート
+
+### 1. プロジェクトの初期化
+
+上記のインストール手順を実行すると、以下のファイル・ディレクトリが生成されます:
+
+```
+my-simulation-project/
+  runops.toml      # プロジェクト設定
+  simulators.toml      # シミュレータ定義
+  launchers.toml       # Launcher Profile 定義
+  SITE.md              # site profile 由来の companion doc (生成物)
+  campaign.toml        # 研究意図 (仮説・変数・観測量)
+  .gitignore           # 大容量出力の除外設定
+  CLAUDE.md            # 現在の標準 Agent ハーネス (Claude Code) 向け指示
+  AGENTS.md            # CLAUDE.md と同内容の補助ミラー
+  .claude/
+    settings.json      # Claude Code の team-shared permission / hook 設定
+    hooks/             # submit 承認・保護パス監視 hook
+    rules/             # project 固有の運用ルール
+    skills/            # 定型作業用 SKILL
+  cases/               # Case 定義の格納場所
+  runs/                # run の格納場所
+  refs/                # シミュレータリファレンス / 外部知識ソース
+    MPIEMSES3D/        # Adapter が参照する simulator docs
+    beach/             # Adapter が参照する simulator docs
+    knowledge/         # 外部知識ソースのマウントポイント
+      shared-lab-kb/   # git/path で接続した共有知識リポジトリ
+  tools/
+    runops/        # runops 本体 (editable install, Git 管理外)
+  .venv/               # Python 仮想環境 (Git 管理外)
+  .runops/             # 知識層 (ナレッジ・環境・知見)
+    knowledge/         # 自動生成ナレッジ (gitignore 対象)
+      enabled/         # 有効な profile の imports.md
+      candidates/      # 外部 source 由来の candidate fact transport
+    insights/          # 実験知見 (人間向け curated Markdown)
+    facts.toml         # 構造化された知識 (AI 向け machine-readable claims)
+    environment.toml   # 実行環境記述 (自動検出)
+  notes/               # Lab notebook (append-only, 時系列)
+    YYYY-MM-DD.md      # 日次の作業ログ (`runops notes append` で追記)
+    reports/           # 長文レポート (改稿可)
+    README.md          # 二層 (curated vs lab notebook) の運用規約
+```
+
+`runops init` が生成する Claude ハーネスは、`.claude/settings.json` と
+`.claude/hooks/` により次のようなガードを入れます。
+
+- `manifest.toml`、`runs/**/input/**`、`submit/job.sh`、`work/**`、`SITE.md` などの生成物は直接編集しない
+- `.runops/facts.toml` や `.runops/insights/` は `runops knowledge save` / `add-fact` 経由で更新する
+- `runops runs submit` は `--dry-run` を除き実行前に確認を挟む
+
+runops 自体の開発では、Claude ハーネスの定義は
+`src/runops/harness/claude.py` にまとまっています。
+
+### 2. 研究意図の定義 (campaign.toml)
+
+プロジェクトルートに `campaign.toml` を作成し、何を調べたいかを記述:
+
+```toml
+[campaign]
+name = "parameter-sensitivity"
+description = "格子サイズと時間刻みの感度解析"
+hypothesis = "nx=512 以上で解が収束する"
+simulator = "my_solver"
+
+[variables]
+"nx" = { role = "independent", range = [128, 1024], unit = "cells" }
+"dt" = { role = "independent", range = [1.0e-9, 1.0e-7], unit = "s" }
+
+[observables]
+max_field = { source = "work/output.h5", description = "最大電場強度" }
+```
+
+AI エージェントはこのファイルを読んで survey 設計や結果解釈に活用します。
+
+### 3. シミュレータと Launcher の設定
+
+`simulators.toml` にシミュレータを定義 (シミュレータ指定で init した場合は自動生成):
+
+```toml
+[simulators.my_solver]
+adapter = "generic"
+resolver_mode = "local_executable"
+executable = "/path/to/solver"
+```
+
+`launchers.toml` に Launcher Profile を定義:
+
+```toml
+[launchers.slurm_srun]
+kind = "srun"
+command = "srun"
+use_slurm_ntasks = true
+```
+
+### 4. Case の定義
+
+`runops case new` で case を生成し、`cases/<simulator>/<case>/case.toml` を編集します:
+
+```bash
+runops case new my_case -s my_solver
+```
+
+生成された `cases/my_solver/my_case/case.toml` の例:
+
+```toml
+[case]
+name = "my_case"
+simulator = "my_solver"
+launcher = "slurm_srun"
+description = "基本ケース"
+
+[classification]
+model = "cavity"
+submodel = "rectangular"
+tags = ["baseline"]
+
+[job]
+partition = "compute"
+nodes = 1
+ntasks = 32
+walltime = "12:00:00"
+
+[params]
+nx = 256
+ny = 256
+dt = 1.0e-8
+```
+
+### 5. 単一 run の作成
+
+```bash
+runops runs create my_case --dest runs/cavity/test
+```
+
+### 6. パラメータサーベイの実行
+
+`runs/cavity/scan/survey.toml` を作成:
+
+```toml
+[survey]
+id = "S20260327-scan"
+name = "parameter scan"
+base_case = "my_case"
+simulator = "my_solver"
+launcher = "slurm_srun"
+
+[axes]
+nx = [128, 256, 512]
+dt = [1.0e-8, 1.0e-9]
+
+[naming]
+display_name = "nx{nx}_dt{dt}"
+
+[job]
+partition = "compute"
+nodes = 1
+ntasks = 32
+walltime = "12:00:00"
+```
+
+```bash
+runops runs sweep runs/cavity/scan
+```
+
+### 7. Job の投入
+
+```bash
+# cwd の run を投入
+cd runs/cavity/test/R20260327-0001
+runops runs submit
+
+# survey 内の全 run を一括投入
+cd runs/cavity/scan
+runops runs submit --all
+```
+
+### 8. 状態の確認
+
+```bash
+# 単一 run の状態確認
+runops runs status R20260327-0001
+
+# Slurm 状態を manifest に同期
+runops runs sync R20260327-0001
+
+# run の一覧表示
+runops runs list
+runops runs list runs/cavity/scan
+```
+
+## コマンドリファレンス
+
+### プロジェクト管理
+
+| コマンド | 説明 |
+|---------|------|
+| `runops init [SIMS...] [-y]` | プロジェクトの初期化 (対話型がデフォルト) |
+| `runops setup [URL]` | 既存 runops project のセットアップ |
+| `runops doctor [PATH]` | 環境検査 (設定・sbatch・run_id 一意性・環境検出) |
+| `runops context [DIR]` | Agent 向け project context の要約を表示 |
+| `runops config show` | 設定表示 |
+| `runops config add-simulator` | シミュレータ追加 (対話型) |
+| `runops config add-launcher` | ランチャー追加 (対話型) |
+| `runops update` | シミュレータパッケージのアップグレード |
+| `runops update-refs [SIMS...]` | refs/ リポジトリ更新 + ナレッジインデックス再生成 |
+
+### Run 作成・投入
+
+| コマンド | 説明 |
+|---------|------|
+| `runops case new CASE [--minimal] [--survey]` | 新規 case のスキャフォールド生成 (`--minimal` で小さな bundled テンプレートを使用、EMSES では `emu generate -u` を best-effort で自動実行し `[meta.physical]` を埋める) |
+| `runops runs create CASE` | case から単一 run を生成 |
+| `runops runs sweep [DIR] [--dry-run]` | survey.toml からパラメータ直積で全 run 一括生成 (`--dry-run` で件数・パラメータ組合せ・概算 core-hour のみ表示) |
+| `runops runs submit [RUN]` | run を sbatch で投入 (`-qn` でキュー上書き、`--afterok` で依存ジョブ指定) |
+| `runops runs submit --all [DIR]` | created な run を一括投入 |
+| `runops runs clone` | run 複製・派生 |
+| `runops runs extend` | スナップショットから継続 run 生成 |
+
+### 状態管理・モニタリング
+
+| コマンド | 説明 |
+|---------|------|
+| `runops runs status [RUNS...]` | run の状態確認 (run_id / run dir / survey dir を複数渡してまとめて表示可) |
+| `runops runs sync [RUNS...]` | Slurm 状態を manifest.toml に反映 (bulk 対応: survey 配下の created run + terminal state な run は silent skip) |
+| `runops runs log [RUN]` | 最新 job の stdout/stderr 表示 + 進捗% |
+| `runops runs jobs [PATH] [--watch SECS]` | プロジェクト内の実行中ジョブ一覧 (`--watch` で自動更新) |
+| `runops runs dashboard [TARGETS...] [--watch SECS] [--all]` | 複数 run の進捗 (state, step/N, %, last Slurm state) を 1 つの表で表示 |
+| `runops runs history [PATH]` | 投入履歴表示 |
+| `runops runs list [PATHS...]` | run の一覧表示 (複数 PATH 指定可、状態・タグでフィルタ可能) |
+
+### 解析・整理
+
+| コマンド | 説明 |
+|---------|------|
+| `runops analyze summarize [RUN]` | Adapter による run 解析 summary 生成 |
+| `runops analyze collect [DIR]` | survey 内の全 run から集計データ生成 |
+| `runops analyze plot [DIR]` | survey 集計結果の可視化 (`--recipe` / `--list-recipes` 対応) |
+| `runops runs cancel [RUN]` | submitted/running な run を `scancel` + `sync` で安全に停止 |
+| `runops runs archive [RUN]` | run のアーカイブ (completed のみ) |
+| `runops runs purge-work [RUN]` | work/ 内の不要ファイル削除 (archived のみ) |
+| `runops runs delete [RUN]` | created / cancelled / failed の run ディレクトリをハード削除 (completed/archived は archive → purge-work を使う) |
+
+### Lab notebook (実験ノート)
+
+| コマンド | 説明 |
+|---------|------|
+| `runops notes append TITLE [BODY]` | 今日の `notes/YYYY-MM-DD.md` に timestamped エントリを追記 (`-` または省略で stdin から本文を読む) |
+| `runops notes list [-n N]` | 最近の lab notebook 日付一覧 (新しい順) |
+| `runops notes show [DATE\|today\|latest]` | 指定日 (省略時は today) の lab notebook を表示 |
+
+`notes/` は curated knowledge (`.runops/insights/`, `facts.toml`) と
+**二層構造** で運用する append-only な実験ノートです。準備フェーズの意思決定、観察、
+仮説、TODO をその場で残し、価値が出てきたら `notes/reports/` の long-form
+レポートを経て `runops knowledge save` / `add-fact` で curated 層に昇格させます。
+
+### 知識管理
+
+| コマンド | 説明 |
+|---------|------|
+| `runops knowledge save NAME` | 知見を .runops/insights/ に保存 |
+| `runops knowledge list` | 知見一覧表示 |
+| `runops knowledge show NAME` | 知見の詳細表示 |
+| `runops knowledge add-fact CLAIM` | 構造化された知識を facts.toml に追加 |
+| `runops knowledge facts` | local facts と imported candidate facts の一覧表示 |
+| `runops knowledge promote-fact FACT_ID` | candidate fact を local facts.toml に昇格 |
+| `runops knowledge source list` | 外部知識ソース一覧表示 |
+| `runops knowledge source attach TYPE NAME URL` | 外部知識ソースを接続 (git / path) |
+| `runops knowledge source detach NAME` | 外部知識ソースを切断 |
+| `runops knowledge source sync [NAME]` | 知識ソース同期 + insight / fact transport |
+| `runops knowledge source render` | 有効な profile から imports.md を生成 |
+| `runops knowledge source status` | 知識統合の状態表示 |
+| `runops knowledge profile enable SOURCE PROFILE...` | source の profile を有効化して imports.md を更新 |
+| `runops knowledge profile disable SOURCE PROFILE...` | source の profile を無効化して imports.md を更新 |
+
+知識管理は三層構造:
+- **source knowledge** — 外部共有知識リポジトリ (`refs/knowledge/` にマウント)
+- **local knowledge** — プロジェクト固有の知見 (insights, facts)
+- **derived knowledge** — source と local から生成される派生物 (imports.md, candidate fact transport 等)
+
+profile source は repo ルートの `entrypoints.toml` で import 対象を明示できる。`imports.md` はこの manifest を優先し、未指定 profile は `profiles/<name>.md` にフォールバックする。
+
+全コマンドは引数省略時にカレントディレクトリをデフォルトとする。
+
+## プロジェクト構成
+
+```
+runops/
+  pyproject.toml
+  SPEC.md                  # 詳細仕様書
+  CLAUDE.md                # 開発ガイド
+  AGENTS.md                # Agent 運用ガイド
+  src/
+    runops/
+      cli/                 # CLI エントリポイント (typer)
+        main.py            # コマンド登録
+        init.py            # init / setup / doctor
+        new.py             # case new (`--minimal`, EMSES `emu generate -u`)
+        create.py          # runs create / runs sweep (`--dry-run`)
+        submit.py          # runs submit (`-qn`, `--afterok`)
+        status.py          # runs status / runs sync (bulk-friendly)
+        log.py             # runs log
+        jobs.py            # runs jobs (`--watch`)
+        dashboard.py       # runs dashboard (multi-run 進捗ビュー)
+        history.py         # runs history
+        list.py            # runs list (複数 PATH 対応)
+        clone.py           # runs clone
+        extend.py          # runs extend
+        analyze.py         # analyze summarize / collect / plot
+        notes.py           # notes append / list / show (lab notebook)
+        manage.py          # runs archive / purge-work / cancel / delete
+        update.py          # update (パッケージ更新)
+        update_refs.py     # update-refs (refs/ 更新 + ナレッジ)
+        knowledge.py       # knowledge / knowledge source
+        config.py          # config (設定管理)
+      core/                # ドメインロジック
+        project.py         # Project 読込・検証
+        case.py            # Case 読込・展開
+        survey.py          # Survey 展開・parameter 直積
+        run.py             # Run 生成・run_id 採番
+        manifest.py        # manifest.toml 読書き
+        state.py           # 状態遷移管理
+        provenance.py      # コード provenance 取得
+        discovery.py       # runs/ 再帰探索・run_id 一意性検証
+        exceptions.py      # ドメイン例外
+        validation.py      # パラメータバリデーション
+        campaign.py        # campaign.toml 読込
+        environment.py     # 実行環境検出・記述
+        knowledge.py       # 知識層 (insights, facts)
+        knowledge_source.py  # 外部知識ソース管理
+      adapters/            # Simulator Adapter
+        base.py            # SimulatorAdapter 抽象基底クラス
+        registry.py        # Adapter 登録・lookup
+        generic.py         # 汎用 Adapter 実装
+      launchers/           # Launcher Profile
+        base.py            # Launcher 抽象基底クラス
+        srun.py            # srun Launcher
+        mpirun.py          # mpirun Launcher
+        mpiexec.py         # mpiexec Launcher
+      jobgen/              # job.sh 生成
+        generator.py       # Slurm batch script 生成
+      slurm/               # Slurm 連携
+        submit.py          # sbatch 投入
+        query.py           # squeue / sacct 問合せ
+  tests/
+  docs/
+```
+
+## 状態遷移
+
+run は以下の状態遷移に従います:
+
+```
+created --> submitted --> running --> completed
+                |           |
+                v           v
+             failed      failed
+                |
+                v
+            cancelled
+
+completed --> archived --> purged
+```
+
+`runops runs cancel` は `submitted` / `running` の run に対して `scancel` と `sync`
+を組み合わせて発行し、最終状態を `cancelled` に遷移させます。
+`runops runs delete` はライフサイクル外の操作で、`created` / `cancelled` / `failed`
+の run ディレクトリを直接削除します (`completed` / `archived` の run は
+`archive` → `purge-work` 経路を使ってください)。
+
+> **Note**: `runops runs sync` は Slurm の観測結果を manifest に反映するため、
+> ポーリング間隔によっては `submitted → completed` のように途中状態を飛び越す遷移が発生します。
+> 詳細は [SPEC.md](SPEC.md) を参照してください。
+
+## 技術スタック
+
+- Python 3.10+
+- CLI: [typer](https://typer.tiangolo.com/) (click ベース)
+- 設定ファイル: TOML (tomli / tomli-w)
+- パッケージ管理: [uv](https://docs.astral.sh/uv/)
+- テスト: pytest
+- Lint/Format: ruff
+- 型チェック: mypy (strict)
+
+## 開発
+
+```bash
+# テスト
+uv run pytest
+
+# Lint
+uv run ruff check src/ tests/
+uv run ruff format --check src/ tests/
+
+# 型チェック
+uv run mypy src/
+
+# CLI 実行 (開発中)
+uv run runops --help
+```
+
+## ドキュメント
+
+- [AI エージェントではじめる](docs/get-started-with-agent.md) -- `runops init` 済み project を Agent と進める最短導線
+- [AI Agent 運用概念図](docs/project-flow.md) -- `runops init` 後の project を Agent とどう回すかの全体像
+- [src 構成ガイド](docs/src-structure.md) -- `src/runops/` の層構造と adapter / launcher / site 解決の流れ
+- [アーキテクチャ](docs/architecture.md) -- システム設計とモジュール構成
+- [拡張ガイド](docs/extending.md) -- Adapter / Launcher の追加方法
+- [知識層](docs/knowledge-layer.md) -- AI エージェント向け知識管理アーキテクチャ
+- [TOML リファレンス](docs/toml-reference.md) -- 全設定ファイルのフィールド定義
+- [SPEC.md](SPEC.md) -- 完全な仕様書
+
+## ライセンス
+
+Apache-2.0

runops/adapters/__init__.py

@@ -0,0 +1,29 @@
+"""Simulator adapters for abstracting simulator-specific behavior.
+
+Importing this package automatically registers the built-in adapters
+(e.g. ``GenericAdapter``) in the global registry.
+"""
+
+from __future__ import annotations
+
+from runops.adapters.base import SimulatorAdapter
+from runops.adapters.contrib.beach import BeachAdapter
+from runops.adapters.contrib.emses import EmseAdapter
+from runops.adapters.generic import GenericAdapter
+from runops.adapters.registry import get, get_global_registry, list_adapters, register
+
+# Register built-in adapters on import
+register(GenericAdapter)
+register(EmseAdapter)
+register(BeachAdapter)
+
+__all__ = [
+    "BeachAdapter",
+    "EmseAdapter",
+    "GenericAdapter",
+    "SimulatorAdapter",
+    "get",
+    "get_global_registry",
+    "list_adapters",
+    "register",
+]

runops/adapters/_utils/__init__.py

@@ -0,0 +1,36 @@
+"""Shared utilities for simulator adapters."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from runops.adapters._utils.toml_utils import apply_dotted_overrides
+
+
+def find_venv(start: Path) -> Path | None:
+    """Find the nearest ``.venv`` directory by searching upward.
+
+    Starts from *start* and walks parent directories until a ``.venv``
+    directory containing ``bin/activate`` (or ``Scripts/activate``) is found.
+
+    Args:
+        start: Starting directory for the search.
+
+    Returns:
+        Path to the venv directory, or ``None`` if not found.
+    """
+    current = start.resolve()
+    for directory in [current, *current.parents]:
+        venv = directory / ".venv"
+        if venv.is_dir() and (
+            (venv / "bin" / "activate").exists()
+            or (venv / "Scripts" / "activate").exists()
+        ):
+            return venv
+    return None
+
+
+__all__ = [
+    "apply_dotted_overrides",
+    "find_venv",
+]

runops/adapters/_utils/toml_utils.py

@@ -0,0 +1,81 @@
+"""Shared TOML configuration utilities for simulator adapters.
+
+Provides deep-merge and dot-notation override for TOML-based configs.
+Supports both dict navigation and list-index access for array-of-tables
+(e.g. ``species.0.wp`` targets ``config["species"][0]["wp"]``).
+"""
+
+from __future__ import annotations
+
+import copy
+from typing import Any
+
+
+def deep_merge(base: dict[str, Any], override: dict[str, Any]) -> dict[str, Any]:
+    """Deep-merge *override* into *base*.
+
+    Dicts are recursively merged; all other values (including lists)
+    are replaced.
+
+    Args:
+        base: Base configuration dictionary.
+        override: Overrides to apply.
+
+    Returns:
+        New merged dictionary (neither input is mutated).
+    """
+    result = copy.deepcopy(base)
+    for key, value in override.items():
+        if key in result and isinstance(result[key], dict) and isinstance(value, dict):
+            result[key] = deep_merge(result[key], value)
+        else:
+            result[key] = copy.deepcopy(value)
+    return result
+
+
+def apply_dotted_overrides(
+    config: dict[str, Any],
+    overrides: dict[str, Any],
+) -> dict[str, Any]:
+    """Apply flat dot-notation overrides to a nested config dict.
+
+    Supports both dict keys and numeric list indices::
+
+        {"sim.dt": 1e-8}             -> config["sim"]["dt"] = 1e-8
+        {"species.0.wp": 2.1}        -> config["species"][0]["wp"] = 2.1
+        {"tmgrid.nx": 512}           -> config["tmgrid"]["nx"] = 512
+
+    Args:
+        config: Base config dictionary.
+        overrides: Flat dot-notation key-value pairs.
+
+    Returns:
+        New dict with overrides applied (input not mutated).
+    """
+    result = copy.deepcopy(config)
+    for key, value in overrides.items():
+        parts = key.split(".")
+        target: Any = result
+        for part in parts[:-1]:
+            if isinstance(target, list):
+                target = target[int(part)]
+            elif part.isdigit() and isinstance(target.get(part), type(None)):
+                # Numeric key not present as string; skip if target is a list-like
+                idx = int(part)
+                # Check if the parent is storing a list
+                target = (
+                    target[idx]
+                    if isinstance(target, list)
+                    else target.setdefault(part, {})
+                )
+            else:
+                if part not in target:
+                    target[part] = {}
+                target = target[part]
+        # Set the final value
+        leaf = parts[-1]
+        if isinstance(target, list):
+            target[int(leaf)] = value
+        else:
+            target[leaf] = value
+    return result