Expand description
Executor — converts HandlerIntents into DataStore calls.
The executor is where the complexity lives. Handlers just declare what they want; the executor figures out how to make it happen.
§Auto-executable permissions
When auto_chmod_exec is enabled (the default), the executor
ensures that files inside path-handler staged directories have
execute permissions (+x). This matches the user’s intent: files
in bin/ are there to be runnable, but execute bits can be lost
in common workflows (git on macOS, manual file creation).
Permission failures are reported as warnings in the operation
results, not hard errors — the file is still staged and added to
$PATH, it just won’t be directly runnable until the user fixes
permissions manually.
Structs§
- Executor
- Executes handler intents by dispatching to the DataStore.