"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/
Python
fix(cloudanalyzer): address harness review (backend guard, docs, README, e2e skips)
Ryohei Sasakia75b174c08b4
diff --git a/README.md b/README.mdindex 1a54e30c1..21916eb92 100644--- a/README.md+++ b/README.md@@ -918,6 +918,13 @@ Each application received complete, production-ready CLI interfaces — not demo<td align="center">✅ 40</td></tr><tr>+<td align="center"><strong>☁️ <a href="cloudanalyzer/agent-harness/">CloudAnalyzer</a></strong></td>+<td>Point cloud / trajectory QA</td>+<td><code>cli-anything-cloudanalyzer</code></td>+<td>CloudAnalyzer (Python API)</td>+<td align="center">✅ 14</td>+</tr>+<tr><td align="center" colspan="4"><strong>Total</strong></td><td align="center"><strong>✅ 2,045</strong></td></tr>@@ -960,8 +967,9 @@ ollama 98 passed ✅ (87 unit + 11 e2e)sketch 19 passed ✅ (19 jest, Node.js)renderdoc 59 passed ✅ (45 unit + 14 e2e)cloudcompare 88 passed ✅ (49 unit + 39 e2e)+cloudanalyzer 14 passed ✅ (7 unit + 7 e2e)──────────────────────────────────────────────────────────────────────────────-TOTAL 2,005 passed ✅ 100% pass rate+TOTAL 2,019 passed ✅ 100% pass rate```---@@ -1036,7 +1044,8 @@ cli-anything/├── 🔬 renderdoc/agent-harness/ # RenderDoc CLI (59 tests)├── 🎬 videocaptioner/agent-harness/ # VideoCaptioner CLI (26 tests)├── ☁️ cloudcompare/agent-harness/ # CloudCompare CLI (88 tests)-└── 🔍 exa/agent-harness/ # Exa CLI (40 tests)+├── 🔍 exa/agent-harness/ # Exa CLI (40 tests)+└── ⛅ cloudanalyzer/agent-harness/ # CloudAnalyzer CLI (14 tests)```Each `agent-harness/` contains an installable Python package under `cli_anything.<software>/` with Click CLI, core modules, utils (including `repl_skin.py` and backend wrapper), and comprehensive tests.diff --git a/cloudanalyzer/agent-harness/CLOUDANALYZER.md b/cloudanalyzer/agent-harness/CLOUDANALYZER.mdindex 87c85f5b3..7cd10a19f 100644--- a/cloudanalyzer/agent-harness/CLOUDANALYZER.md+++ b/cloudanalyzer/agent-harness/CLOUDANALYZER.md@@ -17,24 +17,30 @@ Since CloudAnalyzer is a Python package, the backend (`ca_backend.py`) importsCloudAnalyzer functions directly — no subprocess invocation needed. This makesthe harness faster and more reliable than subprocess-based approaches.+Call paths go through `ca_backend`: handlers in `cloudanalyzer_cli.py` do not+import `ca.*` directly.+## Command Mapping| Harness Group | CloudAnalyzer Command(s) ||---|---|-| evaluate run | ca evaluate |-| evaluate compare | ca compare |-| evaluate diff | ca diff |-| evaluate ground | ca ground-evaluate |-| trajectory evaluate | ca traj-evaluate |-| trajectory batch | ca traj-batch |-| check run | ca check |-| check init | ca init-check |-| baseline decision | ca baseline-decision |-| baseline save | ca baseline-save |-| baseline list | ca baseline-list |-| process downsample | ca downsample |-| process split | ca split |-| info show | ca info |+| evaluate run | ca.evaluate.evaluate |+| evaluate compare | ca.compare.run_compare |+| evaluate diff | ca.diff.run_diff |+| evaluate batch | ca.batch.batch_evaluate |+| evaluate ground | ca.ground_evaluate.evaluate_ground_segmentation |+| evaluate pipeline | ca.pipeline.run_pipeline |+| trajectory evaluate | ca.trajectory.evaluate_trajectory |+| trajectory batch | ca.batch.trajectory_batch_evaluate |+| trajectory run-evaluate | ca.run_evaluate.evaluate_run |+| check run | ca.core.run_check_suite |+| check init | ca.core.render_check_scaffold |+| baseline decision | ca.core.summarize_baseline_evolution |+| baseline save / list | ca.baseline_history.* |+| process * | ca.downsample / split / sample / filter / merge / convert |+| inspect view | ca.view.view |+| inspect web / web-export | ca.web.serve / export_static_bundle |+| info show | ca.info.get_info |## State Modeldiff --git a/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/README.md b/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/README.mdindex 42107ae6b..998af98b7 100644--- a/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/README.md+++ b/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/README.md@@ -35,7 +35,7 @@ CloudAnalyzer is already CLI-first, but this harness adds:- **REPL mode** for interactive exploration- **Project/session management** with operation history and undo- **SKILL.md** for agent auto-discovery via CLI-Anything ecosystem-- **Unified Click interface** grouping 32 commands into logical groups+- **Unified Click interface** grouping 27 commands into logical groups## Commands@@ -50,7 +50,7 @@ See [SKILL.md](cli_anything/cloudanalyzer/skills/SKILL.md) for the full command| process | 6 | Downsample, split, filter, merge, convert || inspect | 3 | Visualization and browser inspection || info | 2 | Metadata and version |-| session | 3 | Project and session management |+| session | 2 | Project and session management |## Requirementsdiff --git a/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/cloudanalyzer_cli.py b/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/cloudanalyzer_cli.pyindex 13aade69f..698b17ae0 100644--- a/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/cloudanalyzer_cli.py+++ b/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/cloudanalyzer_cli.py@@ -191,8 +191,9 @@ def evaluate_ground(def evaluate_batch(ctx: click.Context, directory: str, reference: str, min_auc: Optional[float], max_chamfer: Optional[float]) -> None:"""Batch evaluation of multiple point clouds."""try:- from ca.batch import batch_evaluate- result = batch_evaluate(directory, reference, min_auc=min_auc, max_chamfer=max_chamfer)+ result = ca_backend.batch_evaluate(+ directory, reference, min_auc=min_auc, max_chamfer=max_chamfer,+ )_out(ctx, result)except Exception as e:_error(str(e), ctx.obj.get("json", False))@@ -204,13 +205,19 @@ def evaluate_batch(ctx: click.Context, directory: str, reference: str, min_auc:@click.argument("reference")@click.option("-o", "--output", required=True)@click.option("-v", "--voxel-size", type=float, default=0.05)[email protected]("--filter/--no-filter", "apply_filter", default=False)@click.pass_context-def evaluate_pipeline(ctx: click.Context, input_path: str, reference: str, output: str, voxel_size: float, apply_filter: bool) -> None:+def evaluate_pipeline(+ ctx: click.Context,+ input_path: str,+ reference: str,+ output: str,+ voxel_size: float,+) -> None:"""Filter, downsample, evaluate in one command."""try:- from ca.pipeline import run_pipeline- result = run_pipeline(input_path, reference, output, voxel_size=voxel_size, apply_filter=apply_filter)+ result = ca_backend.run_pipeline(+ input_path, reference, output, voxel_size=voxel_size,+ )_out(ctx, result)except Exception as e:_error(str(e), ctx.obj.get("json", False))@@ -236,14 +243,34 @@ def trajectory(ctx: click.Context) -> None:@click.option("--max-longitudinal", type=float, default=None)@click.option("--align-origin", is_flag=True)@click.option("--align-rigid", is_flag=True)[email protected]("--report", default=None, help="Write trajectory report")@click.pass_contextdef trajectory_evaluate(- ctx: click.Context, estimated: str, reference: str, **kwargs,+ ctx: click.Context,+ estimated: str,+ reference: str,+ max_ate: Optional[float],+ max_rpe: Optional[float],+ max_drift: Optional[float],+ min_coverage: Optional[float],+ max_lateral: Optional[float],+ max_longitudinal: Optional[float],+ align_origin: bool,+ align_rigid: bool,) -> None:"""Evaluate estimated vs reference trajectory."""try:- result = ca_backend.evaluate_trajectory(estimated, reference, **kwargs)+ result = ca_backend.evaluate_trajectory(+ estimated,+ reference,+ max_ate=max_ate,+ max_rpe=max_rpe,+ max_drift=max_drift,+ min_coverage=min_coverage,+ max_lateral=max_lateral,+ max_longitudinal=max_longitudinal,+ align_origin=align_origin,+ align_rigid=align_rigid,+ )_out(ctx, result)gate = result.get("quality_gate")if gate and not gate["passed"]:@@ -261,11 +288,25 @@ def trajectory_evaluate(@click.option("--max-drift", type=float, default=None)@click.option("--min-coverage", type=float, default=None)@click.pass_context-def trajectory_batch(ctx: click.Context, directory: str, reference_dir: str, **kwargs) -> None:+def trajectory_batch(+ ctx: click.Context,+ directory: str,+ reference_dir: str,+ max_ate: Optional[float],+ max_rpe: Optional[float],+ max_drift: Optional[float],+ min_coverage: Optional[float],+) -> None:"""Batch trajectory evaluation."""try:- from ca.batch import trajectory_batch_evaluate- result = trajectory_batch_evaluate(directory, reference_dir, **kwargs)+ result = ca_backend.trajectory_batch_evaluate(+ directory,+ reference_dir,+ max_ate=max_ate,+ max_rpe=max_rpe,+ max_drift=max_drift,+ min_coverage=min_coverage,+ )_out(ctx, result)except Exception as e:_error(str(e), ctx.obj.get("json", False))@@ -279,13 +320,26 @@ def trajectory_batch(ctx: click.Context, directory: str, reference_dir: str, **k@click.argument("trajectory_reference")@click.option("--min-auc", type=float, default=None)@click.option("--max-ate", type=float, default=None)[email protected]("--report", default=None)@click.pass_context-def trajectory_run_evaluate(ctx: click.Context, map_path: str, map_reference: str, trajectory_path: str, trajectory_reference: str, **kwargs) -> None:+def trajectory_run_evaluate(+ ctx: click.Context,+ map_path: str,+ map_reference: str,+ trajectory_path: str,+ trajectory_reference: str,+ min_auc: Optional[float],+ max_ate: Optional[float],+) -> None:"""Integrated map + trajectory evaluation."""try:- from ca.run_evaluate import run_evaluate- result = run_evaluate(map_path, map_reference, trajectory_path, trajectory_reference, **kwargs)+ result = ca_backend.evaluate_run(+ map_path,+ map_reference,+ trajectory_path,+ trajectory_reference,+ min_auc=min_auc,+ max_ate=max_ate,+ )_out(ctx, result)except Exception as e:_error(str(e), ctx.obj.get("json", False))@@ -459,8 +513,7 @@ def process_split(ctx: click.Context, input_path: str, output_dir: str, grid_sizdef process_sample(ctx: click.Context, input_path: str, output: str, num_points: int) -> None:"""Random point sampling."""try:- from ca.sample import random_sample- result = random_sample(input_path, output, num_points)+ result = ca_backend.random_sample(input_path, output, num_points)_out(ctx, result)except Exception as e:_error(str(e), ctx.obj.get("json", False))@@ -476,8 +529,9 @@ def process_sample(ctx: click.Context, input_path: str, output: str, num_points:def process_filter(ctx: click.Context, input_path: str, output: str, nb_neighbors: int, std_ratio: float) -> None:"""Statistical outlier removal."""try:- from ca.filter import filter_outliers- result = filter_outliers(input_path, output, nb_neighbors=nb_neighbors, std_ratio=std_ratio)+ result = ca_backend.filter_outliers(+ input_path, output, nb_neighbors=nb_neighbors, std_ratio=std_ratio,+ )_out(ctx, result)except Exception as e:_error(str(e), ctx.obj.get("json", False))@@ -491,8 +545,7 @@ def process_filter(ctx: click.Context, input_path: str, output: str, nb_neighbordef process_merge(ctx: click.Context, inputs: tuple[str, ...], output: str) -> None:"""Merge multiple point clouds."""try:- from ca.merge import merge- result = merge(list(inputs), output)+ result = ca_backend.merge(list(inputs), output)_out(ctx, result)except Exception as e:_error(str(e), ctx.obj.get("json", False))@@ -506,8 +559,7 @@ def process_merge(ctx: click.Context, inputs: tuple[str, ...], output: str) -> Ndef process_convert(ctx: click.Context, input_path: str, output: str) -> None:"""Convert between point cloud formats."""try:- from ca.convert import convert- result = convert(input_path, output)+ result = ca_backend.convert(input_path, output)_out(ctx, result)except Exception as e:_error(str(e), ctx.obj.get("json", False))@@ -528,8 +580,7 @@ def inspect(ctx: click.Context) -> None:def inspect_view(ctx: click.Context, path: str) -> None:"""Open a point cloud viewer."""try:- from ca.view import view- view(path)+ ca_backend.view_point_cloud(path)except Exception as e:_error(str(e), ctx.obj.get("json", False))ctx.exit(1)@@ -545,8 +596,13 @@ def inspect_view(ctx: click.Context, path: str) -> None:def inspect_web(ctx: click.Context, source: str, reference: Optional[str], heatmap: bool, trajectory: Optional[str], port: int) -> None:"""Interactive browser inspection."""try:- from ca.web import launch_web- launch_web(source, reference=reference, heatmap=heatmap, trajectory=trajectory, port=port)+ ca_backend.web_serve(+ source,+ reference,+ port=port,+ heatmap=heatmap,+ trajectory=trajectory,+ )except Exception as e:_error(str(e), ctx.obj.get("json", False))ctx.exit(1)@@ -560,8 +616,7 @@ def inspect_web(ctx: click.Context, source: str, reference: Optional[str], heatmdef inspect_web_export(ctx: click.Context, source: str, reference: Optional[str], output: str) -> None:"""Export a static HTML inspection bundle."""try:- from ca.web import export_web- result = export_web(source, reference=reference, output_dir=output)+ result = ca_backend.web_export_bundle(source, reference, output)_out(ctx, result)except Exception as e:_error(str(e), ctx.obj.get("json", False))diff --git a/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/skills/SKILL.md b/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/skills/SKILL.mdindex 0f9091c4a..048518439 100644--- a/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/skills/SKILL.md+++ b/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/skills/SKILL.md@@ -1,6 +1,6 @@---name: "cli-anything-cloudanalyzer"-description: "Command-line interface for CloudAnalyzer — Agent-friendly harness for CloudAnalyzer, a QA platform for mapping, localization, and perception outputs. Supports 32 commands across 8 groups: point cloud evaluation, trajectory evaluation, ground segmentation QA, config-driven quality gates, baseline evolution, processing, visualization, and interactive REPL."+description: "Command-line interface for CloudAnalyzer — Agent-friendly harness for CloudAnalyzer, a QA platform for mapping, localization, and perception outputs. Supports 27 commands across 8 groups: point cloud evaluation, trajectory evaluation, ground segmentation QA, config-driven quality gates, baseline evolution, processing, visualization, and interactive REPL."---# cli-anything-cloudanalyzer@@ -51,7 +51,7 @@ Compare two point clouds with optional registration.cli-anything-cloudanalyzer evaluate compare src.pcd tgt.pcd --register gicp```-Options: `--register TEXT` (icp/gicp/none), `--report TEXT`+Options: `--register TEXT` (icp/gicp/none)#### evaluate diffQuick distance statistics between two point clouds.@@ -87,7 +87,7 @@ cli-anything-cloudanalyzer evaluate pipeline input.pcd reference.pcd -o output.p----### 2. trajectory — Trajectory Evaluation (4 commands)+### 2. trajectory — Trajectory Evaluation (3 commands)#### trajectory evaluateEvaluate estimated vs reference trajectory (ATE, RPE, drift, lateral, longitudinal).@@ -96,7 +96,7 @@ Evaluate estimated vs reference trajectory (ATE, RPE, drift, lateral, longitudincli-anything-cloudanalyzer --json trajectory evaluate est.csv gt.csv --max-ate 0.5 --max-lateral 0.3```-Options: `--max-ate FLOAT`, `--max-rpe FLOAT`, `--max-drift FLOAT`, `--min-coverage FLOAT`, `--max-lateral FLOAT`, `--max-longitudinal FLOAT`, `--align-origin`, `--align-rigid`, `--report TEXT`+Options: `--max-ate FLOAT`, `--max-rpe FLOAT`, `--max-drift FLOAT`, `--min-coverage FLOAT`, `--max-lateral FLOAT`, `--max-longitudinal FLOAT`, `--align-origin`, `--align-rigid`#### trajectory batchBatch trajectory evaluation.@@ -112,12 +112,7 @@ Integrated map + trajectory evaluation.cli-anything-cloudanalyzer trajectory run-evaluate map.pcd map_ref.pcd traj.csv traj_ref.csv```-#### trajectory run-batch-Combined batch QA for map + trajectory.--```bash-cli-anything-cloudanalyzer trajectory run-batch maps/ --map-reference-dir refs/ --trajectory-dir trajs/ --trajectory-reference-dir traj_refs/-```+Options: `--min-auc FLOAT`, `--max-ate FLOAT`---@@ -257,9 +252,21 @@ Show CloudAnalyzer version.----### 8. session — Session Management (3 commands)+### 8. session — Session Management (2 commands)++#### session new+Create a new harness project JSON file.++```bash+cli-anything-cloudanalyzer session new -o project.json -n my-run+```++#### session history+Show recent operations for the project given with `-p` / `--project`.-#### session new / session history / session save+```bash+cli-anything-cloudanalyzer --project project.json session history --last 20+```---diff --git a/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/tests/test_full_e2e.py b/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/tests/test_full_e2e.pyindex 3efd6a4a9..86b4c9f0b 100644--- a/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/tests/test_full_e2e.py+++ b/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/tests/test_full_e2e.py@@ -7,6 +7,13 @@ import pytestfrom click.testing import CliRunnerfrom cli_anything.cloudanalyzer.cloudanalyzer_cli import cli+from cli_anything.cloudanalyzer.utils import ca_backend+++requires_cloudanalyzer = pytest.mark.skipif (+ not ca_backend.is_available(),+ reason="CloudAnalyzer (import ca) is not installed",+)@pytest.fixture@@ -39,6 +46,7 @@ class TestSessionCommands:assert result.exit_code != 0+@requires_cloudanalyzerclass TestCheckCommands:def test_init_creates_config(self, runner, tmp_path):dest = str(tmp_path / "cloudanalyzer.yaml")@@ -53,6 +61,7 @@ class TestCheckCommands:assert result.exit_code != 0+@requires_cloudanalyzerclass TestBaselineCommands:def test_save_and_list(self, runner, tmp_path):summary = tmp_path / "summary.json"diff --git a/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/utils/ca_backend.py b/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/utils/ca_backend.pyindex 5649f8ad4..96e2a4bca 100644--- a/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/utils/ca_backend.py+++ b/cloudanalyzer/agent-harness/cli_anything/cloudanalyzer/utils/ca_backend.py@@ -10,6 +10,11 @@ import jsonfrom pathlib import Pathfrom typing import Any+MISSING_CLOUDANALYZER_MSG = (+ "CloudAnalyzer is not installed or not importable. "+ "Install with: pip install cloudanalyzer"+)+def is_available() -> bool:"""Check if CloudAnalyzer is importable."""@@ -20,6 +25,11 @@ def is_available() -> bool:return False+def _ensure_ca() -> None:+ if not is_available():+ raise RuntimeError(MISSING_CLOUDANALYZER_MSG)++def get_version() -> str:"""Return the installed CloudAnalyzer version."""try:@@ -31,24 +41,28 @@ def get_version() -> str:def evaluate(source: str, reference: str, **kwargs: Any) -> dict:"""Run point cloud evaluation."""+ _ensure_ca()from ca.evaluate import evaluate as _evaluatereturn _evaluate(source, reference, **kwargs)def compare(source: str, target: str, method: str = "gicp", **kwargs: Any) -> dict:"""Run point cloud comparison with optional registration."""+ _ensure_ca()from ca.compare import run_comparereturn run_compare(source, target, method=method, **kwargs)def diff(source: str, target: str, threshold: float | None = None) -> dict:"""Run quick distance diff."""+ _ensure_ca()from ca.diff import run_diffreturn run_diff(source, target, threshold=threshold)def evaluate_trajectory(estimated: str, reference: str, **kwargs: Any) -> dict:"""Evaluate a trajectory against reference."""+ _ensure_ca()from ca.trajectory import evaluate_trajectory as _eval_trajreturn _eval_traj(estimated, reference, **kwargs)@@ -58,6 +72,7 @@ def evaluate_ground(ref_ground: str, ref_nonground: str, **kwargs: Any,) -> dict:"""Evaluate ground segmentation quality."""+ _ensure_ca()from ca.ground_evaluate import evaluate_ground_segmentationreturn evaluate_ground_segmentation(est_ground, est_nonground, ref_ground, ref_nonground, **kwargs,@@ -66,6 +81,7 @@ def evaluate_ground(def run_check_suite(config_path: str) -> dict:"""Run config-driven QA checks."""+ _ensure_ca()from ca.core import load_check_suite, run_check_suite as _runsuite = load_check_suite(config_path)return _run(suite)@@ -73,6 +89,7 @@ def run_check_suite(config_path: str) -> dict:def render_check_scaffold(profile: str = "integrated") -> str:"""Generate a starter config YAML."""+ _ensure_ca()from ca.core import render_check_scaffold as _renderresult = _render(profile=profile)return result.yaml_text@@ -80,6 +97,7 @@ def render_check_scaffold(profile: str = "integrated") -> str:def baseline_decision(candidate_path: str, history_paths: list[str]) -> dict:"""Decide promote / keep / reject for a baseline."""+ _ensure_ca()from ca.core import summarize_baseline_evolutioncandidate = json.loads(Path(candidate_path).read_text(encoding="utf-8"))history = [@@ -90,41 +108,175 @@ def baseline_decision(candidate_path: str, history_paths: list[str]) -> dict:def baseline_save(summary_path: str, history_dir: str, **kwargs: Any) -> str:"""Save a QA summary to the history directory."""+ _ensure_ca()from ca.baseline_history import save_baselinereturn save_baseline(summary_path, history_dir, **kwargs)def baseline_list(history_dir: str) -> list[dict]:"""List saved baselines."""+ _ensure_ca()from ca.baseline_history import list_baselinesreturn list_baselines(history_dir)def baseline_discover(history_dir: str) -> list[str]:"""Discover history JSON paths."""+ _ensure_ca()from ca.baseline_history import discover_historyreturn discover_history(history_dir)def baseline_rotate(history_dir: str, keep: int = 10) -> list[str]:"""Rotate old baselines."""+ _ensure_ca()from ca.baseline_history import rotate_historyreturn rotate_history(history_dir, keep=keep)def downsample(input_path: str, output_path: str, voxel_size: float) -> dict:"""Voxel grid downsampling."""+ _ensure_ca()from ca.downsample import downsample as _dsreturn _ds(input_path, voxel_size, output_path)def split(input_path: str, output_dir: str, grid_size: float, axis: str = "xy") -> dict:"""Split a point cloud into grid tiles."""+ _ensure_ca()from ca.split import split as _splitreturn _split(input_path, output_dir, grid_size, axis=axis)def info(path: str) -> dict:"""Get point cloud metadata."""+ _ensure_ca()from ca.info import get_inforeturn get_info(path)+++def batch_evaluate(directory: str, reference: str, **kwargs: Any) -> dict:+ """Evaluate every point cloud in a directory against one reference."""+ _ensure_ca()+ from ca.batch import batch_evaluate as _be+ return _be(directory, reference, **kwargs)+++def run_pipeline(+ input_path: str, reference: str, output: str, **kwargs: Any,+) -> dict:+ """Filter, downsample, evaluate in one pipeline."""+ _ensure_ca()+ from ca.pipeline import run_pipeline as _rp+ return _rp(input_path, reference, output, **kwargs)+++def trajectory_batch_evaluate(+ directory: str, reference_dir: str, **kwargs: Any,+) -> dict:+ """Batch trajectory evaluation."""+ _ensure_ca()+ from ca.batch import trajectory_batch_evaluate as _tbe+ return _tbe(directory, reference_dir, **kwargs)+++def evaluate_run(+ map_path: str,+ map_reference_path: str,+ trajectory_path: str,+ trajectory_reference_path: str,+ **kwargs: Any,+) -> dict:+ """Evaluate one map and one trajectory together."""+ _ensure_ca()+ from ca.run_evaluate import evaluate_run as _er+ return _er(+ map_path,+ map_reference_path,+ trajectory_path,+ trajectory_reference_path,+ **kwargs,+ )+++def random_sample(input_path: str, output_path: str, num_points: int) -> dict:+ """Random point sampling."""+ _ensure_ca()+ from ca.sample import random_sample as _rs+ return _rs(input_path, output_path, num_points)+++def filter_outliers(+ input_path: str, output_path: str, **kwargs: Any,+) -> dict:+ """Statistical outlier removal."""+ _ensure_ca()+ from ca.filter import filter_outliers as _fo+ return _fo(input_path, output_path, **kwargs)+++def merge(paths: list[str], output: str) -> dict:+ """Merge point clouds."""+ _ensure_ca()+ from ca.merge import merge as _m+ return _m(paths, output)+++def convert(input_path: str, output_path: str) -> dict:+ """Convert between point cloud formats."""+ _ensure_ca()+ from ca.convert import convert as _c+ return _c(input_path, output_path)+++def view_point_cloud(path: str) -> None:+ """Open the interactive point cloud viewer (single file)."""+ _ensure_ca()+ from ca.view import view as _view+ _view([path])+++def web_serve(+ source: str,+ reference: str | None,+ *,+ port: int = 8080,+ heatmap: bool = False,+ trajectory: str | None = None,+ trajectory_reference: str | None = None,+ open_browser: bool = True,+) -> None:+ """Start the CloudAnalyzer web viewer."""+ _ensure_ca()+ from ca.web import serve+ paths: list[str] = [source] if not reference else [source, reference]+ serve(+ paths,+ port=port,+ open_browser=open_browser,+ heatmap=heatmap,+ trajectory_path=trajectory,+ trajectory_reference_path=trajectory_reference,+ )+++def web_export_bundle(+ source: str,+ reference: str | None,+ output_dir: str,+ *,+ heatmap: bool = False,+ trajectory: str | None = None,+ trajectory_reference: str | None = None,+) -> dict:+ """Write a static HTML viewer bundle."""+ _ensure_ca()+ from ca.web import export_static_bundle+ paths: list[str] = [source] if not reference else [source, reference]+ return export_static_bundle(+ paths,+ output_dir=output_dir,+ heatmap=heatmap,+ trajectory_path=trajectory,+ trajectory_reference_path=trajectory_reference,+ )