Assess the blast radius of a shell command.

Splits chained commands on &&, ||, ;, and |, then parses, resolves, and scores each segment independently. The top-level fields surface the worst step's score and recommendation; the chain field contains every step's individual breakdown.

When project_root is provided and no graph database exists yet, the graph is built automatically on the first call. Use index_project to force a rebuild.

Args: command: Raw shell command string to analyze. cwd: Working directory for resolving relative paths. Defaults to the server's current working directory. project_root: Root directory of the project for graph-based scoring. If provided, the graph is auto-built when missing.

Returns: Structured risk assessment with worst-step score, severity, recommendation, and per-step chain breakdown.

Example::

assess_command("cd /tmp && rm -rf .", cwd="/home/user", project_root="/project")

Build or refresh the dependency graph for a project.

Forces a graph rebuild for the given project root. Normally not required — assess_command auto-builds the graph on first use — but useful to refresh after a large code change.

Args: project_root: Absolute path to the project root directory.

Returns: Status dict confirming the project was indexed.

Example::

index_project("/home/user/my-project")

List undo snapshots captured before risky commands, newest first.

Snapshots are taken automatically by the PreToolUse hook before a medium-or-higher risk command and stored under <project_root>/.blast-scope/snapshots.

Args: project_root: The project root the snapshots were taken under.

Returns: {"snapshots": [{id, created, reason, paths}, ...]}.

Example::

list_snapshots("/home/user/my-project")

Undo a risky command by restoring a snapshot's files in place.

Overwrites whatever currently exists at each snapshotted path with the archived copy. Use list_snapshots to find the id.

Args: snapshot_id: The snapshot id to restore. project_root: The project root the snapshot was taken under.

Returns: {"status": "restored", "paths": [...]} or an error entry.

Example::

restore_snapshot("20260530T101500-a1b2c3", "/home/user/my-project")