WIP: Audit byte primitives and caller-owned erasure #2

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

Summary and rationale

Keep byte comparison and selection contracts explicit, and provide terminal
erasure for caller-owned storage. Document public and private operations,
observable lengths, empty inputs, mixed masks and erasure lifetime limits.

Tracking and scope

The branch includes scalar contracts, volatile erasure, the exclusive byte-array
guard, component documentation and CI warning/private-item coverage. The
existing duplicate pull-request guard retains push, fork and manual runs.

Architecture, authority and failure behavior

Callers supply the input borrows and storage. Scalar helpers retain no state;
the guard erases its original array on normal drop and unwinding. Copies,
register spills, outstanding asynchronous users, termination and forgotten
guards retain their documented limits. Timing-sensitive callers must assess
their selected compiler and hardware. Cargo dependencies remain unchanged.

Validation evidence

Keep formatting, strict Clippy, units, warning-denied private-item rustdoc and
supported host/bare-metal/UEFI builds current. The undocumented-public-item
control must be rejected by missing_docs. Full CI depends on the native
description-comparison boundary tracked in
Integration #113.
Exact checkpoint results belong in review comments.

Review checklist

Checklist
  • Original change preserves dependency selections and runtime authority.
  • Signed commit uses a tagged title and an explanatory body.
  • Inline comments explain the guard; code files remain below 1,000 lines.
  • Shared template and testing manual document the same CI rule.
  • Shared governance and issue/PR template files remain unchanged.
  • Related issues and phase metadata track the implemented workflow scope.
  • No secrets, private reports or unsupported validation claims are published.
