Skip to content

docs(desktop): restructure package status docs into topic sections - #4507

Merged
Jason Morse (JasonVMo) merged 1 commit into
mainfrom
user/jasonvmo/driver-status-cleanup
Nov 16, 2026
Merged

Jason Morse (JasonVMo) merged 1 commit into
mainfrom
user/jasonvmo/driver-status-cleanup

Conversation

@JasonVMo

Copy link
Copy Markdown
Contributor

Platforms Impacted

  • iOS
  • macOS
  • win32 (Office)
  • windows
  • android

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.md files of desktop-driver, desktop-test, desktop-driver-mcp and storybook-desktop had 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.md files

  • ## Status overview comes first: a short paragraph, then one bullet per topic with its state, the key facts, an anchor link and the tracking issues.
  • Each topic is a ## section with ### Behavior and limits and ### Open work. Open work links the tracking issue instead of restating task lists.
  • ## Native qualification keeps 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. ## Measurements is the only section with tables.
  • ## Maintaining this document explains how to edit one topic and where the previous log lives (git show a7af2b4b2:<path>).
  • Per-run commands, counts, artifact locators and failed-attempt narratives were removed where a pull request already records them. Outstanding detail moved into the linked issues (below).

Other files

  • references/agents/repository/package-guidance.md: adds rule R-PKGDOC-010 describing the format.
  • READMEs and reference indexes of the four packages: wording now says the documents summarize the latest results instead of recording history.
  • 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.md and packages/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)

Notes for reviewers

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-cache then yarn lage buildci: failed, 173 tasks passed and 1 failed. The failing task is @fluentui-react-native/desktop-driver test: src/native/boundedCommand.test.ts (expected SIGKILL, received SIGTERM) and src/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 untouched main (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 privateStorage in packages/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.

Before After
desktop-test current-status.md: 3,636 lines, 333 KiB, dated running log 371 lines, 26.6 KiB: status overview and topic sections
desktop-driver current-status.md: 3,313 lines, 246 KiB, dated running log 342 lines, 27.8 KiB: status overview and topic sections
desktop-driver-mcp current-status.md: 874 lines, 77 KiB, dated running log 268 lines, 20.4 KiB: status overview and topic sections
storybook-desktop current-status.md: 531 lines, 33 KiB, dated running log 207 lines, 15.3 KiB: status overview and topic sections

Pull request checklist

This PR has considered (when applicable):

  • Automated Tests
  • Documentation and examples
  • Keyboard Accessibility
  • Voiceover
  • Internationalization and Right-to-left Layouts

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
@github-actions

Copy link
Copy Markdown
Contributor

Bundle size report

Tree-shaken, minified production esbuild bundles with React and React Native runtimes externalized.

Scenario Modules-Mac (Δ) Modules-Win (Δ) Size-Mac (Δ) Size-Win (Δ)
components-button 79 (+1) 80 (+1) 72.92k (-702b) 72.85k (-702b)
components-catalog 228 (+1) 229 (+1) 229.66k (+349b) 229.59k (+349b)
design-themed-root 55 (+4) 56 (+4) 56.26k (+998b) 56.18k (+998b)
design-color-lib 6 (+0) 6 (+0) 6.27k (+0b) 6.27k (+0b)
design-theme-state-legacy-source 49 (+1) 50 (+1) 52.96k (-841b) 52.89k (-841b)
design-legacy-theme 42 (+0) 42 (+0) 39.11k (+0b) 42.91k (+0b)
design-legacy-theme-from-flex 58 (+4) 58 (+4) 60.70k (+824b) 64.51k (+822b)
design-fluent-light-theme 7 (+0) 7 (+0) 18.74k (+0b) 22.59k (+0b)
design-fluent-theme 35 (+0) 35 (+0) 27.46k (+4b) 31.25k (-1b)
design-fluent-hc-theme 32 (+0) 32 (+0) 27.34k (+0b) 31.13k (+0b)
design-flex-theme 29 (-4) 29 (-4) 14.30k (-9.07k) 14.29k (-9.07k)
design-flex-cool-theme 26 (New) 26 (New) 12.51k (New) 12.50k (New)
design-flex-warm-theme 26 (-7) 26 (-7) 12.28k (-11.15k) 12.27k (-11.15k)

The job is advisory: size changes are reported but do not fail the pull request. Bundle or analysis errors still fail.


View bundle-size workflow run

@JasonVMo
Jason Morse (JasonVMo) enabled auto-merge (squash) November 16, 2026 19:49
@JasonVMo
Jason Morse (JasonVMo) merged commit 47a1be8 into main Nov 16, 2026
20 checks passed
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.

2 participants