agent-desktop/docs
Lahfir 31ffd5f657 docs: correct the windows sub-phase facts research disproved
Sixteen replacements, no annotations. The document is the product's source of
truth and now reads true.

The COM bootstrap is split by consumer. CoInitializeEx is right for the CLI and
wrong for the cdylib, which fails RPC_E_CHANGED_MODE against any host thread
already in an STA and whose per-thread balance can never be released from a Drop
on another thread; the library path uses CoIncrementMTAUsage, whose cookie is
thread-agnostic. MTA is recorded as a requirement rather than a preference,
because the single-threaded apartment can prevent handler removal outright.

Two things the sub-phase asserted were not reachable. Its private-file seam named
a boundary that does not exist: every write site is in core with no adapter
handle, and core may not depend on the platform crate. The document now states
that constraint and leaves the mechanism to the plan. Its CI paragraph claimed
all runners enforce clippy, isolation, and the size cap; only the macOS job does,
and the other two lanes each run a single lib invocation.

The event invariant said handlers are drained on the dedicated MTA thread. They
are not: delivery arrives on several UIA-owned threads at once, the registering
worker among them and the main thread never, so handler state has to be safe for
concurrent delivery.

Runner registration gains the hardening a public repository requires, and gains
the measurement it already owed the ledger: it closes the deferred RDP row rather
than merely documenting session isolation. The DPI bootstrap records that
awareness cannot be verified by read-back, since the query API has no enumerant
for the value being set.

The ledger's hunk index moves with them, 37 to 40. Hunks backed by research
rather than by a probe are labelled as such, so an external citation cannot pass
itself off as a measurement.
2026-07-26 23:45:25 -06:00
..
brainstorms chore: track planning artifacts with secret and privacy scanning (#109) 2026-07-26 01:41:55 -07:00
plans feat: add windows platform exploration probe corpus (phase 2.0) (#111) 2026-07-26 22:21:35 -07: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 docs: add architecture diagram to README 2026-02-24 06:22:52 -08:00
architecture.html refactor!: unify command execution contracts 2026-05-19 18:27:08 -07:00
architecture.png refactor!: unify command execution contracts 2026-05-19 18:27:08 -07:00
example.html refactor!: unify command execution contracts 2026-05-19 18:27:08 -07:00
example.png refactor!: unify command execution contracts 2026-05-19 18:27:08 -07:00
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: correct the windows sub-phase facts research disproved 2026-07-26 23:45:25 -06:00