roar-cli 0.3.2__tar.gz → 0.3.4__tar.gz

{roar_cli-0.3.2 → roar_cli-0.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: roar-cli
-Version: 0.3.2
+Version: 0.3.4
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Science/Research
@@ -103,7 +103,7 @@ bash scripts/install-dev.sh
 when available) and then builds the Rust tracer binaries
 (`roar-tracer`, `roar-tracer-preload`, `roar-tracer-ebpf`, `roard`,
 `roar-proxy`) and stages them into `roar/bin/`. A bare
-`pip install -e .` does *not* build the tracer binaries because they
+`pip install -e .` does _not_ build the tracer binaries because they
 live in separate cargo crates outside the maturin manifest, so
 `roar run` would fail with "No tracer binary found" until the script
 runs. See [Building from source](#building-from-source) below for
@@ -325,6 +325,16 @@ To register SSH auth with GLaaS:
 2. Sign up at <https://glaas.ai> where you can paste your public key
 3. Run `roar auth test` to verify
 
+### `roar login`
+
+Authenticate with GLaaS and store your global login state for attributed publishing and project access. By default, `roar login` starts a browser/device login flow and can then unlock private or project-scoped publication in repositories that use `roar scope`.
+
+```bash
+roar login
+roar login --force
+roar login --token-file ~/.config/roar/auth.json
+```
+
 ### `roar config`
 
 View or set configuration options.
@@ -337,20 +347,20 @@ roar config set <key> <value>
 
 Run `roar config list` to see all available options with descriptions. Common options:
 
-| Key                            | Default                | Description                             |
-| ------------------------------ | ---------------------- | --------------------------------------- |
-| `output.track_repo_files`      | false                  | Include repo files in provenance        |
-| `output.quiet`                 | false                  | Suppress written files report           |
-| `filters.ignore_system_reads`  | true                   | Ignore /sys, /etc, /sbin reads          |
-| `filters.ignore_package_reads` | true                   | Ignore installed package reads          |
-| `filters.ignore_torch_cache`   | true                   | Ignore torch/triton cache               |
-| `filters.ignore_tmp_files`     | true                   | Ignore /tmp files                       |
-| `glaas.url`                    | <https://api.glaas.ai> | GLaaS server URL                        |
-| `glaas.web_url`                | <https://glaas.ai>     | GLaaS web UI URL                        |
-| `registration.public_by_default` | false                | Default `register`/`put` visibility     |
-| `registration.omit.enabled`    | true                   | Enable secret filtering                 |
-| `hash.primary`                 | blake3                 | Primary hash algorithm                  |
-| `logging.level`                | warning                | Log level (debug, info, warning, error) |
+| Key                              | Default                | Description                             |
+| -------------------------------- | ---------------------- | --------------------------------------- |
+| `output.track_repo_files`        | false                  | Include repo files in provenance        |
+| `output.quiet`                   | false                  | Suppress written files report           |
+| `filters.ignore_system_reads`    | true                   | Ignore /sys, /etc, /sbin reads          |
+| `filters.ignore_package_reads`   | true                   | Ignore installed package reads          |
+| `filters.ignore_torch_cache`     | true                   | Ignore torch/triton cache               |
+| `filters.ignore_tmp_files`       | true                   | Ignore /tmp files                       |
+| `glaas.url`                      | <https://api.glaas.ai> | GLaaS server URL                        |
+| `glaas.web_url`                  | <https://glaas.ai>     | GLaaS web UI URL                        |
+| `registration.public_by_default` | false                  | Default `register`/`put` visibility     |
+| `registration.omit.enabled`      | true                   | Enable secret filtering                 |
+| `hash.primary`                   | blake3                 | Primary hash algorithm                  |
+| `logging.level`                  | warning                | Log level (debug, info, warning, error) |
 
 ### `roar dag`
 
@@ -382,6 +392,18 @@ Display recent job execution history.
 roar log                  # Show recent job history
 ```
 
+### `roar scope`
+
+Show or change the default publication scope for the current repo. Scopes connect lineage from this repo to your personal space or to a specific org/project so later `roar register` and `roar put` commands publish in the right place.
+
+```bash
+roar scope status
+roar scope list
+roar scope use private
+roar scope use acme/foundation-models
+roar scope clear
+```
+
 ### `roar label`
 
 Manage local labels for DAGs (sessions), jobs, and artifacts.
@@ -413,6 +435,17 @@ roar label sync job @2
 roar label sync artifact ./outputs/model.pt --dry-run
 ```
 
+### `roar diff <ref-a> <ref-b>`
+
+Compare the lineage of two artifacts, jobs, steps, or sessions to see what changed in their inputs, parameters, code, environment, or pipeline structure. Use it to identify the likely root cause when two outputs differ.
+
+```bash
+roar diff ./model.pkl ./model-v2.pkl
+roar diff @5 @7 --format dag
+roar diff session:current session:<hash>
+roar diff @5 @7 --json
+```
+
 **Entity targets:**
 
 - `dag`: `current` or a session hash prefix

{roar_cli-0.3.2 → roar_cli-0.3.4}/README.md

@@ -54,7 +54,7 @@ bash scripts/install-dev.sh
 when available) and then builds the Rust tracer binaries
 (`roar-tracer`, `roar-tracer-preload`, `roar-tracer-ebpf`, `roard`,
 `roar-proxy`) and stages them into `roar/bin/`. A bare
