WIP: Add native terminal cursor and display controls #2

Closed
erikinkinen wants to merge 11 commits from feature/posix-compat into main
Owner

Summary and rationale

Native pagers can now position the cursor and replace the previous screen.
Add CUP and ED2 to the existing bounded terminal decoder, with matching
framebuffer and geometry-only behavior. Keep the existing relative controls,
caret overlay and duplicate-PR CI guard.

Tracking and scope

Console controls #3,
component audit #1,
manual reader and
phase completion.

The component audit and matching-image acceptance remain open.

Architecture, authority and failure behavior

CUP uses one-based defaults and clamps to the selected geometry. ED2 clears
visible pixels without moving the cursor or touching stride padding/trailing
memory. Partial, malformed and overflowing sequences cannot cause partial effects.
The original caret is removed before mutation and restored afterward; writer
suspension discards incomplete sequences. Trusted/log text retains literal rendering.

The caller still owns the framebuffer borrow. There is no new allocation,
unsafe code, dependency, mapping, endpoint or terminal-mode authority.

Validation evidence

At dacc83ca,
24 unit tests, formatting, strict hosted/freestanding Clippy and checks,
warning-denied rustdoc/doctests, Markdown and the complete source policy pass.
CI59 also passes.
The initial fixture import error is fixed; matching-image/VM acceptance is pending.

Review checklist

  • Original implementation; Cargo dependencies and authority boundary preserved.
  • Signed commits, useful rustdoc and code files below 1,000 lines.
  • Pixel, fragment, malformed-input, fallback and trusted-writer controls.
  • README, architecture, roadmap and technical manual updated.
  • Shared governance/templates unchanged; linked issues and metadata updated.
  • Complete component audit and matching-image consumer acceptance.
## Summary and rationale Native pagers can now position the cursor and replace the previous screen. Add CUP and ED2 to the existing bounded terminal decoder, with matching framebuffer and geometry-only behavior. Keep the existing relative controls, caret overlay and duplicate-PR CI guard. ## Tracking and scope [Console controls #3](https://git.erikinkinen.fi/erix/lib-console/issues/3), [component audit #1](https://git.erikinkinen.fi/erix/lib-console/issues/1), [manual reader](https://git.erikinkinen.fi/erix/coreutils/issues/4) and [phase completion](https://git.erikinkinen.fi/erix/integration/issues/65). The component audit and matching-image acceptance remain open. ## Architecture, authority and failure behavior CUP uses one-based defaults and clamps to the selected geometry. ED2 clears visible pixels without moving the cursor or touching stride padding/trailing memory. Partial, malformed and overflowing sequences cannot cause partial effects. The original caret is removed before mutation and restored afterward; writer suspension discards incomplete sequences. Trusted/log text retains literal rendering. The caller still owns the framebuffer borrow. There is no new allocation, unsafe code, dependency, mapping, endpoint or terminal-mode authority. ## Validation evidence At [dacc83ca](https://git.erikinkinen.fi/erix/lib-console/commit/dacc83ca463ccae42f12a73e4621e4ae3c8b2ff5), 24 unit tests, formatting, strict hosted/freestanding Clippy and checks, warning-denied rustdoc/doctests, Markdown and the complete source policy pass. [CI59](https://git.erikinkinen.fi/erix/lib-console/actions/runs/59) also passes. The initial fixture import error is fixed; matching-image/VM acceptance is pending. ## Review checklist - [x] Original implementation; Cargo dependencies and authority boundary preserved. - [x] Signed commits, useful rustdoc and code files below 1,000 lines. - [x] Pixel, fragment, malformed-input, fallback and trusted-writer controls. - [x] README, architecture, roadmap and technical manual updated. - [x] Shared governance/templates unchanged; linked issues and metadata updated. - [ ] Complete component audit and matching-image consumer acceptance.
ci: Skip duplicate same-repository pull request jobs
All checks were successful
CI / markdown (push) Successful in 9s
CI / test (push) Successful in 29s
CI / markdown (pull_request) Has been skipped
CI / test (pull_request) Has been skipped
a575d61207
Skip pull-request jobs when the head and base repository names match,
since push CI already covers these branches. Retain fork pull-request,
push and manual execution and existing release publication conditions.
Apply the guard before any job steps, including Markdown validation.