Related records and contracts
Repository Links
docs PR 4
e2fsd PR 3
integration PR 12
lib-aes PR 2
lib-constant-time PR 2
lib-fs-crypto PR 2
lib-ipc PR 2
lib-sha2 PR 2
## Summary and rationale Keep byte comparison and selection contracts explicit, and provide terminal erasure for caller-owned storage. Document public and private operations, observable lengths, empty inputs, mixed masks and erasure lifetime limits. ## Tracking and scope - [Component audit](https://git.erikinkinen.fi/erix/lib-constant-time/issues/1). - [CI coordination](https://git.erikinkinen.fi/erix/meta/issues/2). - [Phase 6 completion](https://git.erikinkinen.fi/erix/integration/issues/65). The branch includes scalar contracts, volatile erasure, the exclusive byte-array guard, component documentation and CI warning/private-item coverage. The existing duplicate pull-request guard retains push, fork and manual runs. ## Architecture, authority and failure behavior Callers supply the input borrows and storage. Scalar helpers retain no state; the guard erases its original array on normal drop and unwinding. Copies, register spills, outstanding asynchronous users, termination and forgotten guards retain their documented limits. Timing-sensitive callers must assess their selected compiler and hardware. Cargo dependencies remain unchanged. ## Validation evidence Keep formatting, strict Clippy, units, warning-denied private-item rustdoc and supported host/bare-metal/UEFI builds current. The undocumented-public-item control must be rejected by missing_docs. Full CI depends on the native description-comparison boundary tracked in [Integration #113](https://git.erikinkinen.fi/erix/integration/issues/113). Exact checkpoint results belong in review comments. ## Review checklist <details> <summary>Checklist</summary> - [x] Original change preserves dependency selections and runtime authority. - [x] Signed commit uses a tagged title and an explanatory body. - [x] Inline comments explain the guard; code files remain below 1,000 lines. - [x] Shared template and testing manual document the same CI rule. - [x] Shared governance and issue/PR template files remain unchanged. - [x] Related issues and phase metadata track the implemented workflow scope. - [x] No secrets, private reports or unsupported validation claims are published. </details> <details> <summary>Related records and contracts</summary> | Repository | Links | | --- | --- | | docs | [PR 4](https://git.erikinkinen.fi/erix/docs/pulls/4) | | e2fsd | [PR 3](https://git.erikinkinen.fi/erix/e2fsd/pulls/3) | | integration | [PR 12](https://git.erikinkinen.fi/erix/integration/pulls/12) | | lib-aes | [PR 2](https://git.erikinkinen.fi/erix/lib-aes/pulls/2) | | lib-constant-time | [PR 2](https://git.erikinkinen.fi/erix/lib-constant-time/pulls/2) | | lib-fs-crypto | [PR 2](https://git.erikinkinen.fi/erix/lib-fs-crypto/pulls/2) | | lib-ipc | [PR 2](https://git.erikinkinen.fi/erix/lib-ipc/pulls/2) | | lib-sha2 | [PR 2](https://git.erikinkinen.fi/erix/lib-sha2/pulls/2) | </details>
ci: Skip duplicate same-repository pull request jobs
All checks were successful
CI / markdown (push) Successful in 8s
CI / test (push) Successful in 26s
CI / test (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
866d619650
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.
feat: Add bounded terminal storage erasure
All checks were successful
CI / test (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 6s
CI / test (push) Successful in 17s
b37f662e17
Add volatile erasure for exclusively borrowed sealed integer storage and a
noncopyable byte-array guard. Document the exact allocation scope and unsafe
store invariant, with original storage and boundary controls.

Tests, builds, lint checks, generated documentation, VM/profiler execution and
CI observation remain deferred. Rustfmt was applied through stdin. No test
pass, warning-free build or measured performance improvement is claimed.
Full EriX guest generations and external Rust/LLVM guest rebuilding remain
required and unperformed.
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
cfd25cdaf9
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 / markdown (pull_request) Has been skipped
CI / test (pull_request) Has been skipped
CI / markdown (push) Successful in 3s
CI / test (push) Successful in 16s
6001f96415
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.
docs: Describe component responsibilities and remaining work clearly
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 16s
90dc88c7e7
Replace generic repository descriptions with the component responsibilities
and caller obligations. Correct stale or duplicated wording while retaining
technical constraints, existing links and the documentation structure.
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 11s
09eb7ecbd5
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.
docs: Remove the superseded testing deferral
Some checks failed
CI / test (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 3s
CI / test (push) Failing after 6s
ba813d3c23
Remove the outdated execution-waiver instruction from the roadmap so it reflects the active development workflow. Retain the component contract and open conformance, lifecycle and guest requirements.
docs: Document byte and erasure contracts
All checks were successful
CI / test (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 7s
CI / test (push) Successful in 37s
df77edda51
Clarify scalar results, observable lengths and caller-owned erasure limits, including private implementations and fixtures. Replace generic component prose and make private-item documentation and build warnings CI errors.
erikinkinen changed title from WIP: Skip duplicate same-repository pull request jobs to WIP: Audit byte primitives and caller-owned erasure 2026-10-13 06:53:20 +02:00
Author
Owner

The signed checkpoint completes the public/private inline documentation review. It clarifies all 19 functions and fixtures, replaces generic component prose, and makes build/doc warnings and private-item documentation part of CI. Scalar implementations, APIs and test oracles are unchanged. The wider authority/quality audit, consumer review and compiler/hardware timing work remain open.

The [signed checkpoint](https://git.erikinkinen.fi/erix/lib-constant-time/commit/df77edda511b4f80331b02466e45047c486c3147) completes the public/private inline documentation review. It clarifies all 19 functions and fixtures, replaces generic component prose, and makes build/doc warnings and private-item documentation part of CI. Scalar implementations, APIs and test oracles are unchanged. The wider authority/quality audit, consumer review and compiler/hardware timing work remain open.
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 17s
CI / test (push) Successful in 52s
df7ab0a89a
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 are pending
CI / test (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / test (push) Has started running
CI / markdown (push) Has started running
8384594054
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) Has started running
CI / markdown (push) Has started running
91056f9551
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 (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 11s
CI / test (push) Successful in 38s
99e6d83811
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
erikinkinen added this to the Alpha 1 milestone 2026-10-30 09:34:38 +01:00
Author
Owner

Replaced by #4. These feature branches preserve the original source in separate changes. Closing this combined PR without merging it; the original branch is retained.

Replaced by [#4](https://git.erikinkinen.fi/erix/lib-constant-time/pulls/4). These feature branches preserve the original source in separate changes. Closing this combined PR without merging it; the original branch is retained.
erikinkinen closed this pull request 2026-10-30 15:25:24 +01:00
All checks were successful
CI / test (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / test (push) Successful in 38s
CI / markdown (push) Successful in 11s

Pull request closed

Sign in to join this conversation.
No description provided.