Expand description
Cross-platform process execution, process-tree control, PTY handling, and broker integration primitives.
The crate exposes a synchronous process API through NativeProcess, a
contained process-group helper through ContainedProcessGroup, low-level
spawn helpers through spawn() and spawn_daemon, and optional
daemon/broker modules behind feature flags.
Re-exports§
pub use console_detect::monitor_console_windows;pub use console_detect::ConsoleWindowInfo;pub use containment::ContainedProcessGroup;pub use containment::ORIGINATOR_ENV_VAR;pub use observer::CapabilitySupport;pub use observer::CategoryCapability;pub use observer::EventCategory;pub use observer::ObserverCapabilities;pub use observer::ObserverConfig;pub use observer::ObserverEvent;pub use observer::ObserverEventKind;pub use observer::ObserverSubscriber;pub use spawn::spawn;pub use spawn::spawn_daemon;pub use spawn::spawn_daemon_with_clear_env;pub use spawn::DaemonChild;pub use spawn::SpawnStdio;pub use spawn::SpawnedChild;pub use spawn::StdioSource;pub use terminal_graphics::current_terminal_capabilities;pub use terminal_graphics::current_terminal_capabilities_with_timeout;pub use terminal_graphics::detect_terminal_capabilities;pub use terminal_graphics::CapabilityStatus;pub use terminal_graphics::EvidenceStrength;pub use terminal_graphics::GraphicsCapability;pub use terminal_graphics::GraphicsProtocol;pub use terminal_graphics::TerminalCapabilities;pub use terminal_graphics::TerminalCapabilityInput;pub use terminal_graphics::TerminalGraphicsCapabilities;pub use terminal_graphics::TerminalProbeEvidence;
Modules§
- broker
- v1 broker module — schemas are FROZEN FOREVER once v1.0 ships.
- cleanup
- Standalone cleanup support for v1 broker CacheManifest files.
- client
- Synchronous IPC client for the running-process daemon.
- console_
detect - Windows console popup detection using the Win32
EnumWindowsAPI. - containment
- Process group with originator-env injection that delegates to the
two-mode
crate::spawn()surface. - maintenance
- Maintenance subcommands exposed via the
runpmCLI. - observer
- Phase 1 of #221: the process-observation capability model and the portable process-lifecycle baseline.
- proto
- Prost-generated daemon protocol types used by the client transport.
- pty
- PTY-backed process APIs.
- spawn
- Two-mode process spawning. Free functions only — no module-internal traits.
- systemd_
killmode - systemd
KillMode=control-groupdetection (#391, part of #354). - terminal_
graphics - Terminal graphics capability detection and reporting.
Macros§
- register_
payload_ protocol - Define a consumer payload-protocol constant with compile-time checks.
- rp_
rust_ debug_ scope - Create a scoped Rust debug trace label for the current function body.
Structs§
- Native
Process - A cross-platform child process with optional output capture.
- Process
Config - Configuration for
crate::NativeProcess. - RunOutput
- Captured output and exit status returned by one-shot process helpers.
- Rust
Debug Scope Guard - RAII guard that records one debug frame for the current thread.
- Stream
Event - One captured line or chunk tagged with its source stream.
Enums§
- Command
Spec - Command representation used by
ProcessConfig. - Process
Error - Error returned by process lifecycle and I/O operations.
- Read
Status - Result of a bounded process read operation.
- Stderr
Mode - Stderr handling for a spawned process.
- Stdin
Mode - Stdin behavior for a spawned process.
- Stream
Kind - Output stream selector used by process read and capture APIs.
- Unix
Signal
Functions§
- render_
rust_ debug_ traces - Render all non-empty thread debug stacks.
- run_
command - Run a command to completion while concurrently draining stdout and stderr.
- unix_
set_ priority - unix_
signal_ process - unix_
signal_ process_ group