CoreShift Core is the low-level Linux and Android foundation crate for the CoreShift ecosystem.

CoreShift Core keeps direct kernel, libc, and procfs interaction in one place so higher layers can stay policy-oriented:

• CoreShift Core: low-level Linux and Android primitives
• CoreShift Engine: daemon and plugin runtime
• CoreShift Policy: policy logic and product behavior

This crate is intentionally policy-neutral. It provides mechanisms such as spawning, epoll, inotify, procfs inspection, and signal helpers. It does not make daemon lifecycle or product decisions for callers.

Core Guarantees

Core adheres to strict architectural invariants to ensure stability:

• No policy: Primitives only; no allowlists, retry plans, or fallbacks.
• No hidden threads: Work is performed on the caller's thread.
• No global state: Stateless execution; no global mutable configuration.
• No scheduler: Provides reactor primitives but does not own execution.

Public primitive modules:

• crate::android_property for direct Android system property access
• crate::fs for filesystem probes and readahead
• crate::proc for procfs helpers
• crate::signal for signal and shutdown helpers
• crate::uid for ownership lookups
• crate::spawn for explicit process spawning
• crate::reactor for fd readiness primitives
• crate::inotify for watch/decode helpers
• crate::unix_socket for Unix domain socket primitives
• crate::io for explicit drain helpers

use coreshift_core::Daemon;

use coreshift_core::ForegroundResolver;

CoreShift Core

CoreShift Core is the low-level Linux/Android primitives crate at the bottom of the CoreShift stack.

Policy / product behavior
        ↓
Engine coordination
        ↓
Core syscall and filesystem primitives

Core exposes explicit wrappers for process spawning, file descriptor handling, procfs parsing, signals, reactor primitives, inotify, Unix sockets, and filesystem preload helpers. It does not choose Android policy, foreground app behavior, package discovery, daemon protocols, or preload rules.

Documentation

• Architecture
• Preload primitives
• Testing

Release Dependency

[dependencies]
coreshift-core = "1.0.0"

License

Mozilla Public License 2.0. See LICENSE.