Skip to content

docs(shell): clarify contracts and Windows qualification - #931

Open
Haoming9527 wants to merge 3 commits into
work/872-shell-reset-noticefrom
work/872-current-runtime-docs
Open

Haoming9527 wants to merge 3 commits into
work/872-shell-reset-noticefrom
work/872-current-runtime-docs

Conversation

@Haoming9527

@Haoming9527 Haoming9527 commented Nov 14, 2026 •

Copy link
Copy Markdown
Collaborator

Refs #872. Stacked on #927.

What was wrong

Current-facing Bash references still described every call as fresh, and several resident guides described implemented integrations as pending. The component reference also claimed that each invocation copied the entire Niubash payload. These statements obscured the distinction between implemented session support and the still-empty public runtime qualification inventory. The completed local Windows qualification also needed a reviewable handoff separate from deferred Linux and performance acceptance.

The change

Update the English and Chinese shell/component references with the fresh default, qualified session gate, command/state/deadline rules, reused verified runtime copies, and confirmed-reset context carried alongside the public ABORTED result. Mark the kernel and task audit/probe records as historical evidence and link their current integrations.

The public accepted-runtime inventory remains empty. Linux stopped-kernel host-death cleanup and the Windows outer create-to-Job-assignment crash interval remain explicit gaps. This documentation slice publishes no runtime and claims no complete lifecycle acceptance or performance improvement. Both adjacent bilingual changelog entries are preserved.

Add English and Chinese Windows qualification handoffs for clean unpublished adoption 511f992: the full Windows gate, four actual CLI lifecycle proof and ten process-cold activation pairs. The 200-hot-sample benchmark was stopped for the requested handoff deadline; zero hot samples were measured, so there is no performance acceptance claim. WSL/Linux qualification and both ownership gaps remain explicit follow-up work. No assets or tag are published.

Validation

  • Relative-link check over the changed Markdown files: 13 documents, 83 relative links checked, 0 missing targets.
  • git diff --check c2e046b519f7a1b44d228728da75132225fa1416 HEAD: passed, no output.
  • Diff against the verified fix(shell): disclose joined resets after cancellation #927 head: 13 documentation files, 209 insertions, 67 deletions; no implementation, test, dependency or runtime changes.
  • English and Chinese changes reviewed together. No builds or source tests were run for this documentation-only delta.
  • Earlier CI required pull-request run: 43552172801, event pull_request, passed on previous head b062c619: all 10 jobs passed, 0 failed; Windows completed 263 suites, 4 permitted skips, 0 failures, and 92 manifest checks. This is historical evidence, not the CI result for current head d84b884a.
  • Current-head CI required run: 43553884898, event pull_request, in progress on d84b884a. No current-head pass is claimed at the requested handoff deadline.
  • The separate local 511f992 qualification receipts recorded in the new guides passed 739 Rust tests (8 ignored), 263 suites (4 permitted skips), 92 manifest checks, with zero failures. Four actual CLI instances recorded 61 events, 53 PID/creation-time identities, zero survivors before emergency cleanup, and a 310047.7863 ms quiet interval. Ten process-cold activation pairs passed. Those functional receipts and observed 17–29 ms Jobs returns are not performance acceptance or public runtime distribution evidence.

Environment

Windows x64, Node v26.12.1, source checkout. Current head d84b884a29d56bdd2c1b5f5cafc28af7f5acfa93 adds the handoff after the reviewed documentation commit and normal merge of #927 head c2e046b519f7a1b44d228728da75132225fa1416. Base branch: work/872-shell-reset-notice. Qualification source 511f9920044c1aa38d7ca8443e1a6e26f7bc61c5 is a separate local unpublished adoption checkout; its receipts are identified by hashes in the guides. No package installation or deployment is part of this change.

@Haoming9527 Haoming9527 changed the title docs(shell): align runtime contracts and historical evidence docs(shell): clarify contracts and Windows qualification Nov 14, 2026
@Haoming9527
Haoming9527 marked this pull request as ready for review November 14, 2026 04:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant