update docs and comments

This commit is contained in:
Ian Chua
2026-07-02 19:34:04 +08:00
parent ecddf3d18f
commit 25b29c0b53
6 changed files with 95 additions and 56 deletions

View File

@@ -31,7 +31,7 @@ public:
~PluginManager();
// Initialize plugin system (no longer initializes Python — that happens lazily on first load_plugin)
// Initialize the plugin system, eagerly starting the embedded Python interpreter on the main thread.
bool initialize();
// Stop discovery and unload Python plugin objects before Python finalizes.

View File

@@ -622,8 +622,9 @@ bool PythonInterpreter::initialize()
BOOST_LOG_TRIVIAL(info) << "Bundled uv executable not found";
// Install the CPython audit hook for plugin policy enforcement.
// This is defense-in-depth: it monitors file/subprocess/socket/ctypes
// access from plugin code. It is NOT a full security sandbox.
// This is defense-in-depth: today it only inspects the `open` audit event
// and blocks writes outside the allowed roots; subprocess/socket/ctypes and
// other events are not yet handled. It is NOT a full security sandbox.
PluginAuditManager::instance().install_hook();
// Persist Python stderr (plugin tracebacks, including uncaught