qubecli 1.0.2__tar.gz → 1.0.4__tar.gz

{qubecli-1.0.2 → qubecli-1.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qubecli
-Version: 1.0.2
+Version: 1.0.4
 Summary: QubeCore CLI — Command Line Interface for QubeCore
 License: MIT License
         
@@ -25,7 +25,7 @@ License: MIT License
         SOFTWARE.
 License-File: LICENSE
 Requires-Python: >=3.11
-Requires-Dist: qubecore-client>=1.0.10
+Requires-Dist: qubecore-client>=1.0.12
 Requires-Dist: typer>=0.12.0
 Provides-Extra: dev
 Requires-Dist: mypy>=1.8.0; extra == 'dev'
@@ -58,8 +58,25 @@ pip install qubecli
 # Set server address
 qubecore config set host 192.168.1.100:50051
 
-# Submit a job (use single quotes to avoid shell interpretation of \n)
-qubecore submit --backend backend1 --circuit 'OPENQASM 2.0;\ninclude "qelib1.inc";\nqreg q[2];\ncreg c[2];\nh q[0];\ncx q[0],q[1];\nmeasure q -> c;' --shots 100
+# Submit a gate job
+qubecore submit --backend backend1 \
+  --circuit 'OPENQASM 2.0;\ninclude "qelib1.inc";\nqreg q[2];\ncreg c[2];\nh q[0];\ncx q[0],q[1];\nmeasure q -> c;' \
+  --shots 100
+
+# Submit a pulse job
+qubecore submit-pulse --backend backend1 \
+  --pulse '{"channel": "ch0", "waveform": [...]}' \
+  --shots 100
+
+# Submit a reset job
+qubecore submit-reset --backend backend1 \
+  --qubits qubit_0,qubit_1 \
+  --shots 100
+
+# Submit a calibration job
+qubecore submit-calibration --backend backend1 \
+  --calibration-type widescan \
+  --params '{"qubit": "qubit_0", "span": 100000000, "n_points": 200, "num_shots": 100}'
 
 # Check status
 qubecore status --job-id <job_id>
@@ -67,7 +84,7 @@ qubecore status --job-id <job_id>
 # Fetch result
 qubecore result --job-id <job_id>
 
-# Cancel job
+# Cancel job (only possible while status is PENDING)
 qubecore cancel --job-id <job_id>
 ```
 
@@ -92,17 +109,26 @@ qubecore config unset host
 ### Job Commands
 
 ```bash
-# Submit
+# Gate job
 qubecore submit --backend <backend> --circuit <circuit_string> --shots <n>
 qubecore submit --backend backend1 --circuit '...' --shots 100 --priority 2 --optimization-level 1
 
+# Pulse job
+qubecore submit-pulse --backend <backend> --pulse <pulse_json> --shots <n>
+
+# Reset job
+qubecore submit-reset --backend <backend> --qubits qubit_0,qubit_1 --shots <n>
+
+# Calibration job
+qubecore submit-calibration --backend <backend> --calibration-type widescan --params '{"qubit": "qubit_0", "span": 100000000, "n_points": 200, "num_shots": 100}'
+
 # Status
 qubecore status --job-id <job_id>
 
 # Result
 qubecore result --job-id <job_id>
 
-# Cancel (PENDING 상태일 때만 가능)
+# Cancel
 qubecore cancel --job-id <job_id>
 ```
 
@@ -117,12 +143,39 @@ qubecore --host 10.0.0.1:50051 submit --backend backend1 --circuit "..." --shots
 ### `submit`
 
 | Option | Required | Description |
-|--------|----------|-------------|
-| `--backend` | Yes | 백엔드 이름 (`backend1`, `kreo.sc-20` 등) |
-| `--circuit` | Yes | 회로 문자열 (QASM2/QASM3/JSON) |
-| `--shots` | Yes | 실행 횟수 |
-| `--priority` | No | 우선순위 1~4 (1=CRITICAL, 2=HIGH, 3=NORMAL, 4=LOW) |
-| `--optimization-level` | No | 최적화 레벨 0~3 |
+|--------|:--------:|-------------|
+| `--backend` | Yes | Backend name (`backend1`, `kreo.sc-20`, etc.) |
+| `--circuit` | Yes | Circuit string (QASM2/QASM3/JSON) |
+| `--shots` | Yes | Number of shots |
+| `--priority` | No | Priority 1–4 (1=CRITICAL, 2=HIGH, 3=NORMAL, 4=LOW) |
+| `--optimization-level` | No | Transpile optimization level 0–3 |
+
+### `submit-pulse`
+
+| Option | Required | Description |
+|--------|:--------:|-------------|
+| `--backend` | Yes | Backend name |
+| `--pulse` | Yes | Pulse program string (backend-specific JSON) |
+| `--shots` | Yes | Number of shots |
+| `--priority` | No | Priority 1–4 (default: 3=NORMAL) |
+
+### `submit-reset`
+
+| Option | Required | Description |
+|--------|:--------:|-------------|
+| `--backend` | Yes | Backend name |
+| `--qubits` | Yes | Comma-separated qubit names (e.g. `qubit_0,qubit_1`) |
+| `--shots` | Yes | Number of verification shots after reset |
+| `--priority` | No | Priority 1–4 (default: 3=NORMAL) |
+
+### `submit-calibration`
+
+| Option | Required | Description |
+|--------|:--------:|-------------|
+| `--backend` | Yes | Backend name |
+| `--calibration-type` | Yes | Calibration type: `widescan` or `punchout` |
+| `--params` | Yes | Calibration parameters as JSON string |
+| `--priority` | No | Priority 1–4 (default: 3=NORMAL) |
 
 ## Compatibility
 

qubecli-1.0.4/README.md

@@ -0,0 +1,154 @@
+# QubeCli
+
+Command Line Interface for QubeCore — Quantum Computing Operating System.
+
+## Overview
+
+QubeCli provides a terminal-based interface for submitting and managing
+quantum jobs on QubeCore. Built on [qubecore-client](https://github.com/sdt-quantum/qubecore-client).
+
+## Requirements
+
+- Python 3.11+
+- QubeCore Server running and accessible
+
+## Installation
+
+```bash
+pip install qubecli
+```
+
+## Quick Start
+
+```bash
+# Set server address
+qubecore config set host 192.168.1.100:50051
+
+# Submit a gate job
+qubecore submit --backend backend1 \
+  --circuit 'OPENQASM 2.0;\ninclude "qelib1.inc";\nqreg q[2];\ncreg c[2];\nh q[0];\ncx q[0],q[1];\nmeasure q -> c;' \
+  --shots 100
+
+# Submit a pulse job
+qubecore submit-pulse --backend backend1 \
+  --pulse '{"channel": "ch0", "waveform": [...]}' \
+  --shots 100
+
+# Submit a reset job
+qubecore submit-reset --backend backend1 \
+  --qubits qubit_0,qubit_1 \
+  --shots 100
+
+# Submit a calibration job
+qubecore submit-calibration --backend backend1 \
+  --calibration-type widescan \
+  --params '{"qubit": "qubit_0", "span": 100000000, "n_points": 200, "num_shots": 100}'
+
+# Check status
+qubecore status --job-id <job_id>
+
+# Fetch result
+qubecore result --job-id <job_id>
+
+# Cancel job (only possible while status is PENDING)
+qubecore cancel --job-id <job_id>
+```
+
+## Commands
+
+### Version
+
+```bash
+qubecore -v
+qubecore --version
+```
+
+### Server Configuration
+
+```bash
+qubecore config set host 192.168.1.100:50051
+qubecore config get
+qubecore config get host
+qubecore config unset host
+```
+
+### Job Commands
+
+```bash
+# Gate job
+qubecore submit --backend <backend> --circuit <circuit_string> --shots <n>
+qubecore submit --backend backend1 --circuit '...' --shots 100 --priority 2 --optimization-level 1
+
+# Pulse job
+qubecore submit-pulse --backend <backend> --pulse <pulse_json> --shots <n>
+
+# Reset job
+qubecore submit-reset --backend <backend> --qubits qubit_0,qubit_1 --shots <n>
+
+# Calibration job
+qubecore submit-calibration --backend <backend> --calibration-type widescan --params '{"qubit": "qubit_0", "span": 100000000, "n_points": 200, "num_shots": 100}'
+
+# Status
+qubecore status --job-id <job_id>
+
+# Result
+qubecore result --job-id <job_id>
+
+# Cancel
+qubecore cancel --job-id <job_id>
+```
+
+One-time server override:
+
+```bash
+qubecore --host 10.0.0.1:50051 submit --backend backend1 --circuit "..." --shots 100
+```
+
+## Options
+
+### `submit`
+
+| Option | Required | Description |
+|--------|:--------:|-------------|
+| `--backend` | Yes | Backend name (`backend1`, `kreo.sc-20`, etc.) |
+| `--circuit` | Yes | Circuit string (QASM2/QASM3/JSON) |
+| `--shots` | Yes | Number of shots |
+| `--priority` | No | Priority 1–4 (1=CRITICAL, 2=HIGH, 3=NORMAL, 4=LOW) |
+| `--optimization-level` | No | Transpile optimization level 0–3 |
+
+### `submit-pulse`
+
+| Option | Required | Description |
+|--------|:--------:|-------------|
+| `--backend` | Yes | Backend name |
+| `--pulse` | Yes | Pulse program string (backend-specific JSON) |
+| `--shots` | Yes | Number of shots |
+| `--priority` | No | Priority 1–4 (default: 3=NORMAL) |
+
+### `submit-reset`
+
+| Option | Required | Description |
+|--------|:--------:|-------------|
+| `--backend` | Yes | Backend name |
+| `--qubits` | Yes | Comma-separated qubit names (e.g. `qubit_0,qubit_1`) |
+| `--shots` | Yes | Number of verification shots after reset |
+| `--priority` | No | Priority 1–4 (default: 3=NORMAL) |
+
+### `submit-calibration`
+
+| Option | Required | Description |
+|--------|:--------:|-------------|
+| `--backend` | Yes | Backend name |
+| `--calibration-type` | Yes | Calibration type: `widescan` or `punchout` |
+| `--params` | Yes | Calibration parameters as JSON string |
+| `--priority` | No | Priority 1–4 (default: 3=NORMAL) |
+
+## Compatibility
+
+| qubecli | qubecore-client | qubecore |
+|---------|----------------|----------|
+| 1.x | 1.x | 1.x |
+
+## License
+
+MIT

{qubecli-1.0.2 → qubecli-1.0.4}/pyproject.toml

@@ -4,14 +4,14 @@ build-backend = "hatchling.build"
 
 [project]
 name = "qubecli"
-version = "1.0.2"
+version = "1.0.4"
 description = "QubeCore CLI — Command Line Interface for QubeCore"
 readme = "README.md"
 license = { file = "LICENSE" }
 requires-python = ">=3.11"
 dependencies = [
     "typer>=0.12.0",
-    "qubecore-client>=1.0.10",
+    "qubecore-client>=1.0.12",
 ]
 
 [project.optional-dependencies]

qubecli-1.0.4/src/qubecli/main.py

@@ -0,0 +1,268 @@
+import json
+from contextlib import contextmanager
+from importlib.metadata import version
+from pathlib import Path
+from typing import Annotated, Generator, Optional
+
+import grpc
+import typer
+from qubecore_client import QubeClient
+
+_CONFIG_PATH = Path.home() / ".qubecore" / "config.json"
+
+app = typer.Typer(help="QubeCore CLI — Quantum Computing Operating System", invoke_without_command=True)
+config_app = typer.Typer(help="Manage server configuration")
+app.add_typer(config_app, name="config")
+
+
+_address: str = "localhost:50051"
+
+
+def _load_config() -> dict:
+    if _CONFIG_PATH.exists():
+        return json.loads(_CONFIG_PATH.read_text())
+    return {}
+
+
+def _save_config(data: dict) -> None:
+    _CONFIG_PATH.parent.mkdir(parents=True, exist_ok=True)
+    _CONFIG_PATH.write_text(json.dumps(data, indent=2))
+
+
+def _resolve_address(host: Optional[str]) -> str:
+    if host is not None:
+        return host
+    return _load_config().get("host", "localhost:50051")
+
+
+@contextmanager
+def _get_client(address: str) -> Generator[QubeClient, None, None]:
+    client = QubeClient(address=address)
+    try:
+        yield client
+    except grpc.RpcError as e:
+        if e.code() == grpc.StatusCode.UNAVAILABLE:
+            typer.echo(f"Cannot connect to server: {address}", err=True)
+            typer.echo("  Run 'qubecore config set host <host:port>' to update the server address.", err=True)
+        else:
+            typer.echo(f"gRPC error: {e.details()}", err=True)
+        raise typer.Exit(1)
+    finally:
+        client.close()
+
+
+def _priority_label(priority: int) -> str:
+    return {1: "CRITICAL", 2: "HIGH", 3: "NORMAL", 4: "LOW"}.get(priority, str(priority))
+
+
+@app.callback()
+def _callback(
+    host: Annotated[Optional[str], typer.Option(help="QubeCore server address (host:port)")] = None,
+    ver: Annotated[bool, typer.Option("-v", "--version", help="Print version", is_eager=True)] = False,
+) -> None:
+    global _address
+    if ver:
+        typer.echo(f"v{version('qubecli')}")
+        raise typer.Exit()
+    _address = _resolve_address(host)
+
+
+@config_app.command("set")
+def config_set(
+    key: Annotated[str, typer.Argument(help="Config key")],
+    value: Annotated[str, typer.Argument(help="Config value")],
+) -> None:
+    """Save a config value (e.g. qubecore config set host 192.168.1.100:50051)"""
+    if key != "host":
+        typer.echo(f"Unknown key: {key}. Available: host", err=True)
+        raise typer.Exit(1)
+    cfg = _load_config()
+    cfg[key] = value
+    _save_config(cfg)
+    typer.echo(f"✓ {key} = {value} saved ({_CONFIG_PATH})")
+
+
+@config_app.command("get")
+def config_get(
+    key: Annotated[Optional[str], typer.Argument(help="Config key (omit to show all)")] = None,
+) -> None:
+    """Show config value(s)"""
+    cfg = _load_config()
+    if not cfg:
+        typer.echo("No config saved")
+        return
+    if key:
+        typer.echo(f"  {key} : {cfg.get(key, '(not set)')}")
+    else:
+        for k, v in cfg.items():
+            typer.echo(f"  {k} : {v}")
+
+
+@config_app.command("unset")
+def config_unset(
+    key: Annotated[str, typer.Argument(help="Config key to remove")],
+) -> None:
+    """Remove a config value"""
+    cfg = _load_config()
+    if key not in cfg:
+        typer.echo(f"  {key} : (not set)")
+        return
+    del cfg[key]
+    _save_config(cfg)
+    typer.echo(f"✓ {key} removed")
+
+
+@app.command()
+def submit(
+    backend: Annotated[str, typer.Option(help="Backend name (e.g. backend1, kreo.sc-20)")],
+    circuit: Annotated[str, typer.Option(help="Circuit string (QASM2/QASM3/JSON)")],
+    shots: Annotated[int, typer.Option(help="Number of shots")],
+    priority: Annotated[Optional[int], typer.Option(help="Priority 1–4 (default: 3=NORMAL)")] = None,
+    optimization_level: Annotated[Optional[int], typer.Option(help="Transpile optimization level 0–3")] = None,
+) -> None:
+    """Submit a gate-circuit execution job"""
+    if priority is not None and priority not in (1, 2, 3, 4):
+        typer.echo("priority must be between 1 and 4.", err=True)
+        raise typer.Exit(1)
+    if optimization_level is not None and optimization_level not in (0, 1, 2, 3):
+        typer.echo("optimization-level must be between 0 and 3.", err=True)
+        raise typer.Exit(1)
+    with _get_client(_address) as client:
+        job_id = client.submit_gate_job(
+            backend_name=backend,
+            gate_circuits=[circuit.replace("\\n", "\n").replace("\\t", "\t")],
+            shots=shots,
+            priority=priority,
+            optimization_level=optimization_level,
+        )
+    typer.echo("✓ Job submitted")
+    typer.echo(f"  job_id   : {job_id}")
+    typer.echo(f"  priority : {_priority_label(priority if priority is not None else 3)}")
+
+
+@app.command("submit-pulse")
+def submit_pulse(
+    backend: Annotated[str, typer.Option(help="Backend name")],
+    pulse: Annotated[str, typer.Option(help="Pulse program string (backend-specific JSON)")],
+    shots: Annotated[int, typer.Option(help="Number of shots")],
+    priority: Annotated[Optional[int], typer.Option(help="Priority 1–4 (default: 3=NORMAL)")] = None,
+) -> None:
+    """Submit a pulse-program execution job"""
+    if priority is not None and priority not in (1, 2, 3, 4):
+        typer.echo("priority must be between 1 and 4.", err=True)
+        raise typer.Exit(1)
+    with _get_client(_address) as client:
+        job_id = client.submit_pulse_job(
+            backend_name=backend,
+            pulse_circuits=[pulse],
+            shots=shots,
+            priority=priority,
+        )
+    typer.echo("✓ Job submitted")
+    typer.echo(f"  job_id   : {job_id}")
+    typer.echo(f"  priority : {_priority_label(priority if priority is not None else 3)}")
+
+
+@app.command("submit-reset")
+def submit_reset(
+    backend: Annotated[str, typer.Option(help="Backend name")],
+    qubits: Annotated[str, typer.Option(help="Comma-separated qubit names (e.g. qubit_0,qubit_1)")],
+    shots: Annotated[int, typer.Option(help="Number of verification shots after reset")],
+    priority: Annotated[Optional[int], typer.Option(help="Priority 1–4 (default: 3=NORMAL)")] = None,
+) -> None:
+    """Submit a qubit active-reset job"""
+    if priority is not None and priority not in (1, 2, 3, 4):
+        typer.echo("priority must be between 1 and 4.", err=True)
+        raise typer.Exit(1)
+    qubit_list = [q.strip() for q in qubits.split(",")]
+    with _get_client(_address) as client:
+        job_id = client.submit_reset_job(
+            backend_name=backend,
+            qubits=qubit_list,
+            shots=shots,
+            priority=priority,
+        )
+    typer.echo("✓ Job submitted")
+    typer.echo(f"  job_id   : {job_id}")
+    typer.echo(f"  qubits   : {qubit_list}")
+    typer.echo(f"  priority : {_priority_label(priority if priority is not None else 3)}")
+
+
+@app.command("submit-calibration")
+def submit_calibration(
+    backend: Annotated[str, typer.Option(help="Backend name")],
+    calibration_type: Annotated[str, typer.Option(help="Calibration type: widescan or punchout")],
+    params: Annotated[str, typer.Option(help="Calibration parameters as JSON string")],
+    priority: Annotated[Optional[int], typer.Option(help="Priority 1–4 (default: 3=NORMAL)")] = None,
+) -> None:
+    """Submit a calibration job"""
+    if priority is not None and priority not in (1, 2, 3, 4):
+        typer.echo("priority must be between 1 and 4.", err=True)
+        raise typer.Exit(1)
+    try:
+        params_dict = json.loads(params)
+    except json.JSONDecodeError as e:
+        typer.echo(f"Failed to parse params JSON: {e}", err=True)
+        raise typer.Exit(1)
+    with _get_client(_address) as client:
+        job_id = client.submit_calibration_job(
+            backend_name=backend,
+            calibration_type=calibration_type,
+            params=params_dict,
+            priority=priority,
+        )
+    typer.echo("✓ Job submitted")
+    typer.echo(f"  job_id           : {job_id}")
+    typer.echo(f"  calibration_type : {calibration_type}")
+    typer.echo(f"  priority         : {_priority_label(priority if priority is not None else 3)}")
+
+
+@app.command()
+def status(
+    job_id: Annotated[str, typer.Option(help="Job ID")],
+) -> None:
+    """Show job status"""
+    with _get_client(_address) as client:
+        job = client.get_job_status(job_id)
+    typer.echo(f"  job_id    : {job['job_id']}")
+    typer.echo(f"  status    : {job['status']}")
+    typer.echo(f"  priority  : {_priority_label(job['priority'])}")
+    typer.echo(f"  submitted : {job['submitted_at']}")
+    typer.echo(f"  started   : {job['started_at'] or '(not started)'}")
+    typer.echo(f"  finished  : {job['finished_at'] or '(not finished)'}")
+    if job["error"]:
+        typer.echo(f"  error     : {job['error']}")
+
+
+@app.command()
+def result(
+    job_id: Annotated[str, typer.Option(help="Job ID")],
+) -> None:
+    """Show job result"""
+    with _get_client(_address) as client:
+        job = client.get_job_result(job_id)
+    typer.echo(f"  job_id : {job['job_id']}")
+    typer.echo(f"  status : {job['status']}")
+    if "calibration_result" in job:
+        typer.echo(f"  calibration_result : {json.dumps(job['calibration_result'], indent=2)}")
+    else:
+        for i, r in enumerate(job.get("results", [])):
+            typer.echo(f"  [circuit {i}] counts : {r['counts']}")
+
+
+@app.command()
+def cancel(
+    job_id: Annotated[str, typer.Option(help="Job ID")],
+) -> None:
+    """Cancel a job (only possible while status is PENDING)"""
+    with _get_client(_address) as client:
+        message = client.cancel_job(job_id)
+    typer.echo(f"✓ {message}")
+
+
+def main() -> None:
+    app()
+
+
+if __name__ == "__main__":
+    main()

qubecli-1.0.2/README.md

@@ -1,101 +0,0 @@
-# QubeCli
-
-Command Line Interface for QubeCore — Quantum Computing Operating System.
-
-## Overview
-
-QubeCli provides a terminal-based interface for submitting and managing
-quantum jobs on QubeCore. Built on [qubecore-client](https://github.com/sdt-quantum/qubecore-client).
-
-## Requirements
-
-- Python 3.11+
-- QubeCore Server running and accessible
-
-## Installation
-
-```bash
-pip install qubecli
-```
-
-## Quick Start
-
-```bash
-# Set server address
-qubecore config set host 192.168.1.100:50051
-
-# Submit a job (use single quotes to avoid shell interpretation of \n)
-qubecore submit --backend backend1 --circuit 'OPENQASM 2.0;\ninclude "qelib1.inc";\nqreg q[2];\ncreg c[2];\nh q[0];\ncx q[0],q[1];\nmeasure q -> c;' --shots 100
-
-# Check status
-qubecore status --job-id <job_id>
-
-# Fetch result
-qubecore result --job-id <job_id>
-
-# Cancel job
-qubecore cancel --job-id <job_id>
-```
-
-## Commands
-
-### Version
-
-```bash
-qubecore -v
-qubecore --version
-```
-
-### Server Configuration
-
-```bash
-qubecore config set host 192.168.1.100:50051
-qubecore config get
-qubecore config get host
-qubecore config unset host
-```
-
-### Job Commands
-
-```bash
-# Submit
-qubecore submit --backend <backend> --circuit <circuit_string> --shots <n>
-qubecore submit --backend backend1 --circuit '...' --shots 100 --priority 2 --optimization-level 1
-
-# Status
-qubecore status --job-id <job_id>
-
-# Result
-qubecore result --job-id <job_id>
-
-# Cancel (PENDING 상태일 때만 가능)
-qubecore cancel --job-id <job_id>
-```
-
-One-time server override:
-
-```bash
-qubecore --host 10.0.0.1:50051 submit --backend backend1 --circuit "..." --shots 100
-```
-
-## Options
-
-### `submit`
-
-| Option | Required | Description |
-|--------|----------|-------------|
-| `--backend` | Yes | 백엔드 이름 (`backend1`, `kreo.sc-20` 등) |
-| `--circuit` | Yes | 회로 문자열 (QASM2/QASM3/JSON) |
-| `--shots` | Yes | 실행 횟수 |
-| `--priority` | No | 우선순위 1~4 (1=CRITICAL, 2=HIGH, 3=NORMAL, 4=LOW) |
-| `--optimization-level` | No | 최적화 레벨 0~3 |
-
-## Compatibility
-
-| qubecli | qubecore-client | qubecore |
-|---------|----------------|----------|
-| 1.x | 1.x | 1.x |
-
-## License
-
-MIT

qubecli-1.0.2/src/qubecli/main.py

@@ -1,188 +0,0 @@
-import json
-from contextlib import contextmanager
-from importlib.metadata import version
-from pathlib import Path
-from typing import Annotated, Generator, Optional
-
-import grpc
-import typer
-from qubecore_client import QubeClient
-
-_CONFIG_PATH = Path.home() / ".qubecore" / "config.json"
-
-app = typer.Typer(help="QubeCore CLI — Quantum Computing Operating System", invoke_without_command=True)
-config_app = typer.Typer(help="서버 설정 관리")
-app.add_typer(config_app, name="config")
-
-
-_address: str = "localhost:50051"
-
-
-def _load_config() -> dict:
-    if _CONFIG_PATH.exists():
-        return json.loads(_CONFIG_PATH.read_text())
-    return {}
-
-
-def _save_config(data: dict) -> None:
-    _CONFIG_PATH.parent.mkdir(parents=True, exist_ok=True)
-    _CONFIG_PATH.write_text(json.dumps(data, indent=2))
-
-
-def _resolve_address(host: Optional[str]) -> str:
-    if host is not None:
-        return host
-    return _load_config().get("host", "localhost:50051")
-
-
-@contextmanager
-def _get_client(address: str) -> Generator[QubeClient, None, None]:
-    client = QubeClient(address=address)
-    try:
-        yield client
-    except grpc.RpcError as e:
-        if e.code() == grpc.StatusCode.UNAVAILABLE:
-            typer.echo(f"서버에 연결할 수 없습니다: {address}", err=True)
-            typer.echo("  'qubecore config set host <host:port>' 로 서버 주소를 확인하세요.", err=True)
-        else:
-            typer.echo(f"gRPC 오류: {e.details()}", err=True)
-        raise typer.Exit(1)
-    finally:
-        client.close()
-
-
-def _priority_label(priority: int) -> str:
-    return {1: "CRITICAL", 2: "HIGH", 3: "NORMAL", 4: "LOW"}.get(priority, str(priority))
-
-
-@app.callback()
-def _callback(
-    host: Annotated[Optional[str], typer.Option(help="QubeCore 서버 주소 (host:port)")] = None,
-    ver: Annotated[bool, typer.Option("-v", "--version", help="버전 출력", is_eager=True)] = False,
-) -> None:
-    global _address
-    if ver:
-        typer.echo(f"v{version('qubecli')}")
-        raise typer.Exit()
-    _address = _resolve_address(host)
-
-
-@config_app.command("set")
-def config_set(
-    key: Annotated[str, typer.Argument(help="설정 키")],
-    value: Annotated[str, typer.Argument(help="설정 값")],
-) -> None:
-    """설정값 저장 (예: qubecore config set host 192.168.1.100:50051)"""
-    if key != "host":
-        typer.echo(f"알 수 없는 키: {key}. 사용 가능: host", err=True)
-        raise typer.Exit(1)
-    cfg = _load_config()
-    cfg[key] = value
-    _save_config(cfg)
-    typer.echo(f"✓ {key} = {value} 저장 완료 ({_CONFIG_PATH})")
-
-
-@config_app.command("get")
-def config_get(
-    key: Annotated[Optional[str], typer.Argument(help="설정 키 (생략 시 전체 출력)")] = None,
-) -> None:
-    """설정값 조회"""
-    cfg = _load_config()
-    if not cfg:
-        typer.echo("저장된 설정 없음")
-        return
-    if key:
-        typer.echo(f"  {key} : {cfg.get(key, '(없음)')}")
-    else:
-        for k, v in cfg.items():
-            typer.echo(f"  {k} : {v}")
-
-
-@config_app.command("unset")
-def config_unset(
-    key: Annotated[str, typer.Argument(help="삭제할 설정 키")],
-) -> None:
-    """설정값 삭제"""
-    cfg = _load_config()
-    if key not in cfg:
-        typer.echo(f"  {key} : 설정된 값 없음")
-        return
-    del cfg[key]
-    _save_config(cfg)
-    typer.echo(f"✓ {key} 삭제 완료")
-
-
-@app.command()
-def submit(
-    backend: Annotated[str, typer.Option(help="백엔드 이름 (backend1, kreo.sc-20 등)")],
-    circuit: Annotated[str, typer.Option(help="회로 문자열 (QASM2/QASM3/JSON)")],
-    shots: Annotated[int, typer.Option(help="실행 횟수")],
-    priority: Annotated[Optional[int], typer.Option(help="우선순위 1~4 (기본값 3=NORMAL)")] = None,
-    optimization_level: Annotated[Optional[int], typer.Option(help="최적화 레벨 0~3")] = None,
-) -> None:
-    """게이트 회로 실행 작업 제출"""
-    if priority is not None and priority not in (1, 2, 3, 4):
-        typer.echo("priority는 1~4 사이여야 합니다.", err=True)
-        raise typer.Exit(1)
-    if optimization_level is not None and optimization_level not in (0, 1, 2, 3):
-        typer.echo("optimization-level은 0~3 사이여야 합니다.", err=True)
-        raise typer.Exit(1)
-    with _get_client(_address) as client:
-        job_id = client.submit_gate_job(
-            backend_name=backend,
-            gate_circuits=[circuit.replace("\\n", "\n").replace("\\t", "\t")],
-            shots=shots,
-            priority=priority,
-            optimization_level=optimization_level,
-        )
-    typer.echo("✓ 작업 제출 완료")
-    typer.echo(f"  job_id   : {job_id}")
-    typer.echo(f"  priority : {_priority_label(priority if priority is not None else 3)}")
-
-
-@app.command()
-def status(
-    job_id: Annotated[str, typer.Option(help="작업 ID")],
-) -> None:
-    """작업 상태 조회"""
-    with _get_client(_address) as client:
-        job = client.get_job_status(job_id)
-    typer.echo(f"  job_id    : {job['job_id']}")
-    typer.echo(f"  status    : {job['status']}")
-    typer.echo(f"  priority  : {_priority_label(job['priority'])}")
-    typer.echo(f"  submitted : {job['submitted_at']}")
-    typer.echo(f"  started   : {job['started_at'] or '(미시작)'}")
-    typer.echo(f"  finished  : {job['finished_at'] or '(미완료)'}")
-    if job["error"]:
-        typer.echo(f"  error     : {job['error']}")
-
-
-@app.command()
-def result(
-    job_id: Annotated[str, typer.Option(help="작업 ID")],
-) -> None:
-    """작업 결과 조회"""
-    with _get_client(_address) as client:
-        job = client.get_job_result(job_id)
-    typer.echo(f"  job_id : {job['job_id']}")
-    typer.echo(f"  status : {job['status']}")
-    for i, r in enumerate(job["results"]):
-        typer.echo(f"  [회로 {i}] counts : {r['counts_json']}")
-
-
-@app.command()
-def cancel(
-    job_id: Annotated[str, typer.Option(help="작업 ID")],
-) -> None:
-    """작업 취소 (PENDING 상태일 때만 가능)"""
-    with _get_client(_address) as client:
-        message = client.cancel_job(job_id)
-    typer.echo(f"✓ {message}")
-
-
-def main() -> None:
-    app()
-
-
-if __name__ == "__main__":
-    main()