feat: add manifest-driven action commands and nqctl act

Author: BB-84C

CHANGELOG.md

@@ -12,4 +12,6 @@ All notable changes to this project are documented in this file.
 - Expanded distribution readiness documentation and release tracking with concrete private-index release verification notes.
 - Updated `nqctl capabilities` to expose rich `parameters.items[*]` metadata (`get_cmd`, `set_cmd`, validators, safety) for agent-driven planning of `get`/`set`/`ramp`.
 - Updated `nqctl capabilities` to remove top-level parameter `description` output and keep descriptions on `get_cmd`/`set_cmd` only.
+- Updated manifest generation to import all callable `nanonis_spm.Nanonis` methods; non-`Get`/`Set` methods now populate root `actions` entries with `action_cmd` metadata and action safety mode.
+- Added `nqctl act <action_name> --arg key=value` with policy-aware action execution and action metadata in `nqctl capabilities` (`action_commands.items[*]`).
 - Updated GitHub-release install examples in `README.md` to use `<version>` placeholders.

README.md

@@ -58,6 +58,8 @@ python -m pip install ".[nanonis]"
 1. Optionally copy `.env.example` to `.env`.
 2. Set runtime values in `config/default_runtime.yaml`.
 3. Unified parameter specs are in `config/parameters.yaml`.
+   - `parameters`: scalar `get`/`set` mappings.
+   - `actions`: non-`Get`/`Set` backend methods with `action_cmd` metadata.
 4. Regenerate from `nanonis_spm.Nanonis` with `scripts/generate_parameters_manifest.py`.
 5. Trajectory monitor defaults are in `config/default_trajectory_monitor.yaml`.
 
@@ -89,6 +91,12 @@ Explicit guarded ramp:
 nqctl ramp bias_v 0.10 0.25 0.01 --interval-s 0.10
 ```
 
+Invoke one manifest action command:
+
+```powershell
+nqctl act Scan_Action --arg Scan_action=0 --arg Scan_direction=1
+```
+
 Inspect effective policy:
 
 ```powershell