Function run_get_node

agent/src/opentrace_agent/cli/get_node.py:75–110

Entry point for the get-node subcommand. Raises ``click.ClickException`` when the node id is not in the graph — exit code 1 with a one-line stderr message, no traceback.

(node_id: str, db_path: str, *, output_json: bool = False)

def run_get_node(node_id: str, db_path: str, *, output_json: bool = False) -> None:
    """Entry point for the get-node subcommand.

    Raises ``click.ClickException`` when the node id is not in the
    graph — exit code 1 with a one-line stderr message, no traceback.
    """
    from opentrace_agent.store import GraphStore

    store = GraphStore(db_path, read_only=True)
    try:
        node = store.get_node(node_id)
        if node is None:
            raise click.ClickException(f"Node not found: {node_id}")

        try:
            raw = store.traverse(node_id, direction="both", max_depth=1)
        except ValueError:
            # store.traverse re-checks node existence and raises if it
            # vanished between the get_node above and the traversal —
            # treat as "no neighbors" rather than failing the whole call.
            raw = []

        neighbors = [_classify_neighbor(node_id, entry) for entry in raw]

        if output_json:
            click.echo(
                json.dumps(
                    {"node": _node_to_dict(node), "neighbors": neighbors},
                    indent=2,
                    default=str,
                )
            )
        else:
            _emit_text(node, neighbors)
    finally:
        store.close()


def _emit_text(node: dict[str, Any], neighbors: list[dict[str, Any]]) -> None: