feat(cli): unifier bcasl run/doctor pour usage serveur

Author: raidos23

cli/click_app.py

@@ -817,22 +817,30 @@ def bcasl_list(as_json):
         sys.exit(_run_bcasl_headless(["list"]))
 
     @bcasl.command("run")
-    @click.argument("workspace", type=click.Path(exists=False))
+    @click.argument("workspace", required=False, type=click.Path(exists=False))
+    @click.option("-w", "--workspace", "workspace_opt", type=click.Path(exists=False))
     @click.option("--timeout", type=float, default=0.0)
-    def bcasl_run(workspace, timeout):
+    def bcasl_run(workspace, workspace_opt, timeout):
         """Run BCASL pipeline headlessly for one workspace."""
-        args = ["run", _resolve_workspace_path(workspace) or workspace]
+        selected_workspace = workspace_opt or workspace
+        if not selected_workspace:
+            raise click.ClickException("Missing workspace path for bcasl run")
+        args = ["run", _resolve_workspace_path(selected_workspace) or selected_workspace]
         if timeout:
             args.extend(["--timeout", str(timeout)])
         sys.exit(_run_bcasl_headless(args))
 
     @bcasl.command("doctor")
     @click.argument("workspace", required=False, type=click.Path(exists=False))
+    @click.option("-w", "--workspace", "workspace_opt", type=click.Path(exists=False))
     @click.option("--json", "as_json", is_flag=True)
     @click.option("--strict", is_flag=True, help="Exit non-zero when BCASL checks fail")
-    def bcasl_doctor(workspace, as_json, strict):
+    def bcasl_doctor(workspace, workspace_opt, as_json, strict):
         """Run BCASL diagnostics and optionally enforce strict mode."""
-        payload = bcasl_doctor_payload(workspace=_resolve_workspace_path(workspace))
+        selected_workspace = workspace_opt or workspace
+        payload = bcasl_doctor_payload(
+            workspace=_resolve_workspace_path(selected_workspace)
+        )
         if as_json:
             if strict and any(not check["ok"] for check in payload.get("checks", [])):
                 _emit_and_exit(payload, EXIT_PRECHECK_FAILED, as_json=True)

cli/dedicated.py

@@ -301,13 +301,16 @@ def _print_bcasl_help() -> None:
         plain("  bcasl list")
         plain("  bcasl run <workspace> [--timeout SECONDS]")
         plain("  bcasl run -w <workspace> [--timeout SECONDS]")
+        plain("  bcasl doctor [workspace] [--strict]")
+        plain("  bcasl doctor -w <workspace> [--strict]")
         plain("")
         plain("Examples:")
         plain("  bcasl")
         plain("  bcasl /path/to/workspace")
         plain("  bcasl list")
         plain("  bcasl run /path/to/workspace")
         plain("  bcasl run /path/to/workspace --timeout 30")
+        plain("  bcasl doctor /path/to/workspace --strict")
         plain("")
         return
 
@@ -318,10 +321,12 @@ def _print_bcasl_help() -> None:
     table.add_row("bcasl list", "List BCASL plugins")
     table.add_row("bcasl run <workspace>", "Run plugins headless")
     table.add_row("bcasl run -w <workspace>", "Run plugins headless")
+    table.add_row("bcasl doctor [workspace]", "Run BCASL diagnostics")
     _RICH_CONSOLE.print(table)
     _RICH_CONSOLE.print("[bold]Examples[/bold]")
     _print_cmdline("bcasl list")
     _print_cmdline("bcasl run /path/to/workspace --timeout 30")
+    _print_cmdline("bcasl doctor /path/to/workspace --strict")
 
 
 def _run_bcasl_headless(args: list[str]) -> int:
@@ -414,6 +419,41 @@ def _log(msg: str) -> None:
         error(f"BCASL run finished with failures: {failed} plugin(s) failed.")
         return 1
 
+    if sub == "doctor":
+        workspace: str | None = None
+        strict = False
+        i = 1
+        while i < len(args):
+            tok = args[i]
+            if tok in ("-w", "--workspace"):
+                if i + 1 >= len(args):
+                    error("Missing workspace path after --workspace")
+                    return 2
+                workspace = _resolve_workspace(args[i + 1])
+                i += 2
+                continue
+            if tok == "--strict":
+                strict = True
+                i += 1
+                continue
+            if workspace is None and not tok.startswith("-"):
+                workspace = _resolve_workspace(tok)
+                i += 1
+                continue
+            error(f"Unknown option for bcasl doctor: {tok}")
+            return 2
+
+        from .headless_ops import bcasl_doctor_payload
+
+        payload = bcasl_doctor_payload(workspace=workspace)
+        plain("BCASL Doctor")
+        for check in payload.get("checks", []):
+            status = "OK" if check.get("ok") else "FAIL"
+            plain(f"  [{status}] {check.get('name')}: {check.get('message') or ''}")
+        if strict and not payload.get("ok", False):
+            return 1
+        return 0
+
     error(f"Unknown bcasl subcommand: {sub}")
     _print_bcasl_help()
     return 2

cli/fallback.py

@@ -15,7 +15,7 @@
     first_positional,
     normalize_path,
 )
-from .dedicated import run_dedicated_cli
+from .dedicated import _run_bcasl_headless, run_dedicated_cli
 from .headless_commands import (
     run_check,
     run_config_auto,
@@ -134,6 +134,8 @@ def run(argv: list[str] | None, app_version: str) -> int:
     if cmd in ("--unload", "unload"):
         return _run_unload()
     if cmd == "bcasl":
+        if rest and rest[0] in ("list", "run", "doctor"):
+            return _run_bcasl_headless(rest)
         return launch_bcasl_gui(normalize_path(first_positional(rest)))
     if cmd == "engines":
         return _run_engines(rest)