WIP: Read scoped offline manuals #19

Draft
erikinkinen wants to merge 5 commits from feature/native-manual-reader into feature/lexical-path-commands
Owner

Read offline manual pages through one exact READ lease without directory traversal, environment discovery or executable launch. Validate the complete index and selected bytes before display; use paging only through authenticated fixed terminal aliases.

Depends on #18. See the manual reader contract and the physical-page VM fixture.

  • Validate framing, identities, ordering, extents, digests and safe page bytes.
  • Retire the original lease and clear caller storage on exit and failure.
  • Preserve the source anchor through geometry changes and use plain output for dynamic redirections.
  • Cover packaging, inventories, paging and the current command set; build the native runtime.
  • Demonstrate the physical-page and terminal-lifecycle fixture on the release image.
Read offline manual pages through one exact READ lease without directory traversal, environment discovery or executable launch. Validate the complete index and selected bytes before display; use paging only through authenticated fixed terminal aliases. Depends on #18. See [the manual reader contract](https://git.erikinkinen.fi/erix/coreutils/src/branch/feature/native-manual-reader/MANUALS.md) and the [physical-page VM fixture](https://git.erikinkinen.fi/erix/coreutils/src/branch/feature/native-manual-reader/tests/vm/manual-physical.json). - [x] Validate framing, identities, ordering, extents, digests and safe page bytes. - [x] Retire the original lease and clear caller storage on exit and failure. - [x] Preserve the source anchor through geometry changes and use plain output for dynamic redirections. - [x] Cover packaging, inventories, paging and the current command set; build the native runtime. - [ ] Demonstrate the physical-page and terminal-lifecycle fixture on the release image.
erikinkinen added this to the Alpha 1 milestone 2026-10-30 12:04:52 +01:00
feat: Read scoped offline manuals
Some checks failed
CI / rust (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 5s
CI / rust (push) Failing after 56s
7ed86add18
Read indexed pages from the admitted manual store and paginate them using the terminal geometry. Preserve search and resize state within the selected snapshot.
ci: Use shared development dependency profiles
Some checks failed
CI / rust (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 8s
CI / rust (push) Failing after 38s
a939e3b37c
Keep authored manifests on main and select coordinated providers through Integration. Resolve branches once per run, retain the frozen snapshot and helper identity as artifacts, and use shared source checks instead of copied tests and guides.
ci: Declare policy helper and output boundaries
Some checks failed
CI / rust (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 7s
CI / rust (push) Failing after 1m49s
9972c73b49
Select a disjoint operation parent for policy evidence and explicitly identify the helper checkout excluded from original component input. Keep the complete dependency policy and existing acceptance commands.
ci: Select the counted directory protocol provider
Some checks failed
CI / rust (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 3s
CI / rust (push) Failing after 1m41s
55c8995604
The directory and raw path consumer requires the V2 IPC contracts. Select their public provider branch explicitly while preserving the original remaining providers and frozen source checks.
test: Bind manual composition to the current command inventory
All checks were successful
CI / rust (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 3s
CI / rust (push) Successful in 1m22s
6dc1ca46d4
The manual-reader feature precedes cmp. Keep its independent expected command set at this feature boundary, derive the fixture row counts from that set, and retain exact page-byte, digest and payload-extent checks.
Author
Owner

The counted-protocol build failure and the physical fixture’s premature cmp inventory entry are fixed. All original component gates now pass. The remaining work is the physical-page VM demonstration listed above.

The counted-protocol build failure and the physical fixture’s premature cmp inventory entry are fixed. All original component gates now pass. The remaining work is the physical-page VM demonstration listed above.
All checks were successful
CI / rust (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 3s
CI / rust (push) Successful in 1m22s
This pull request has changes conflicting with the target branch.
  • .github/workflows/ci.yml
  • README.md
View command line instructions

Manual merge helper

Use this merge commit message when completing the merge manually.

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin 'feature/native-manual-reader:feature/native-manual-reader'
git switch 'feature/native-manual-reader'

Merge

Merge the changes and update on Forgejo.

Warning: The "Autodetect manual merge" setting is not enabled for this repository, you will have to mark this pull request as manually merged afterwards.

git switch 'feature/lexical-path-commands'
git merge --no-ff 'feature/native-manual-reader'
git switch 'feature/native-manual-reader'
git rebase 'feature/lexical-path-commands'
git switch 'feature/lexical-path-commands'
git merge --ff-only 'feature/native-manual-reader'
git switch 'feature/native-manual-reader'
git rebase 'feature/lexical-path-commands'
git switch 'feature/lexical-path-commands'
git merge --no-ff 'feature/native-manual-reader'
git switch 'feature/lexical-path-commands'
git merge --squash 'feature/native-manual-reader'
git switch 'feature/lexical-path-commands'
git merge --ff-only 'feature/native-manual-reader'
git switch 'feature/lexical-path-commands'
git merge 'feature/native-manual-reader'
git push origin 'feature/lexical-path-commands'
Sign in to join this conversation.
No description provided.