lib-console provides shared framebuffer console primitives used by bootloader, kernel, and userspace console services.
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Erik Inkinen 99b75e08a7
All checks were successful
CI / markdown (push) Successful in 24s
CI / test (push) Successful in 1m57s
feat: Frame ordinary terminal UTF-8 scalars
Integrate the human-reviewed change from lib-console#7.
2026-11-12 18:55:16 +02:00
.github ci: Declare policy helper and output boundaries 2026-11-07 18:20:18 +02:00
src feat: Frame ordinary terminal UTF-8 scalars 2026-10-30 19:20:05 +02:00
.editorconfig Initial commit 2026-03-11 05:10:03 +01:00
.gitignore Ignore local .ci workspace 2026-04-15 21:52:47 +03:00
.markdownlint-cli2.yaml Tighten CI markdown policy 2026-05-22 15:10:13 +03:00
ARCHITECTURE.md feat: Frame ordinary terminal UTF-8 scalars 2026-10-30 19:20:05 +02:00
Cargo.toml phase3: implement lib-console framebuffer console primitives 2026-03-11 09:54:16 +02:00
CODE_OF_CONDUCT.md docs: Synchronize shared contribution and review policies 2026-09-12 06:38:14 +03:00
CONTRIBUTING.md ci: Align CI source acquisition and repository policy 2026-10-30 10:42:58 +02:00
LICENSE Initial commit 2026-03-11 05:10:03 +01:00
README.md feat: Frame ordinary terminal UTF-8 scalars 2026-10-30 19:20:05 +02:00
ROADMAP.md feat: Frame ordinary terminal UTF-8 scalars 2026-10-30 19:20:05 +02:00
rustfmt.toml lib-console: drop unstable rustfmt options for stable toolchains 2026-03-23 10:19:53 +02:00
SECURITY.md docs: Synchronize shared contribution and review policies 2026-09-12 06:38:14 +03:00

lib-console

lib-console provides shared framebuffer console primitives used by bootloader, kernel, and userspace console services.

EriX is a clean-room, capability-based microkernel operating system written entirely in Rust.

Technical requirements are tracked in the EriX requirements, conventions, and project documentation.

See:

  • docs for design documents, specifications, and development plans.
  • Related architecture repositories for kernel, services, libraries, drivers, and integration tooling.

Purpose of This Repository

This repository implements the EriX console library. Its purpose in EriX is to provide reusable console primitives and contracts to EriX components.

Functionally, it exposes the console APIs, validation tests, and documentation used by dependent repositories. The repository keeps the implementation, interface contracts, tests, and documentation for that behavior in one reviewable ownership boundary.

The maintained responsibilities are:

  • expose the lib-console crate API for console behavior used by dependent components
  • accept only canonical GRUB PF2 framing, ordinary/contextual glyph index keys, and file-relative glyph offsets
  • provide an owned validated PF2 index that callers parse once and lend to short-lived renderers without rescanning or copying its lookup table
  • preserve inherited scanout pixels until the visible page fills, then scroll the visible text rows upward by one cell row and clear only the newly exposed final row
  • encode each rectangle's pixel value once and fill checked contiguous row slices, avoiding per-pixel geometry and format revalidation
  • keep data formats, constants, and validation helpers documented and tested
  • provide an opt-in, fragmented ordinary-terminal CSI decoder with bounded relative/absolute cursor movement, row/display erasure, and a reversible caret; existing literal-text rendering stays unchanged for logs and trusted chrome
  • count each complete ordinary UTF-8 scalar as one native cell, using the existing fallback glyph for non-ASCII text; see the framing and font limits in ARCHITECTURE
  • preserve clean-room, no-external-crate implementation boundaries
  • coordinate deliberate pre-alpha API and format changes with downstream repositories

Clean-Room Policy

EriX follows a strict clean-room philosophy:

  • No external source code may be copied.
  • No external Rust crates are allowed.
  • No code generation tools that embed third-party code.
  • All code must be authored within the project.

Violations will result in rejection of the contribution.

License

All EriX repositories are licensed under the ISC License.

Development Model

EriX development is modular, deterministic, reproducible, authority-explicit, security-first, and self-hosting oriented.

This repository follows the project roadmap and the validation rules documented in its own roadmap.

Build and test

cargo fmt --all -- --check
cargo clippy --all-targets --all-features -- -D warnings
cargo test

Governance Principles

lib-console governance is scoped to reusable console contracts shared by dependent repositories.

The scoped governance rules are:

  • It must expose narrow, documented APIs rather than component-specific policy.
  • It keeps wire formats, constants, parsers, and validation helpers deterministic and testable.
  • It preserves clean-room implementation boundaries and does not introduce external crate dependencies.
  • Breaking API or format changes require coordinated updates in every dependent repository.

Library Boundaries

  • lib-console carries no runtime authority by itself; authority is held by callers that use the library.
  • The crate must not hide ambient I/O, allocation policy, or service discovery behind helper APIs.

Contact

Development occurs in EriX organization and discussions happen in issues and design documents.

No decisions are considered valid without documented rationale.

Maintainers can be reached via email: admin@erikinkinen.fi.