Code Craft AI Sysman UEFI
The codecraftai-sysman-uefi package is the firmware-management tier of the codecraftai-sysman-* suite. It manages the UEFI firmware on the host the package runs on — boot entries and boot order, Secure Boot state and MOK enrollment, raw EFI NVRAM variables, UEFI capsule firmware updates, and the EFI System Partition — exposed through the same ICommandRunner / IFileOperator interfaces and Aspects-style behaviour parameters used elsewhere in the suite.
Unlike the per-OS codecraftai-sysman-* packages, each manager in this package detects the running host OS at construction time and internally dispatches every verb to a host-OS-specific command builder (efibootmgr / mokutil / efivar / fwupdmgr on Linux, bless / nvram / bputil / diskutil on macOS, bcdedit / PowerShell Uefi module / PSWindowsUpdate / mountvol on Windows).
Status
5 firmware features implemented (boot-management, secure-boot, efi-variables, capsule-update, esp-management). Test suite: 175/175 passing under testbase. See specs/3-<feature>/ for the per-OS requirements/design/tasks for each feature.
Highlights
UefiBootManagementManager — firmware boot entries and persistent boot order.
UefiSecureBootManager — Secure Boot state, policy, and MOK management.
UefiEfiVariablesManager — raw EFI NVRAM variable read/write/delete/list.
UefiCapsuleUpdateManager — UEFI firmware capsule updates (fwupd family).
UefiEspManagementManager — EFI System Partition discovery, mount, file I/O.
override_host_os config field on every manager so dispatch paths can be exercised from any developer workstation.
Repository Structure
development/ - Runtime environment scripts.
repository-setup/ - Repository homing and setup scripts.
source/packages/ccai/sysman/uefi/ - Implementation modules.
source/testroots/testbase/ccai/tests/sysman/uefi/ - testbase test suite.
specs/ - Feature specifications organised by phase and domain area.
userguide/ - Standards, conventions, and documentation.
Environment Setup
When working in a Codex container:
./development/setup-agent-containerFor local development:
./repository-setup/rehome-repository
./development/setup-environmentRunning Tests
Activate the virtual environment and run the testbase suite:
source .venv/bin/activate
testbase testing run --root source/testroots/testbase \
--includes=testbase.ccai.tests.sysman.uefi \
--output=./.outputStandards and Conventions
Naming conventions: userguide/10-02-naming-conventions.rst
Code organization: userguide/10-01-code-organization.rst
Coding standards: userguide/10-00-coding-standards.rst
Additional Resources
User guide entry point: userguide/userguide.rst
Cross-OS contracts: ../codecraftai-sysman-common/specs/contracts/
1 maintainer
Metadata
1 maintainer
Release files for codecraftai-sysman-uefi 1.2.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| codecraftai_sysman_uefi-1.2.1.tar.gz | 51.4 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| codecraftai_sysman_uefi-1.2.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 105.2 kB
Release files / codecraftai_sysman_uefi-1.2.1.tar.gz
| Download URL | codecraftai_sysman_uefi-1.2.1.tar.gz |
|---|---|
| Size | 51.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
041917c1224860153b059e732415df3e5411ba8f5acf0ece1b91ef2807b33b39
|
|
BLAKE2b-256 checksum How to use checksums |
d2d16e429e8ee28e05d67467fc61d5e5a69d9fa1c8f3bd7631f324ea099d82eb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 20, 2026.
Transparency logRelease files / codecraftai_sysman_uefi-1.2.1-py3-none-any.whl
| Download URL | codecraftai_sysman_uefi-1.2.1-py3-none-any.whl |
|---|---|
| Size | 53.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
31bbf4bef61c76dc9fc0653b7e5be7c620b6e8782ee957caf1cff43ba96091ca
|
|
BLAKE2b-256 checksum How to use checksums |
dc5b0ea25cdc2bba633d2168158e2237e796146de96f6b60e340156c3798d5fa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 20, 2026.
Transparency logSecurity for codecraftai-sysman-uefi 1.2.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for codecraftai_sysman_uefi-1.2.1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 20, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
