Skip to content

docs: reconcile Windows/macOS/RDP substrate labels to Early access#56

Merged
abrichr merged 1 commit into
mainfrom
docs/substrate-early-access-labels
Jul 21, 2026
Merged

docs: reconcile Windows/macOS/RDP substrate labels to Early access#56
abrichr merged 1 commit into
mainfrom
docs/substrate-early-access-labels

Conversation

@abrichr

@abrichr abrichr commented Jul 21, 2026

Copy link
Copy Markdown
Member

What

Reconcile the substrate-maturity labels in docs.openadapt.ai to the now-canonical status.json vocabulary (Beta / Early access / Exploratory / Research). Windows UIA, native macOS, and RDP still read the retired "Supported / scoped deployment" wording; this renames them to Early access.

Why

status.json (openadapt-web) is the single source of truth for substrate maturity. Browser=Beta, Windows/macOS/RDP=Early access, Citrix/VDI=Exploratory, Linux=Research. Citrix was already correctly Exploratory here; the desktop substrates lagged the canonical ladder.

Changes

  • docs/get-started/what-works-today.md: tier legend now defines Early access (works, validated on specific named tasks, not yet broadly exercised) + the Windows/macOS/RDP matrix rows.
  • docs/guides/hosted.md: Windows/macOS/RDP matrix rows.
  • tests/test_substrate_evidence_copy.py: honesty guard's expected marker updated to Early access (same pattern as the earlier Citrix->Exploratory reconciliation).

Preserved (unchanged pinned evidence)

Run counts, oracle results, immutable commit hashes, Flow PR numbers, and every per-surface boundary column are untouched. Citrix/VDI stays Exploratory. Only the maturity label changed.

Gates (all green)

  • mkdocs build --strict -> exit 0
  • pytest tests/ -> 68 passed
  • python scripts/validate_docs.py -> Validation passed!

Auto-deploys on merge.

status.json is the single source of truth for substrate maturity tiers
(Beta / Early access / Exploratory / Research). Windows UIA, native macOS,
and RDP still read the retired "Supported / scoped deployment" vocabulary;
rename them to the canonical "Early access" label.

- what-works-today.md: update the tier legend to define Early access
  (works, validated on specific named tasks, not yet broadly exercised)
  and the Windows/macOS/RDP matrix rows.
- hosted.md: update the Windows/macOS/RDP matrix rows.
- test_substrate_evidence_copy.py: update the honesty guard's expected
  marker to Early access, matching the earlier Citrix->Exploratory
  reconciliation.

All pinned evidence (run counts, oracle results, immutable commit hashes,
Flow PR numbers, per-surface boundaries) is unchanged. Citrix/VDI stays
Exploratory. mkdocs build --strict, pytest tests/, and validate_docs.py
remain green.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NyCHrzA1psrKMFfroYbzaM
@abrichr
abrichr merged commit d23d4f1 into main Jul 21, 2026
5 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.

1 participant