-`pip install -e .` does *not* build the tracer binaries because they
+`pip install -e .` does _not_ build the tracer binaries because they
 live in separate cargo crates outside the maturin manifest, so
 `roar run` would fail with "No tracer binary found" until the script
 runs. See [Building from source](#building-from-source) below for
@@ -276,6 +276,16 @@ To register SSH auth with GLaaS:
 2. Sign up at <https://glaas.ai> where you can paste your public key
 3. Run `roar auth test` to verify
 
+### `roar login`
+
+Authenticate with GLaaS and store your global login state for attributed publishing and project access. By default, `roar login` starts a browser/device login flow and can then unlock private or project-scoped publication in repositories that use `roar scope`.
+
+```bash
+roar login
+roar login --force
+roar login --token-file ~/.config/roar/auth.json
+```
+
 ### `roar config`
 
 View or set configuration options.
@@ -288,20 +298,20 @@ roar config set <key> <value>
 
 Run `roar config list` to see all available options with descriptions. Common options:
 
-| Key                            | Default                | Description                             |
-| ------------------------------ | ---------------------- | --------------------------------------- |
-| `output.track_repo_files`      | false                  | Include repo files in provenance        |
-| `output.quiet`                 | false                  | Suppress written files report           |
-| `filters.ignore_system_reads`  | true                   | Ignore /sys, /etc, /sbin reads          |
-| `filters.ignore_package_reads` | true                   | Ignore installed package reads          |
-| `filters.ignore_torch_cache`   | true                   | Ignore torch/triton cache               |
-| `filters.ignore_tmp_files`     | true                   | Ignore /tmp files                       |
-| `glaas.url`                    | <https://api.glaas.ai> | GLaaS server URL                        |
-| `glaas.web_url`                | <https://glaas.ai>     | GLaaS web UI URL                        |
-| `registration.public_by_default` | false                | Default `register`/`put` visibility     |
-| `registration.omit.enabled`    | true                   | Enable secret filtering                 |
-| `hash.primary`                 | blake3                 | Primary hash algorithm                  |
-| `logging.level`                | warning                | Log level (debug, info, warning, error) |
+| Key                              | Default                | Description                             |
+| -------------------------------- | ---------------------- | --------------------------------------- |
+| `output.track_repo_files`        | false                  | Include repo files in provenance        |
+| `output.quiet`                   | false                  | Suppress written files report           |
+| `filters.ignore_system_reads`    | true                   | Ignore /sys, /etc, /sbin reads          |
+| `filters.ignore_package_reads`   | true                   | Ignore installed package reads          |
+| `filters.ignore_torch_cache`     | true                   | Ignore torch/triton cache               |
+| `filters.ignore_tmp_files`       | true                   | Ignore /tmp files                       |
+| `glaas.url`                      | <https://api.glaas.ai> | GLaaS server URL                        |
+| `glaas.web_url`                  | <https://glaas.ai>     | GLaaS web UI URL                        |
+| `registration.public_by_default` | false                  | Default `register`/`put` visibility     |
+| `registration.omit.enabled`      | true                   | Enable secret filtering                 |
+| `hash.primary`                   | blake3                 | Primary hash algorithm                  |
+| `logging.level`                  | warning                | Log level (debug, info, warning, error) |
 
 ### `roar dag`
 
@@ -333,6 +343,18 @@ Display recent job execution history.
 roar log                  # Show recent job history
 ```
 
+### `roar scope`
+
+Show or change the default publication scope for the current repo. Scopes connect lineage from this repo to your personal space or to a specific org/project so later `roar register` and `roar put` commands publish in the right place.
+
+```bash
+roar scope status
+roar scope list
+roar scope use private
+roar scope use acme/foundation-models
+roar scope clear
+```
+
 ### `roar label`
 
 Manage local labels for DAGs (sessions), jobs, and artifacts.
@@ -364,6 +386,17 @@ roar label sync job @2
 roar label sync artifact ./outputs/model.pt --dry-run
 ```
 
+### `roar diff <ref-a> <ref-b>`
+
+Compare the lineage of two artifacts, jobs, steps, or sessions to see what changed in their inputs, parameters, code, environment, or pipeline structure. Use it to identify the likely root cause when two outputs differ.
+
+```bash
+roar diff ./model.pkl ./model-v2.pkl
+roar diff @5 @7 --format dag
+roar diff session:current session:<hash>
+roar diff @5 @7 --json
+```
+
 **Entity targets:**
 
 - `dag`: `current` or a session hash prefix

{roar_cli-0.3.2 → roar_cli-0.3.4}/pyproject.toml

@@ -1,10 +1,11 @@
+
 [build-system]
 requires = ["maturin>=1.11.5,<2.0"]
 build-backend = "maturin"
 
 [project]
 name = "roar-cli"
-version = "0.3.2"
+version = "0.3.4"
 description = "Reproducibility and provenance tracker for ML training pipelines"
 authors = [
     { name="TReqs Team", email="info@treqs.ai" }

{roar_cli-0.3.2 → roar_cli-0.3.4}/roar/analyzers/experiment_trackers.py

@@ -30,9 +30,19 @@ class ExperimentTrackerAnalyzer(Analyzer):
         ".neptune/*",
     ]
 
+    @staticmethod
+    def _all_written_files(context: dict) -> list:
+        """Return unfiltered written files so tracker detection works even
+        when tracker directories are in ignore_paths."""
+        tracer_data = context.get("tracer_data", {})
+        unfiltered = tracer_data.get("written_files", [])
+        if unfiltered:
+            return unfiltered
+        return context.get("written_files", [])
+
     def relevant(self, context: dict) -> bool:
         """Check if any tracker directories were written to."""
-        written = context.get("written_files", [])
+        written = self._all_written_files(context)
         for path in written:
             for _tracker, patterns in self.TRACKER_PATTERNS.items():
                 if any(p in path for p in patterns):
@@ -40,7 +50,7 @@ class ExperimentTrackerAnalyzer(Analyzer):
         return False
 
     def analyze(self, context: dict) -> dict | None:
-        written = context.get("written_files", [])
+        written = self._all_written_files(context)
         env = context.get("env", {})
 
         results: dict[str, Any] = {
@@ -126,7 +136,12 @@ class ExperimentTrackerAnalyzer(Analyzer):
                     run_dir = None
 
             if run_dir and run_dir.exists():
-                # Try to read run metadata
+                # Extract run_id from directory name: run-YYYYMMDD_HHMMSS-<run_id>
+                dir_match = re.match(r"run-\d{8}_\d{6}-(.+)$", run_dir.name)
+                if dir_match:
+                    info["run_id"] = dir_match.group(1)
+
+                # Try to read run metadata for additional fields
                 run_metadata = run_dir / "files" / "wandb-metadata.json"
                 if run_metadata.exists():
                     try:
@@ -135,34 +150,51 @@ class ExperimentTrackerAnalyzer(Analyzer):
                         info["run_id"] = metadata.get("run_id")
                         info["project"] = metadata.get("project")
                         info["entity"] = metadata.get("entity")
-                        if all(k in info for k in ["entity", "project", "run_id"]):
+                        if info.get("entity") and info.get("project") and info.get("run_id"):
                             info["url"] = (
                                 f"https://wandb.ai/{info['entity']}/{info['project']}/runs/{info['run_id']}"
                             )
                     except (OSError, json.JSONDecodeError):
                         pass
 
-                # Also check wandb-summary.json for run info
+                # Parse entity/project/run_id from debug.log.
+                # wandb writes "finishing run <entity>/<project>/<run_id>"
+                # to this file on every online run.
+                debug_log = run_dir / "logs" / "debug.log"
+                if debug_log.exists():
+                    try:
+                        text = debug_log.read_text(errors="replace")
+                        finish_match = re.search(r"finishing run (\S+)/(\S+)/(\S+)", text)
+                        if finish_match:
+                            info["entity"] = finish_match.group(1)
+                            info["project"] = finish_match.group(2)
+                            info["run_id"] = finish_match.group(3)
+                    except OSError:
+                        pass
+
+                # Check wandb-summary.json for runtime
                 summary_file = run_dir / "files" / "wandb-summary.json"
-                if summary_file.exists() and "run_id" not in info:
+                if summary_file.exists():
                     try:
                         with open(summary_file) as f:
                             summary = json.load(f)
-                        # Summary might have _wandb key with run info
                         wandb_info = summary.get("_wandb", {})
                         if "runtime" in wandb_info:
                             info["runtime_seconds"] = wandb_info["runtime"]
                     except (OSError, json.JSONDecodeError):
                         pass
 
-        # Fall back to env vars
-        if "url" not in info:
-            entity = env.get("WANDB_ENTITY", "")
-            project = env.get("WANDB_PROJECT", "")
-            if entity and project:
-                info["entity"] = entity
-                info["project"] = project
-                # Can't get run_id from env alone
+        # Fall back to env vars if entity/project still missing
+        if not info.get("entity"):
+            info["entity"] = env.get("WANDB_ENTITY", "")
+        if not info.get("project"):
+            info["project"] = env.get("WANDB_PROJECT", "")
+
+        # Build URL if we have all three components
+        if info.get("entity") and info.get("project") and info.get("run_id"):
+            info["url"] = (
+                f"https://wandb.ai/{info['entity']}/{info['project']}/runs/{info['run_id']}"
+            )
 
         return info if len(info) > 1 else None
 

roar_cli-0.3.4/roar/application/composite/__init__.py

@@ -0,0 +1,37 @@
+"""Composite artifacts v2 — qualifying hash + structural detection.
+
+The host-agnostic ``sha256-tree`` qualifying hash (the dataset GLaaS key) and the
+declared/structural detectors that decide what a composite is and which files carry
+its identity. Composites form at the boundaries (``get``/``put``/``register``), not
+inside ``roar run``.
+
+This package is additive; it does not yet replace the legacy heuristic composite
+path in ``roar.application.publish``.
+"""
+
+from .canonical import normalize_relpath, preimage
+from .detect import Detection, detect, detect_nested
+from .qualifying import (
+    Composite,
+    Leaf,
+    blake3_tree,
+    build,
+    build_nested,
+    sha256_tree,
+    tree,
+)
+
+__all__ = [
+    "Composite",
+    "Detection",
+    "Leaf",
+    "blake3_tree",
+    "build",
+    "build_nested",
+    "detect",
+    "detect_nested",
+    "normalize_relpath",
+    "preimage",
+    "sha256_tree",
+    "tree",
+]

roar_cli-0.3.4/roar/application/composite/canonical.py

@@ -0,0 +1,71 @@
+"""Canonical preimage for the qualifying composite hash (``sha256-tree``).
+
+The qualifying hash is roar's host-agnostic, content-addressable dataset key: a
+``sha256`` over a canonical, injective serialization of a composite's leaves. It is
+path-sensitive (moving a file changes the key), content-only (no host metadata
+enters), and locally computable, so the key registered by ``roar put`` equals the
+key produced by ``roar get`` for the same bytes and layout.
+
+This is distinct from roar's internal ``blake3`` file hashing: blake3 stays the
+fast hash for primitive file lineage; ``sha256-tree`` is the *dataset* key.
+
+Frozen decisions (any change is a version bump of the domain tag):
+  - leaf = (normalized_posix_relpath, "<component-algo>:<hexdigest>")
+  - component-algo is always ``sha256`` for a qualifying leaf; nested composites
+    use ``sha256-tree``
+  - leaves are sorted by the UTF-8 bytes of their normalized relpath
+  - size and mode do not enter the preimage
+  - NUL separates path from digest; newline terminates each leaf line
+  - a domain-separation prefix prevents cross-protocol collisions
+"""
+
+from __future__ import annotations
+
+DOMAIN_V1 = b"roar:sha256-tree:v1\n"
+QUALIFYING_ALGO = "sha256"
+NESTED_ALGO = "sha256-tree"
+
+
+def normalize_relpath(path: str) -> str:
+    """Normalize a relative path to canonical POSIX form.
+
+    Backslashes become forward slashes, a leading ``./`` and leading slashes are
+    stripped. ``..`` components are rejected (a leaf must stay within its composite
+    root) and an empty result is an error.
+    """
+    p = path.replace("\\", "/")
+    while p.startswith("./"):
+        p = p[2:]
+    p = p.lstrip("/")
+    if not p:
+        raise ValueError("empty relative path is not a valid leaf key")
+    if any(segment == ".." for segment in p.split("/")):
+        raise ValueError(f"path escapes composite root: {path!r}")
+    return p
+
+
+def leaf_line(relpath: str, algo: str, hexdigest: str) -> bytes:
+    """Serialize one leaf to its canonical line (relpath already normalized)."""
+    if not hexdigest:
+        raise ValueError(f"leaf {relpath!r} has empty digest")
+    return relpath.encode("utf-8") + b"\x00" + f"{algo}:{hexdigest.lower()}".encode() + b"\n"
+
+
+def preimage(leaves: list[tuple[str, str, str]], *, domain: bytes = DOMAIN_V1) -> bytes:
+    """Build the canonical preimage from ``(relpath, algo, hexdigest)`` triples.
+
+    Relpaths are normalized and the set is sorted by normalized relpath bytes.
+    Duplicate normalized relpaths are rejected.
+    """
+    normalized: dict[str, tuple[str, str]] = {}
+    for relpath, algo, hexdigest in leaves:
+        key = normalize_relpath(relpath)
+        if key in normalized:
+            raise ValueError(f"duplicate leaf path in composite: {key!r}")
+        normalized[key] = (algo, hexdigest)
+
+    out = bytearray(domain)
+    for key in sorted(normalized, key=lambda k: k.encode("utf-8")):
+        algo, hexdigest = normalized[key]
+        out += leaf_line(key, algo, hexdigest)
+    return bytes(out)

roar_cli-0.3.4/roar/application/composite/detect.py

@@ -0,0 +1,120 @@
+"""Structural dataset detection — declared/structural, never scored.
+
+Each detector is a pure function of a file listing (relpaths) and returns a
+:class:`Detection` naming the structural ``kind``, which files are identity-bearing
+(``data``/``meta``) versus excluded ``boilerplate``, and any nested sub-datasets.
+
+This replaces the role of the confidence scorer: a format's on-disk structure
+either declares it or it does not. There are no thresholds or weights. When nothing
+matches, ``kind`` is ``"unstructured"`` and the caller decides (an explicit
+``roar put --dataset`` may still declare it; an unstructured pile falls to the
+download size-gate when imported from a host).
+"""
+
+from __future__ import annotations
+
+import posixpath
+from dataclasses import dataclass
+
+# Repo/git boilerplate present everywhere — never data, never identity-bearing.
+#
+# IDENTITY CONTRACT: this set is excluded from every composite digest (both the get
+# sha256-tree and the put/register blake3-tree paths derive their exclusions from
+# `detect().boilerplate`). It is therefore part of the `roar:{combiner}-tree:v1` digest
+# domain: changing a member silently re-digests existing datasets and breaks the
+# put-export <-> get-import identity guarantee. Any edit here MUST bump the tree domain
+# version (v1 -> v2) in `canonical.py` and `composite_builder.py`.
+BOILERPLATE = frozenset({".gitattributes", ".gitignore", "README.md", "LICENSE", ".DS_Store"})
+
+
+@dataclass(frozen=True)
+class Detection:
+    kind: str
+    data: list[str]  # identity-bearing data files
+    meta: list[str]  # identity-bearing, format-declared metadata
+    boilerplate: list[str]  # excluded
+    nested: list[str]  # subdir prefixes that are themselves structural datasets
+
+
+def _split_boilerplate(paths: list[str]) -> tuple[list[str], list[str]]:
+    boiler = [p for p in paths if posixpath.basename(p) in BOILERPLATE]
+    rest = [p for p in paths if posixpath.basename(p) not in BOILERPLATE]
+    return rest, boiler
+
+
+def _has(paths: set[str], name: str) -> bool:
+    return any(p == name or p.endswith("/" + name) for p in paths)
+
+
+def detect(paths: list[str]) -> Detection:
+    """Detect the structural kind of a flat list of relpaths (one composite root)."""
+    rest, boiler = _split_boilerplate(paths)
+    pset = set(rest)
+
+    # --- LeRobot v2.x/v3.x: meta/info.json + data/chunk-*/*.parquet ---
+    if _has(pset, "meta/info.json") and any(p.startswith("data/chunk-") for p in rest):
+        meta = sorted(p for p in rest if p.startswith("meta/"))
+        data = sorted(p for p in rest if p.startswith("data/") or p.startswith("videos/"))
+        other = sorted(set(rest) - set(meta) - set(data))
+        return Detection("lerobot", data, meta, boiler + other, [])
+
+    # --- Zarr store: v2 (.zarray/.zgroup) or v3 (zarr.json) ---
+    if any(posixpath.basename(p) in (".zarray", ".zgroup", "zarr.json") for p in rest):
+        return Detection("zarr", sorted(rest), [], boiler, [])
+
+    # --- Lance dataset: <name>.lance/ with _versions/ + data/ ---
+    if any(p.endswith(".lance") or ".lance/" in ("/" + p) for p in rest) or _has(pset, "_versions"):
+        return Detection("lance", sorted(rest), [], boiler, [])
+
+    # --- TFDS / RLDS: dataset_info.json + features.json (+ *.tfrecord-*) ---
+    if _has(pset, "dataset_info.json") and _has(pset, "features.json"):
+        meta = sorted(
+            p for p in rest if posixpath.basename(p) in ("dataset_info.json", "features.json")
+        )
+        data = sorted(set(rest) - set(meta))
+        return Detection("rlds", data, meta, boiler, [])
+
+    # --- WebDataset: a set of .tar shards ---
+    tars = [p for p in rest if p.endswith(".tar")]
+    if len(tars) >= 2 and len(tars) == len(rest):
+        return Detection("webdataset", sorted(tars), [], boiler, [])
+
+    # --- Flat parquet shards (climbmix / esm2 style) ---
+    parquets = [p for p in rest if p.endswith(".parquet")]
+    if len(parquets) >= 2:
+        excluded = boiler + sorted(set(rest) - set(parquets))
+        return Detection("parquet-shards", sorted(parquets), [], excluded, [])
+
+    return Detection("unstructured", sorted(rest), [], boiler, [])
+
+
+# Formats that declare themselves with a manifest/layout file are nestable as
+# sub-datasets. Loose-shard formats (parquet-shards, webdataset) are deliberately
+# excluded: a directory of partition dirs full of parquet shards (Hive-style
+# ``date=.../part-*.parquet``) is ONE partitioned dataset, not nested sub-datasets,
+# and is indistinguishable from a true container without a per-child manifest.
+_NESTABLE_KINDS = frozenset({"lerobot", "zarr", "lance", "rlds"})
+
+
+def detect_nested(paths: list[str]) -> Detection:
+    """Detect a *container* of sub-datasets (the nesting case).
+
+    Groups paths by top-level directory; if at least two top dirs each independently
+    detect as a *manifest-bearing* structural dataset, returns kind ``"nested"`` with
+    those dirs as nested composites. Otherwise falls back to flat :func:`detect` —
+    so partitioned single datasets and loose-shard splits stay one flat composite.
+    """
+    rest, boiler = _split_boilerplate(paths)
+    by_top: dict[str, list[str]] = {}
+    for p in rest:
+        if "/" in p:
+            top, sub = p.split("/", 1)
+            by_top.setdefault(top, []).append(sub)
+
+    structural_children = [
+        top for top, subs in by_top.items() if detect(subs).kind in _NESTABLE_KINDS
+    ]
+
+    if len(structural_children) >= 2:
+        return Detection("nested", [], [], boiler, sorted(structural_children))
+    return detect(paths)