Crate softgpu

Expand description

SoftGPU library surface (CLI + re-exports of softgpu-core).

Modules§

agent: Virtual SoftGPU agents backed by a device profile.
error: Structured SoftGPU error taxonomy.
fidelity: Fidelity vocabulary for SoftGPU runs, diagnostics, and reports.
handle: Generation-safe packed handles.
memory: SoftGPU software memory: one host allocator behind regions and AMD pools.
profile: Device profile schema with per-field provenance.
queue: SoftGPU user-mode queues: create / destroy / indexes / AQL observe.
runtime: Process-global SoftGPU runtime session (vendor-neutral).
signal: SoftGPU host signals (CPU atomics). No hardware interrupts.
trace: Structured, bounded runtime traces.

DeviceProfile: Versioned device profile document.
Error: SoftGPU error with category and human-readable context.
PackedHandle: Opaque 64-bit handle: [kind:8][generation:24][index:32].
ProfileField: A typed profile field carrying value + provenance + optional notes.
ProfileIdentity: Identity advertised through a runtime adapter (Phase 2+).
Runtime: SoftGPU runtime state.
TraceLog: In-memory ring with a fixed capacity.
VirtualAgent: One virtual agent instance.

AgentInfoAttr: Attributes SoftGPU may answer for an agent.
AgentKind: SoftGPU agent device class (vendor-neutral).
CapabilityProvenance: How a profile field was established.
ErrorCategory: High-level error categories used across SoftGPU surfaces.
FidelityLevel: Declared fidelity level for a SoftGPU result or advertisement.
HandleKind: Discriminator stored in the high bits of a packed handle.
RuntimeError: Errors returned by the vendor-neutral runtime (mapped to HSA at the edge).
SupportState: Machine-readable support verification state (support matrix cells).
TraceEvent: Stable event categories for SoftGPU runtime observation.

ACTIVE_PHASE: Active roadmap phase label for this crate revision.
AGENT_FEATURE_KERNEL_DISPATCH: HSA_AGENT_FEATURE_KERNEL_DISPATCH — SoftGPU queue + AQL intercept claim only.
VERSION: SoftGPU core crate version.