Test execution and CI observation are deferred at the user's request;
no execution result is claimed for this workflow-only change.
ci: Adopt the signed original Git dependency helper
All checks were successful
CI / test (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 3s
CI / test (push) Successful in 16s
d02ce1a895
Select the verified immutable Integration helper that preserves actual
Git objects and denies registry dependencies without obsolete path
patches. Retain every duplicate same-repository PR guard. Where needed,
adopt the coherent signed ABI graph and preserve original authority and
validation budgets. Maintain canonical documentation formatting.

Tests and exact-head CI run in parallel with implementation. Earlier failed,
skipped or unrun checks remain distinct from actual passes. Keep the full
EriX guest build generations and external Rust/LLVM guest rebuild required;
no final all-repository CI success or guest completion is claimed.
ci: Adopt the signed original Git dependency helper
All checks were successful
CI / test (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 4s
CI / test (push) Successful in 17s
4c5b130dfd
Select the verified immutable Integration helper that preserves actual
Git objects and denies registry dependencies without obsolete path
patches. Retain every duplicate same-repository PR guard. Where needed,
adopt the coherent signed ABI graph and preserve original authority and
validation budgets. Maintain canonical documentation formatting.

Tests and exact-head CI run in parallel with implementation. Earlier failed,
skipped or unrun checks remain distinct from actual passes. Keep the full
EriX guest build generations and external Rust/LLVM guest rebuild required;
no final all-repository CI success or guest completion is claimed.
ci: Select the reviewed native process custody helper
Some checks failed
CI / test (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 5s
CI / test (push) Failing after 10s
9e420e2a2a
Select the coherent Integration source for dependency preparation and
native process ownership. This keeps helper inputs aligned with the
published runtime producer and refuses unsupported descriptor queries
before starting a child.
ci: Adopt the repaired native signal owner
All checks were successful
CI / test (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 25s
CI / test (push) Successful in 56s
3f556e1569
Select the coherent Integration helper that admits observed default or
ignored reserved signals while preserving complete native action identity.
Keep the existing workflow commands and limits for Integration #118.
ci: Carry checked Cargo inputs through component jobs
Some checks failed
CI / test (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 12s
CI / test (push) Failing after 23s
a79dc7147e
Prepare Cargo inputs with the selected Integration helper and carry its
workspace, environment and target directory through the existing CI steps.
Keep shared dependency and review policies aligned.

Refs: erix/integration#142
ci: Select the repaired Cargo gateway
Some checks are pending
CI / test (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / test (push) Successful in 1m14s
CI / markdown (push) Has started running
3279ac50ec
Use the shared gateway that selects installed Rust tools when a component
has no toolchain file. Keep tool selection, feature-branch resolution and
original source checks together in the pinned helper snapshot.

Refs: erix/integration#147
ci: Use the shared acquisition fix for packed Git transfers
All checks were successful
CI / test (push) Successful in 39s
CI / markdown (push) Successful in 10s
CI / test (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
f0c42deb6a
Use the shared acquisition fix for packed Git transfers. The pinned helper
keeps unexpected object-store metadata outside the acquired source context.

Refs: erix/integration#150
Support CUP row/column positioning and ED2 through the existing ordinary
terminal decoder so native pagers can replace their previous screen. Keep
fragment parsing bounded, preserve cursor/caret state and framebuffer padding,
and use the existing rectangle fill without adding authority or allocation.

Refs: #3
test: Import the second console pixel format
All checks were successful
CI / test (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 3s
CI / test (push) Successful in 24s
dacc83ca46
Bring the existing RGBA format constant into the terminal control fixture
so the new pixel-custody cases compile under both supported formats.
erikinkinen changed title from WIP: Skip duplicate same-repository pull request jobs to WIP: Add native terminal cursor and display controls 2026-10-24 01:23:15 +02:00
feat: Frame ordinary terminal UTF-8 scalars
All checks were successful
CI / test (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 5s
CI / test (push) Successful in 31s
e8faed60fa
Keep fragmented UTF-8 text in bounded writer-owned framing so each scalar
uses one native fallback cell. Share the exact actions between framebuffer
rendering and geometry, preserve ASCII control recovery after malformed
prefixes, and discard partial text at writer boundaries. Literal log and
trusted rendering keep their existing byte semantics.
Author
Owner

The ordinary terminal now frames UTF-8 scalars as single native cells in e8faed60. This supplies the shared cell model for physical manual paging, preserving the existing glyph fallback and separate literal log path.

The ordinary terminal now frames UTF-8 scalars as single native cells in [e8faed60](https://git.erikinkinen.fi/erix/lib-console/commit/e8faed60fa4da7c1c17e34da77fb452e1cb5621d). This supplies the shared cell model for [physical manual paging](https://git.erikinkinen.fi/erix/coreutils/issues/7), preserving the existing glyph fallback and separate literal log path.
erikinkinen added this to the Alpha 1 milestone 2026-10-30 09:34:38 +01:00
Author
Owner

This source is now split into feature PRs, starting at #6 and ending at #7. Each PR links its prerequisite. The complete stack preserves the runtime changes and dependency declarations; obsolete pin checkpoints and documented source-acquisition differences are separated from feature behavior.

Closing this aggregate without merging. The replacement PRs remain WIP for their remaining integration and review.

This source is now split into feature PRs, starting at #6 and ending at #7. Each PR links its prerequisite. The complete stack preserves the runtime changes and dependency declarations; obsolete pin checkpoints and documented source-acquisition differences are separated from feature behavior. Closing this aggregate without merging. The replacement PRs remain WIP for their remaining integration and review.
erikinkinen closed this pull request 2026-10-30 18:22:07 +01:00
All checks were successful
CI / test (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 5s
CI / test (push) Successful in 31s

Pull request closed

Sign in to join this conversation.
No description provided.