agent-desktop/docs
Lahfir 2d51c680e8 docs: plan the windows toolchain, ci, and com bootstrap sub-phase
Eight units covering the CI lane extension, Win32 bindings in the platform
crate, the COM and DPI bootstrap, the adapter session, the permission probe,
and a private-file layer rebuilt from scratch against sub-phase 2.0's measured
evidence.

Three reviewers found what the first draft got wrong. It installed both the
apartment and the private-file seam from ad_init, which the FFI header labels
optional and whose own doc promises it initialises nothing -- so any host that
skipped it would have run every private write through the unhardened default
with nothing to distinguish the two states. The install moves to the site the
macOS arm already uses, where a consumer cannot skip it.

It also planned a layer that validates security state it never authors. The
deleted implementation at least built an owner-only protected descriptor at
creation; the rebuild now does too, and rejects reparse points per component
the way the unix path rejects symlinks.

The ACE validation order was still wrong in the same shape as the defect it
exists to prevent: checking the type before forming the SID pointer still
dereferences the header at an offset nothing has bounds-checked. The order is
now extent-first, with the ACE count treated as advisory rather than trusted.

The seam routes at core's five private-file primitives rather than at a list of
call sites, which covers the lock and liveness paths a list had missed and
needs no call-site edits at all.
2026-07-27 00:14:08 -06:00
..
brainstorms chore: track planning artifacts with secret and privacy scanning (#109) 2026-07-26 01:41:55 -07:00
plans docs: plan the windows toolchain, ci, and com bootstrap sub-phase 2026-07-27 00:14:08 -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 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: move the windows runner registration to the sub-phase that needs it 2026-07-27 00:02:23 -06:00