agent-desktop/docs
Lahfir f4a505e5f6 docs: record in phases.md what 2.2 changed and what it hands over
Two gaps, one of my own making.

The client construction correction stopped being true the moment the bounded
client landed. phases.md still said 'construct with UIAutomation::new_direct()'
at the 2.2 key APIs and in the API mapping table, while the shipped code
builds from CUIAutomation8 - so the document contradicted the code, which is
the exact failure U9 exists to prevent. Both now state the construction that
ships and why: new_direct() builds CUIAutomation, which has no IUIAutomation2
and therefore no call timeout, and A14-11 measured that as a 59 s block where
the bounded client returns UIA_E_TIMEOUT in 2.05 s.

The deferrals were recorded only in the ledger and the PR, not in the
sub-phase that has to act on them. 2.4 owns the snapshot path, so 2.4's scope
now carries what 2.2 could not resolve: a target that dies mid-walk is
invisible on both the sibling axis (A14-4) and the property axis (A14-9), so a
subtree whose provider died reports complete with fewer siblings than exist,
and only descent surfaces it. A snapshot that must tell 'no more children'
from 'the app went away' needs an independent liveness check. The hang bound
is the client's connection timeout, never the operation deadline.

The hunk index moves with them, 46 to 47.
2026-07-28 18:52:02 -06:00
..
brainstorms chore: track planning artifacts with secret and privacy scanning (#109) 2026-07-26 01:41:55 -07:00
plans feat: dump uia trees in the com stack the adapter ships 2026-07-28 02:22:18 -06:00
solutions refactor!: remove speculative Win32 private-file layer from core, add real Windows/Linux test lanes (#106) 2026-07-25 23:25:28 -07:00
architecture.excalidraw
architecture.html
architecture.png
example.html
example.png
faq.md feat!: implement Playwright-grade foundation contract 2026-07-20 00:21:38 -07:00
json-output.md feat!: implement Playwright-grade foundation contract 2026-07-20 00:21:38 -07:00
phases.md docs: record in phases.md what 2.2 changed and what it hands over 2026-07-28 18:52:02 -06:00