Repository navigation
docs(desktop): restructure package status docs into topic sections - #4507
Merged
Merged
Conversation
Replace the append-only dated logs in the current-status references of desktop-test, desktop-driver, desktop-driver-mcp and storybook-desktop with a status overview followed by stable topic sections, so changes to different topics merge cleanly. Each native endpoint keeps only its latest result with a link to the pull request or issue that holds the full evidence, and open work links to its tracking issue instead of restating it. - Add R-PKGDOC-010 describing the format. - Update README, reference-index and cross-reference wording and anchors. - Preserve the macOS activation source trace in the driver remaining-work plan. - Add a changeset. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 03bf8ad5-441c-41df-9738-791afdcbb6b5
Contributor
Bundle size reportTree-shaken, minified production esbuild bundles with React and React Native runtimes externalized.
The job is advisory: size changes are reported but do not fail the pull request. Bundle or analysis errors still fail. |
Jason Morse (JasonVMo)
enabled auto-merge (squash)
November 16, 2026 19:49
Vladimir Morozov (vmoroz)
approved these changes
Nov 16, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Platforms Impacted
None. This change is documentation, repository guidance and a changeset only; no source, native or test code changes.
Description of changes
The
references/current-status.mdfiles ofdesktop-driver,desktop-test,desktop-driver-mcpandstorybook-desktophad grown into append-only dated logs (about 690 KiB combined). They duplicated the issues and pull request descriptions, and they conflicted on almost every merge because every change appended to the same place. Each file is now a status overview followed by stable topic sections, so changes that affect different topics merge cleanly.The four
current-status.mdfiles## Status overviewcomes first: a short paragraph, then one bullet per topic with its state, the key facts, an anchor link and the tracking issues.##section with### Behavior and limitsand### Open work. Open work links the tracking issue instead of restating task lists.## Native qualificationkeeps only the latest result per endpoint (macOS Fabric, macOS Paper, Windows Fabric, Win32 Paper) with a link to the pull request or issue that holds the full evidence.## Measurementsis the only section with tables.## Maintaining this documentexplains how to edit one topic and where the previous log lives (git show a7af2b4b2:<path>).Other files
references/agents/repository/package-guidance.md: adds rule R-PKGDOC-010 describing the format.packages/agentic/desktop-test/references/native-qualification.md: run records go to the pull request description or tracking issue instead of a "ledger".packages/agentic/desktop-driver/references/remaining-work.md: re-pointed three links at the new anchors, and kept the macOS activation source trace that previously lived only in the old ledger.packages/agentic/desktop-driver/references/native-helpers.mdandpackages/agentic/desktop-driver-mcp/references/tools.md: link anchors..changeset/status-topic-sections.md: patch changeset for the four packages, which ship these documents.GitHub issues (updated alongside this change, not part of the diff)
Status: Blockedfrom Infrastructure: Convert Storybook lifecycle takeover into desktop-test resource contributions #4449 and Infrastructure: Add the generalized desktop-mcp management facet #4450. Infrastructure: Qualify desktop lifecycle failure paths and maintain a support matrix #4451 stays blocked by Infrastructure: Live-qualify the desktop driver and MCP foundation on macOS, Windows, and Win32 #4441, so it is the only blocked issue in the tree.Notes for reviewers
packages/agentic/desktop-driver/references/remaining-work.md(about 125 KiB) has the same growth problem. It is left out of scope here.Related to #4435 and #4441 (neither is closed by this change).
Verification
Commands run from the repository root on the branch rebased onto
49216e359:yarn format:check: passed.yarn check-agent-instructions: passed.yarn change:check: passed.yarn lage test-links: passed (90 tasks, 0 failed).yarn clean-lage-cachethenyarn lage buildci: failed, 173 tasks passed and 1 failed. The failing task is@fluentui-react-native/desktop-drivertest:src/native/boundedCommand.test.ts(expectedSIGKILL, receivedSIGTERM) andsrc/authority/privateStorage.test.ts(10 s timeout). The result was identical before and after the rebase. This PR changes no source or test code. These timing-sensitive tests fail the same way on untouchedmain(recorded in Fix macOS physical-input postconditions and add an advisory physical CI lane #4500) and are tracked as a gap in Infrastructure: Qualify and require native Storybook CI coverage #4349.yarn test boundedCommand privateStorageinpackages/agentic/desktop-driver: passed (3 suites passed, 1 skipped; 73 tests passed, 10 skipped). Run alone, the two tests pass.Manual checks: every relative Markdown anchor in the five agentic desktop packages resolves (116 anchor links checked). Each updated issue body was read back and matches the draft. Live labels were checked so that only #4451 carries
Status: Blocked. No new tests were added because the change is documentation only.desktop-testcurrent-status.md: 3,636 lines, 333 KiB, dated running logdesktop-drivercurrent-status.md: 3,313 lines, 246 KiB, dated running logdesktop-driver-mcpcurrent-status.md: 874 lines, 77 KiB, dated running logstorybook-desktopcurrent-status.md: 531 lines, 33 KiB, dated running logPull request checklist
This PR has considered (when applicable):