caasi 0.1.0__tar.gz

caasi-0.1.0/.gitignore

@@ -0,0 +1,26 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+.eggs/
+
+# Environments
+.venv/
+venv/
+.env
+
+# Tooling caches
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# Caasi runtime artifacts
+runs/
+datasets/
+
+# Editors / OS
+.idea/
+.vscode/
+.DS_Store

caasi-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 a6y3ap (https://github.com/a6y3ap)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

caasi-0.1.0/PKG-INFO

@@ -0,0 +1,178 @@
+Metadata-Version: 2.5
+Name: caasi
+Version: 0.1.0
+Summary: A lightweight, CLI-first orchestration layer for NVIDIA Isaac Sim, Isaac Lab and the robotics ecosystem.
+Project-URL: Homepage, https://github.com/a6y3ap/caasi
+Project-URL: Repository, https://github.com/a6y3ap/caasi
+Project-URL: Documentation, https://a6y3ap.github.io/caasi/
+Project-URL: Issues, https://github.com/a6y3ap/caasi/issues
+Author: a6y3ap
+License: MIT
+License-File: LICENSE
+Keywords: caasi,cli,isaac,isaac-lab,isaac-sim,robotics,ros2,simulation
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.10
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.7
+Requires-Dist: typer>=0.12
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Caasi
+
+A lightweight, **CLI-first orchestration layer** for NVIDIA Isaac Sim, Isaac Lab and the
+wider robotics ecosystem (ROS 2, Nav2, MoveIt 2, ros2\_control, ...).
+
+Headless-first. CLI-first. Process-oriented. Visualization-independent.
+
+**Documentation:** <https://a6y3ap.github.io/caasi/>
+
+> **Note:** Caasi is an independent open-source project. It is not affiliated with,
+> endorsed by, or an official product of NVIDIA.
+
+## Philosophy
+
+- **Use existing software. Don't reinvent it.** Caasi discovers, configures, launches,
+  connects, monitors and manages tools that already exist.
+- **Simulation is not visualization.** Run headless by default; attach a viewer only when needed.
+- **Minimum required stack.** The Caasi process itself stays lightweight and never imports the
+  heavy Isaac stack, PyTorch or rclpy — it only delegates to them.
+- **Don't become another ROS.** ROS orchestration is delegated to the real `ros2` tooling.
+- **Unix-friendly.** Small commands, `--json` output, sensible exit codes.
+
+## Install
+
+Requires Python 3.10+ on Linux. The Isaac stack, ROS 2 and PyTorch are *discovered*, not
+installed, by Caasi.
+
+```bash
+pip install caasi
+```
+
+Or from source:
+
+```bash
+git clone https://github.com/a6y3ap/caasi.git
+cd caasi
+pip install -e .              # add pytest as well: pip install -e ".[dev]"
+```
+
+Either way this installs the `caasi` command. Shell completion is available:
+
+```bash
+caasi --install-completion
+```
+
+## Quickstart
+
+```bash
+caasi doctor                    # diagnose the whole environment
+caasi doctor --component nvidia # one section only
+caasi gpu status                # GPU overview via nvidia-smi
+caasi system status             # OS / CPU / RAM / disk summary
+caasi info                      # CLI + configured/detected ecosystem versions
+caasi config show               # effective configuration
+caasi config set tools.isaacsim.default "6.0"
+```
+
+Every command supports `--help`. Data commands support `--json` for scripting:
+
+```bash
+caasi gpu status --json | jq '.gpus[0]["memory.used"]'
+if caasi doctor --quiet; then echo "environment ready"; fi
+```
+
+Simulations, training jobs and ROS launches start **detached** and are tracked as *runs* —
+the CLI returns immediately and the work survives your terminal:
+
+```bash
+caasi sim run experiments/wave.yaml
+caasi run list
+caasi logs latest --follow      # Ctrl+C stops following, the run keeps going
+caasi run status latest
+```
+
+## Command surface
+
+| Group               | Commands                                                                                            | Reference                                                                        |
+| ------------------- | --------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
+| Environment         | `doctor`, `gpu status\|info\|memory\|test`, `system status\|memory\|processes`, `info`, `version`   | [environment.html](https://a6y3ap.github.io/caasi/environment.html)       |
+| Configuration       | `config show\|get\|set\|path\|tools`                                                                | [configuration.html](https://a6y3ap.github.io/caasi/configuration.html)   |
+| Projects            | `init`, `setup`, `project info\|validate`, `robot`, `scene`, `task`                                 | [projects.html](https://a6y3ap.github.io/caasi/projects.html)             |
+| Runs & logs         | `run list\|status\|logs\|stop\|pause\|resume\|delete\|inspect`, `logs`                              | [runs.html](https://a6y3ap.github.io/caasi/runs.html)                     |
+| Simulation          | `sim run\|status\|check\|stop\|pause\|resume`, `lab status`                                         | [simulation.html](https://a6y3ap.github.io/caasi/simulation.html)         |
+| Training            | `train`, `benchmark start\|report`                                                                  | [training.html](https://a6y3ap.github.io/caasi/training.html)             |
+| Data & sensors      | `dataset generate\|inspect\|convert\|validate`, `sensor list\|inspect\|test`, `vision status\|inspect\|test` | [data.html](https://a6y3ap.github.io/caasi/data.html)             |
+| Review              | `replay`, `view rviz\|foxglove\|open3d\|attach`                                                     | [review.html](https://a6y3ap.github.io/caasi/review.html)                 |
+| ROS ecosystem       | `ros status\|doctor\|list\|launch\|topic\|node\|graph`, `nav status\|launch\|inspect\|test`, `moveit status\|launch\|plan\|test`, `control status\|list\|check` | [ros.html](https://a6y3ap.github.io/caasi/ros.html) |
+| Native & shell      | `native run\|sim\|lab\|ros`, `shell`                                                                | [native.html](https://a6y3ap.github.io/caasi/native.html)                 |
+| Remote & containers | `remote list\|connect\|run`, `container list\|check\|run`                                           | [remote.html](https://a6y3ap.github.io/caasi/remote.html)                 |
+
+More examples:
+
+```bash
+caasi train experiments/ant.yaml --steps 500000 --envs 4096
+caasi ros status && caasi nav launch --map maps/warehouse.yaml
+caasi container run nvcr.io/nvidia/isaac-sim:5.1.0 ./runheadless.sh
+caasi remote run gpu-box python train.py --steps 1000
+```
+
+## Configuration
+
+Global config lives at `~/.config/caasi/config.yaml`; a project-local `./caasi.yaml`
+is merged on top. Override the global file with `CAASI_CONFIG` or `--config`;
+`CAASI_LANG` overrides the language.
+
+```yaml
+language: en
+tools:
+  isaacsim:
+    default: "6.0"
+    versions:
+      "6.0": { path: /opt/isaac-sim-6.0 }
+      "5.1": { path: /opt/isaac-sim-5.1 }
+remotes:
+  gpu-box:
+    host: 10.0.0.5
+    user: robot
+    port: 2222
+    identity: ~/.ssh/id_ed25519
+    path: ~/experiments
+```
+
+Manage it with `caasi config show|get|set|path|tools`.
+
+## Examples
+
+[`examples/navigation.yaml`](examples/navigation.yaml) is a commented experiment config —
+the input format shared by `sim run`, `train`, `benchmark start` and `dataset generate`:
+
+```bash
+caasi sim run examples/navigation.yaml --dry-run   # print the launch command, start nothing
+```
+
+## Tests
+
+```bash
+pytest
+```
+
+## Documentation
+
+Read it at <https://a6y3ap.github.io/caasi/> or open
+[`docs/index.html`](docs/index.html) directly in a browser.
+
+## License
+
+MIT © [a6y3ap](https://github.com/a6y3ap) — see [LICENSE](LICENSE).

caasi-0.1.0/README.md

@@ -0,0 +1,147 @@
+# Caasi
+
+A lightweight, **CLI-first orchestration layer** for NVIDIA Isaac Sim, Isaac Lab and the
+wider robotics ecosystem (ROS 2, Nav2, MoveIt 2, ros2\_control, ...).
+
+Headless-first. CLI-first. Process-oriented. Visualization-independent.
+
+**Documentation:** <https://a6y3ap.github.io/caasi/>
+
+> **Note:** Caasi is an independent open-source project. It is not affiliated with,
+> endorsed by, or an official product of NVIDIA.
+
+## Philosophy
+
+- **Use existing software. Don't reinvent it.** Caasi discovers, configures, launches,
+  connects, monitors and manages tools that already exist.
+- **Simulation is not visualization.** Run headless by default; attach a viewer only when needed.
+- **Minimum required stack.** The Caasi process itself stays lightweight and never imports the
+  heavy Isaac stack, PyTorch or rclpy — it only delegates to them.
+- **Don't become another ROS.** ROS orchestration is delegated to the real `ros2` tooling.
+- **Unix-friendly.** Small commands, `--json` output, sensible exit codes.
+
+## Install
+
+Requires Python 3.10+ on Linux. The Isaac stack, ROS 2 and PyTorch are *discovered*, not
+installed, by Caasi.
+
+```bash
+pip install caasi
+```
+
+Or from source:
+
+```bash
+git clone https://github.com/a6y3ap/caasi.git
+cd caasi
+pip install -e .              # add pytest as well: pip install -e ".[dev]"
+```
+
+Either way this installs the `caasi` command. Shell completion is available:
+
+```bash
+caasi --install-completion
+```
+
+## Quickstart
+
+```bash
+caasi doctor                    # diagnose the whole environment
+caasi doctor --component nvidia # one section only
+caasi gpu status                # GPU overview via nvidia-smi
+caasi system status             # OS / CPU / RAM / disk summary
+caasi info                      # CLI + configured/detected ecosystem versions
+caasi config show               # effective configuration
+caasi config set tools.isaacsim.default "6.0"
+```
+
+Every command supports `--help`. Data commands support `--json` for scripting:
+
+```bash
+caasi gpu status --json | jq '.gpus[0]["memory.used"]'
+if caasi doctor --quiet; then echo "environment ready"; fi
+```
+
+Simulations, training jobs and ROS launches start **detached** and are tracked as *runs* —
+the CLI returns immediately and the work survives your terminal:
+
+```bash
+caasi sim run experiments/wave.yaml
+caasi run list
+caasi logs latest --follow      # Ctrl+C stops following, the run keeps going
+caasi run status latest
+```
+
+## Command surface
+
+| Group               | Commands                                                                                            | Reference                                                                        |
+| ------------------- | --------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
+| Environment         | `doctor`, `gpu status\|info\|memory\|test`, `system status\|memory\|processes`, `info`, `version`   | [environment.html](https://a6y3ap.github.io/caasi/environment.html)       |
+| Configuration       | `config show\|get\|set\|path\|tools`                                                                | [configuration.html](https://a6y3ap.github.io/caasi/configuration.html)   |
+| Projects            | `init`, `setup`, `project info\|validate`, `robot`, `scene`, `task`                                 | [projects.html](https://a6y3ap.github.io/caasi/projects.html)             |
+| Runs & logs         | `run list\|status\|logs\|stop\|pause\|resume\|delete\|inspect`, `logs`                              | [runs.html](https://a6y3ap.github.io/caasi/runs.html)                     |
+| Simulation          | `sim run\|status\|check\|stop\|pause\|resume`, `lab status`                                         | [simulation.html](https://a6y3ap.github.io/caasi/simulation.html)         |
+| Training            | `train`, `benchmark start\|report`                                                                  | [training.html](https://a6y3ap.github.io/caasi/training.html)             |
+| Data & sensors      | `dataset generate\|inspect\|convert\|validate`, `sensor list\|inspect\|test`, `vision status\|inspect\|test` | [data.html](https://a6y3ap.github.io/caasi/data.html)             |
+| Review              | `replay`, `view rviz\|foxglove\|open3d\|attach`                                                     | [review.html](https://a6y3ap.github.io/caasi/review.html)                 |
+| ROS ecosystem       | `ros status\|doctor\|list\|launch\|topic\|node\|graph`, `nav status\|launch\|inspect\|test`, `moveit status\|launch\|plan\|test`, `control status\|list\|check` | [ros.html](https://a6y3ap.github.io/caasi/ros.html) |
+| Native & shell      | `native run\|sim\|lab\|ros`, `shell`                                                                | [native.html](https://a6y3ap.github.io/caasi/native.html)                 |
+| Remote & containers | `remote list\|connect\|run`, `container list\|check\|run`                                           | [remote.html](https://a6y3ap.github.io/caasi/remote.html)                 |
+
+More examples:
+
+```bash
+caasi train experiments/ant.yaml --steps 500000 --envs 4096
+caasi ros status && caasi nav launch --map maps/warehouse.yaml
+caasi container run nvcr.io/nvidia/isaac-sim:5.1.0 ./runheadless.sh
+caasi remote run gpu-box python train.py --steps 1000
+```
+
+## Configuration
+
+Global config lives at `~/.config/caasi/config.yaml`; a project-local `./caasi.yaml`
+is merged on top. Override the global file with `CAASI_CONFIG` or `--config`;
+`CAASI_LANG` overrides the language.
+
+```yaml
+language: en
+tools:
+  isaacsim:
+    default: "6.0"
+    versions:
+      "6.0": { path: /opt/isaac-sim-6.0 }
+      "5.1": { path: /opt/isaac-sim-5.1 }
+remotes:
+  gpu-box:
+    host: 10.0.0.5
+    user: robot
+    port: 2222
+    identity: ~/.ssh/id_ed25519
+    path: ~/experiments
+```
+
+Manage it with `caasi config show|get|set|path|tools`.
+
+## Examples
+
+[`examples/navigation.yaml`](examples/navigation.yaml) is a commented experiment config —
+the input format shared by `sim run`, `train`, `benchmark start` and `dataset generate`:
+
+```bash
+caasi sim run examples/navigation.yaml --dry-run   # print the launch command, start nothing
+```
+
+## Tests
+
+```bash
+pytest
+```
+
+## Documentation
+
+Read it at <https://a6y3ap.github.io/caasi/> or open
+[`docs/index.html`](docs/index.html) directly in a browser.
+
+## License
+
+MIT © [a6y3ap](https://github.com/a6y3ap) — see [LICENSE](LICENSE).

caasi-0.1.0/docs/assets/copy.js

@@ -0,0 +1,98 @@
+/* Caasi CLI documentation — copy buttons for caasi commands.
+ * Injects a small "copy" button next to every command that invokes caasi:
+ *   • each `$ caasi …` input line of a terminal example (pre.term .in),
+ *   • each synopsis block (pre.syn) whose signature starts with caasi.
+ * Output lines, YAML/JSON samples and non-caasi shell lines are left alone.
+ * The async clipboard API is tried first, with an execCommand fallback
+ * because the docs are also read straight off disk (file://), where
+ * navigator.clipboard is frequently unavailable.
+ */
+(function () {
+  "use strict";
+
+  var LABEL = "copy";
+
+  // caasi counts as "the command" when it starts the line or follows a shell
+  // separator (&&, ||, ;, |, (, $(, sudo) — not when it is merely an argument
+  // or a path component (`cd caasi`, `~/.caasi/runs`).
+  var CAASI_CALL = /(?:^|&&|\|\||[;|(]|\$\(|\bsudo)\s*caasi(?:\s|$)/;
+
+  function legacyCopy(text) {
+    var area = document.createElement("textarea");
+    area.value = text;
+    area.setAttribute("readonly", "");
+    area.style.cssText = "position:fixed;top:0;left:-9999px;opacity:0";
+    document.body.appendChild(area);
+    area.select();
+    var ok = false;
+    try {
+      ok = document.execCommand("copy");
+    } catch (e) {
+      ok = false;
+    }
+    document.body.removeChild(area);
+    return ok ? Promise.resolve() : Promise.reject(new Error("copy failed"));
+  }
+
+  function writeClipboard(text) {
+    if (navigator.clipboard && navigator.clipboard.writeText) {
+      return navigator.clipboard.writeText(text).catch(function () {
+        return legacyCopy(text);
+      });
+    }
+    return legacyCopy(text);
+  }
+
+  /* host — the element the button is appended to (styled absolute in CSS). */
+  function attach(host, text) {
+    var button = document.createElement("button");
+    var timer = 0;
+
+    button.type = "button";
+    button.className = "copy-cmd";
+    button.textContent = LABEL;
+    button.title = "Copy: " + text.split("\n")[0];
+    button.setAttribute("aria-label", "Copy command to clipboard");
+
+    function flash(message, cls) {
+      window.clearTimeout(timer);
+      button.textContent = message;
+      button.classList.add(cls);
+      timer = window.setTimeout(function () {
+        button.textContent = LABEL;
+        button.classList.remove("done", "fail");
+      }, 1400);
+    }
+
+    button.addEventListener("click", function () {
+      writeClipboard(text).then(
+        function () {
+          flash("copied", "done");
+        },
+        function () {
+          flash("failed", "fail");
+        }
+      );
+    });
+
+    host.appendChild(button);
+  }
+
+  function install() {
+    var lines = document.querySelectorAll("pre.term .in");
+    Array.prototype.forEach.call(lines, function (line) {
+      var text = line.textContent.replace(/\s+$/, "");
+      if (CAASI_CALL.test(text)) attach(line, text);
+    });
+
+    var synopses = document.querySelectorAll("pre.syn");
+    Array.prototype.forEach.call(synopses, function (pre) {
+      var code = pre.querySelector("code");
+      if (!code) return;
+      var text = code.textContent.replace(/\s+$/, "");
+      if (/^caasi(?:\s|$)/m.test(text)) attach(pre, text);
+    });
+  }
+
+  document.addEventListener("DOMContentLoaded", install);
+})();

caasi-0.1.0/docs/assets/sidebar.js

@@ -0,0 +1,151 @@
+/* Caasi CLI documentation — shared sidebar navigation.
+ * Every page includes this script; it renders the nav into <aside id="sidebar">
+ * and marks the current page/section as active.
+ */
+(function () {
+  "use strict";
+
+  var NAV = [
+    {
+      title: "Getting Started",
+      items: [
+        { href: "index.html", label: "Overview" },
+        { href: "index.html#architecture", label: "Architecture", sub: true },
+        { href: "index.html#installation", label: "Installation", sub: true },
+        { href: "index.html#quickstart", label: "Quickstart", sub: true },
+        { href: "index.html#conventions", label: "Global options & conventions", sub: true },
+        { href: "index.html#command-map", label: "Command map", sub: true }
+      ]
+    },
+    {
+      title: "Fundamentals",
+      items: [
+        { href: "environment.html", label: "Environment" },
+        { href: "environment.html#doctor", label: "doctor", sub: true },
+        { href: "environment.html#gpu", label: "gpu", sub: true },
+        { href: "environment.html#system", label: "system", sub: true },
+        { href: "environment.html#info", label: "info & version", sub: true },
+        { href: "configuration.html", label: "Configuration" },
+        { href: "configuration.html#files", label: "Files & precedence", sub: true },
+        { href: "configuration.html#tools", label: "Tool registry", sub: true },
+        { href: "configuration.html#config-cmd", label: "caasi config", sub: true },
+        { href: "configuration.html#env-vars", label: "Environment variables", sub: true },
+        { href: "runs.html", label: "Runs & Logs" },
+        { href: "runs.html#model", label: "The run model", sub: true },
+        { href: "runs.html#run", label: "caasi run", sub: true },
+        { href: "runs.html#logs", label: "caasi logs", sub: true }
+      ]
+    },
+    {
+      title: "Projects",
+      items: [
+        { href: "projects.html", label: "Project workflow" },
+        { href: "projects.html#init", label: "init", sub: true },
+        { href: "projects.html#setup", label: "setup", sub: true },
+        { href: "projects.html#project", label: "project", sub: true },
+        { href: "projects.html#definitions", label: "robot / scene / task", sub: true }
+      ]
+    },
+    {
+      title: "Simulation & Training",
+      items: [
+        { href: "simulation.html", label: "sim & lab" },
+        { href: "simulation.html#experiment", label: "Experiment YAML", sub: true },
+        { href: "simulation.html#sim-run", label: "sim run", sub: true },
+        { href: "simulation.html#sim-control", label: "sim status/check/stop", sub: true },
+        { href: "simulation.html#lab", label: "lab status", sub: true },
+        { href: "training.html", label: "train & benchmark" },
+        { href: "training.html#train", label: "train", sub: true },
+        { href: "training.html#benchmark", label: "benchmark", sub: true }
+      ]
+    },
+    {
+      title: "Data & Review",
+      items: [
+        { href: "data.html", label: "dataset / sensor / vision" },
+        { href: "data.html#dataset", label: "dataset", sub: true },
+        { href: "data.html#sensor", label: "sensor", sub: true },
+        { href: "data.html#vision", label: "vision", sub: true },
+        { href: "review.html", label: "replay & view" },
+        { href: "review.html#replay", label: "replay", sub: true },
+        { href: "review.html#view", label: "view", sub: true }
+      ]
+    },
+    {
+      title: "ROS Ecosystem",
+      items: [
+        { href: "ros.html", label: "ros / nav / moveit / control" },
+        { href: "ros.html#ros", label: "ros", sub: true },
+        { href: "ros.html#nav", label: "nav (Nav2)", sub: true },
+        { href: "ros.html#moveit", label: "moveit (MoveIt 2)", sub: true },
+        { href: "ros.html#control", label: "control (ros2_control)", sub: true }
+      ]
+    },
+    {
+      title: "Advanced",
+      items: [
+        { href: "native.html", label: "native & shell" },
+        { href: "native.html#native", label: "native", sub: true },
+        { href: "native.html#shell", label: "shell", sub: true },
+        { href: "remote.html", label: "remote & container" },
+        { href: "remote.html#remote", label: "remote", sub: true },
+        { href: "remote.html#container", label: "container", sub: true }
+      ]
+    }
+  ];
+
+  function currentFile() {
+    var path = window.location.pathname;
+    var file = path.substring(path.lastIndexOf("/") + 1);
+    return file === "" ? "index.html" : file;
+  }
+
+  function render() {
+    var sidebar = document.getElementById("sidebar");
+    if (!sidebar) return;
+    var here = currentFile();
+    var hash = window.location.hash;
+    var html = "";
+
+    NAV.forEach(function (group) {
+      html += '<div class="nav-group"><div class="nav-title">' + group.title + "</div>";
+      group.items.forEach(function (item) {
+        var file = item.href.split("#")[0];
+        var anchor = item.href.indexOf("#") >= 0 ? item.href.split("#")[1] : "";
+        var active =
+          file === here &&
+          (anchor === "" ? hash === "" || hash === "#" + (item.sub ? "" : anchor) : hash === "#" + anchor);
+        if (file === here && anchor !== "" && hash === "#" + anchor) active = true;
+        var cls = (item.sub ? "sub" : "") + (active ? " active" : "");
+        html += '<a class="' + cls.trim() + '" href="' + item.href + '">' + item.label + "</a>";
+      });
+      html += "</div>";
+    });
+
+    sidebar.innerHTML = html;
+
+    // If only the page (no hash) matches, highlight the top-level entry.
+    if (!hash) {
+      var links = sidebar.querySelectorAll('a:not(.sub)');
+      links.forEach(function (a) {
+        if (a.getAttribute("href").split("#")[0] === here) a.classList.add("active");
+      });
+    }
+  }
+
+  function installToggle() {
+    var toggle = document.getElementById("nav-toggle");
+    if (!toggle) return;
+    toggle.addEventListener("click", function () {
+      document.body.classList.toggle("nav-open");
+    });
+    document.getElementById("sidebar").addEventListener("click", function (e) {
+      if (e.target.tagName === "A") document.body.classList.remove("nav-open");
+    });
+  }
+
+  document.addEventListener("DOMContentLoaded", function () {
+    render();
+    installToggle();
+  });
+})();