> For the complete documentation index, see [llms.txt](https://faction-os.gitbook.io/faction-os-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://faction-os.gitbook.io/faction-os-docs/.spec_system/archive/sessions/phase08-session06-mobile-and-accessibility-certification-evidence/implementation-notes.md).

# Implementation Notes

**Session ID**: `phase08-session06-mobile-and-accessibility-certification-evidence` **Package**: apps/web **Started**: 2026-05-31 03:17 **Last Updated**: 2026-05-31 03:48

***

## Session Progress

| Metric              | Value   |
| ------------------- | ------- |
| Tasks Completed     | 21 / 21 |
| Estimated Remaining | 0 hours |
| Blockers            | 0       |

***

## Evidence Scope

* Release surfaces: web cockpit, War Room, settings, replay, export, scan, notifications, local erasure controls, public demo splash, public demo cockpit, battlefield, roster, mission log, audio visible equivalents, offline shell, and release-critical overlays.
* Evidence classes: automated Playwright desktop/mobile app coverage, automated Playwright desktop/mobile public-demo coverage, focused Vitest component regressions, source-controlled screenshots, documentation review, and explicit manual-review status.
* Certification boundary: this session records local browser and component evidence only. It does not claim formal WCAG certification, physical-device mobile certification, third-party audit results, or production-hosted validation.
* Hosted boundary: hosted identity, analytics capture, Web Push delivery, public replay hosting, remote access, Cloudflare Tunnel, provider credentials, real executors, and trusted unified erasure remain out of scope unless separately evidenced.

***

## Task Log

### 2026-05-31 - Session Start

**Environment verified**:

* [x] Analyzer state loaded from `.spec_system/scripts/analyze-project.sh --json`
* [x] Package context resolved to `apps/web`
* [x] Prerequisites confirmed with `.spec_system/scripts/check-prereqs.sh --json --env --package apps/web`
* [x] Directory structure ready

***

### Task T001 - Verify analyzer state and Phase 08 routing

**Started**: 2026-05-31 03:16 **Completed**: 2026-05-31 03:17 **Duration**: 1 minute

**Notes**:

* Analyzer resolved current session `phase08-session06-mobile-and-accessibility-certification-evidence`.
* Current phase is 8, package context is `apps/web`, and candidate Session 06 routes to `.spec_system/PRD/phase_08/session_06_mobile_and_accessibility_certification_evidence.md`.
* Analyzer lists Sessions 01-05 as completed before this session.
* Environment prereqs passed for `.spec_system`, `jq`, `git`, npm workspace, and `apps/web` manifest.

**Files Changed**:

* `.spec_system/specs/phase08-session06-mobile-and-accessibility-certification-evidence/implementation-notes.md` - initialized implementation notes and recorded verification.

**BQC Fixes**:

* N/A - setup verification only.

***

### Task T002 - Review Phase 06 checklist and current evidence boundaries

**Started**: 2026-05-31 03:17 **Completed**: 2026-05-31 03:18 **Duration**: 1 minute

**Notes**:

* Reviewed `.spec_system/archive/phases/phase_06/mobile_accessibility_acceptance_checklist.md` for viewport, text-fit, keyboard, touch, semantics, focus-return, reduced-motion, failure-state, privacy, and evidence requirements.
* Reviewed `playwright.config.ts`, `tests/e2e/support/browserGuards.ts`, `tests/e2e/app.e2e.ts`, `tests/e2e/public-demo.e2e.ts`, and `apps/web/tests/MobileAccessibility.test.tsx` for current browser and component evidence patterns.
* Reviewed `apps/web/README_web.md`, `public-demo/docs_public-demo/validation.md`, `docs/release.md`, and `.spec_system/PRD/phase_08/release_requirements_risk_baseline.md` for release no-overclaim boundaries.
* Confirmed Session 06 must treat automated browser evidence as local evidence only and must not imply formal WCAG, physical-device, or production-hosted certification.

**Files Changed**:

* `.spec_system/specs/phase08-session06-mobile-and-accessibility-certification-evidence/implementation-notes.md` - recorded source review.

**BQC Fixes**:

* N/A - source review only.

***

### Task T003 - Create implementation notes with evidence scope

**Started**: 2026-05-31 03:17 **Completed**: 2026-05-31 03:18 **Duration**: 1 minute

**Notes**:

* Created this implementation notes file with evidence scope, supported release surfaces, evidence classes, hosted boundaries, and explicit no formal WCAG/mobile certification claim.
* Initialized progress, environment verification, and task log sections for per-task updates.

**Files Changed**:

* `.spec_system/specs/phase08-session06-mobile-and-accessibility-certification-evidence/implementation-notes.md` - created session implementation notes.

**BQC Fixes**:

* N/A - documentation/setup only.

***

### Task T004 - Create Phase 08 mobile/accessibility evidence artifact

**Started**: 2026-05-31 03:18 **Completed**: 2026-05-31 03:19 **Duration**: 1 minute

**Notes**:

* Created the Phase 08 evidence artifact with supported surfaces, viewport classes, evidence classes, command list, browser guard criteria, screenshot retention names, manual-review slots, unsupported claims, residual risks, and Session 07/08 handoff.
* Kept certification language explicit: local Playwright and component evidence does not prove formal WCAG certification, physical-device mobile certification, third-party audit completion, or production-hosted validation.

**Files Changed**:

* `.spec_system/PRD/phase_08/mobile_accessibility_certification_evidence.md` - added Session 06 evidence criteria and no-overclaim boundary.

**BQC Fixes**:

* N/A - evidence documentation only.

***

### Task T005 - Extend browser guard helpers

**Started**: 2026-05-31 03:19 **Completed**: 2026-05-31 03:20 **Duration**: 1 minute

**Notes**:

* Added reusable helpers for visible text fit, interactive accessible names, and contrast-critical text.
* Helper diagnostics report structural descriptors, dimensions, state, and text length instead of raw visible text.
* Text-fit checks avoid flagging normal visible or scrollable containers as clipping failures.

**Files Changed**:

* `tests/e2e/support/browserGuards.ts` - added text-fit, accessible-name, and contrast-critical evidence helpers with sanitized diagnostics.

**BQC Fixes**:

* Error information boundaries: failure diagnostics avoid raw visible text and keep sensitive evidence out of test output.
* Contract alignment: helpers use Playwright soft expectations consistently with existing browser guard helpers.

***

### Task T006 - Extend app browser evidence setup

**Started**: 2026-05-31 03:20 **Completed**: 2026-05-31 03:24 **Duration**: 4 minutes

**Notes**:

* Added an app Playwright evidence path for Settings, notifications, analytics no-runtime copy, scan empty/disabled state, local erasure boundary copy, replay panel empty state, and command-palette export discovery.
* The evidence path checks re-entry reset for local erasure confirmation fields after the Settings drawer closes and reopens.
* Added release screenshots for settings/local erasure, replay, and replay/export/scan discovery.

**Files Changed**:

* `tests/e2e/app.e2e.ts` - added Session 06 app release evidence for settings, replay, export, scan, notifications, local erasure, focus return, text fit, accessible names, and privacy-safe visible text.

**BQC Fixes**:

* State freshness on re-entry: evidence asserts local erasure confirmation inputs reset when Settings is reopened.
* Duplicate action prevention: evidence asserts replay/share and erasure confirm actions are disabled while not eligible.
* Trust boundary enforcement: evidence asserts local-only scan, analytics, replay, and erasure boundary copy.
* Error information boundaries: evidence runs privacy-safe visible text checks over settings, replay, and command palette surfaces.

***

### Task T007 - Extend focused web mobile/accessibility component fixtures

**Started**: 2026-05-31 03:24 **Completed**: 2026-05-31 03:26 **Duration**: 2 minutes

**Notes**:

* Added component coverage for Settings drawer local-only semantics, notification/analytics/scan copy, local erasure confirmation guards, and confirmation state reset on re-entry.
* Added replay component coverage for dialog semantics, local URL-fragment no-overclaim copy, disabled ineligible actions, and focus return after close.

**Files Changed**:

* `apps/web/tests/MobileAccessibility.test.tsx` - extended focused mobile/accessibility component fixtures for settings, local erasure, replay, duplicate guards, focus return, and no-overclaim wording.

**BQC Fixes**:

* State freshness on re-entry: component test asserts local erasure confirmation state resets after Settings closes and reopens.
* Duplicate action prevention: component test asserts erasure and replay actions are disabled until eligible.
* Trust boundary enforcement: component test asserts scan, analytics, erasure, and replay copy remain local-only/no-overclaim.
* Accessibility and platform compliance: component test asserts dialog semantics and focus return for replay.

***

### Task T008 - Extend public-demo browser evidence setup

**Started**: 2026-05-31 03:26 **Completed**: 2026-05-31 03:29 **Duration**: 3 minutes

**Notes**:

* Added public-demo evidence checks for splash overflow, cockpit overflow, accessible names, text fit, privacy-safe visible text, synthetic limitation copy, and visible background-music control state.
* Added a mobile layout assertion that verifies the mobile surface orders battlefield, mission log, and roster vertically.
* Extended visible audio fallback and offline-shell evidence with text-fit, overflow, and privacy-safe checks.

**Files Changed**:

* `tests/e2e/public-demo.e2e.ts` - extended public-demo app/public mobile evidence setup and guard coverage.

**BQC Fixes**:

* Accessibility and platform compliance: evidence checks interactive accessible names on splash and cockpit controls.
* Failure path completeness: audio fallback and offline shell retain visible text evidence.
* Error information boundaries: privacy-safe visible text checks run over splash, cockpit, and audio fallback states.

***

### Task T009 - Add app cockpit shell evidence

**Started**: 2026-05-31 03:29 **Completed**: 2026-05-31 03:30 **Duration**: 1 minute

**Notes**:

* Extended the app cockpit Playwright path to cover the title-bar shell, global command controls, accessible names, title-bar text fit, grid text fit, and privacy-safe visible text.
* Existing cockpit evidence already covered desktop/mobile battlefield visibility, hero controls, no canvas dependency, region overlap, no horizontal overflow, fallback attributes, focus visibility, and screenshots.

**Files Changed**:

* `tests/e2e/app.e2e.ts` - broadened cockpit shell release evidence for desktop/mobile projects.

**BQC Fixes**:

* Accessibility and platform compliance: evidence asserts title-bar command controls expose accessible names and visible focus paths.
* Error information boundaries: evidence asserts title-bar and cockpit visible text remain privacy-safe.

***

### Task T010 - Add app settings, notifications, scan, replay, export, and local erasure evidence

**Started**: 2026-05-31 03:20 **Completed**: 2026-05-31 03:31 **Duration**: 11 minutes

**Notes**:

* Reused the new app release evidence path to assert Settings drawer state, notification status, analytics disabled/no-runtime copy, scan approved-root boundary, replay local-fragment copy, command-palette export discovery, and local erasure no-trusted-erasure wording.
* Evidence verifies local erasure confirmation fields reset when Settings closes and reopens.
* Evidence verifies ineligible replay/share and erasure actions are disabled and checks privacy-safe visible text across the surfaces.

**Files Changed**:

* `tests/e2e/app.e2e.ts` - added settings, notifications, scan, replay, export, and local erasure release evidence.

**BQC Fixes**:

* State freshness on re-entry: local erasure confirmation inputs reset after drawer re-entry.
* Duplicate action prevention: replay/share and erasure actions expose disabled states while not eligible.
* Trust boundary enforcement: copy distinguishes local scan, local replay fragments, disabled analytics runtime, and unavailable trusted erasure claims.
* Error information boundaries: privacy-safe visible text checks cover these release surfaces.

***

### Task T011 - Add app War Room and overlay evidence

**Started**: 2026-05-31 03:31 **Completed**: 2026-05-31 03:34 **Duration**: 3 minutes

**Notes**:

* Extended War Room lifecycle evidence with accessible-name, text-fit, no-overflow, privacy-safe text, remote-context boundary, local-settings boundary, and no hosted-identity/production-validation overclaim checks.
* Added desktop/mobile overlay evidence for command palette focus return, keyboard shortcuts modal focus, mission heatmap, and faction standings.
* Added retained screenshots for release heatmap, release standings, and release overlay state.

**Files Changed**:

* `tests/e2e/app.e2e.ts` - added War Room release guard assertions and release-critical overlay coverage.

**BQC Fixes**:

* State freshness on re-entry: command palette evidence verifies focus returns to the opener after Escape.
* Trust boundary enforcement: War Room evidence asserts remote context remains Worker-room-only and does not become local hero truth or settings state.
* Error information boundaries: War Room evidence rejects raw prompt/path/secret markers and runs privacy-safe visible text checks.
* Accessibility and platform compliance: overlay evidence checks dialog semantics, accessible names, close paths, and focused shortcut modal close control.

***

### Task T012 - Add component tests for semantics, labels, focus, and no-overclaim copy

**Started**: 2026-05-31 03:34 **Completed**: 2026-05-31 03:36 **Duration**: 2 minutes

**Notes**:

* Added focused component coverage for command palette dialog semantics, local-only boundary copy, export command discovery, text-fit row wrappers, Escape close, and focus return.
* Added focused component coverage for keyboard shortcuts dialog semantics, visible heading, close focus, and keyboard guidance copy.
* Existing component coverage in this file now spans cockpit regions, reduced-motion battlefield labels, hero drawer focus return, toast labels, remote Worker markers, settings/local-erasure guards, replay focus return, and command/shortcut overlays.

**Files Changed**:

* `apps/web/tests/MobileAccessibility.test.tsx` - added command palette and keyboard shortcuts mobile/accessibility regressions.

**BQC Fixes**:

* Accessibility and platform compliance: tests assert dialog semantics, input naming, close focus, and focus return.
* Trust boundary enforcement: tests assert command palette search is local and export commands remain local command rows.
* Contract alignment: tests assert command rows retain text-fit wrappers for long labels.

***

### Task T013 - Apply targeted cockpit layout fixes

**Started**: 2026-05-31 03:36 **Completed**: 2026-05-31 03:38 **Duration**: 2 minutes

**Notes**:

* Ran focused component evidence after adding cockpit, settings, replay, command, and shortcut regressions.
* No `Layout.tsx` blocker was exposed by focused evidence. Existing layout regions already expose stable labels and the browser evidence covers no-overlap/no-overflow/text-fit behavior.
* Test fixture fixes were applied in `apps/web/tests/MobileAccessibility.test.tsx` for replay-link mocks and command-palette focus timing; no production layout code change was required.

**Files Changed**:

* `apps/web/src/components/Layout.tsx` - reviewed; no code change required.
* `apps/web/tests/MobileAccessibility.test.tsx` - fixed focused test fixtures while validating the evidence.

**BQC Fixes**:

* Contract alignment: updated mocks to include the replay-link exports consumed by `ReplayPanel`.

***

### Task T014 - Apply targeted title bar shell-control fixes

**Started**: 2026-05-31 03:36 **Completed**: 2026-05-31 03:38 **Duration**: 2 minutes

**Notes**:

* Focused component evidence passed for command palette trigger, settings trigger, shortcut trigger, local server status label, and command/shortcut overlay focus behavior.
* No `TitleBar.tsx` blocker was exposed by focused evidence. Existing shell controls already expose accessible names, touch-target classes, focus-visible classes, pressed/expanded state where applicable, and explicit local-server status copy.
* The app browser evidence now covers title-bar accessible names and text fit across desktop/mobile projects.

**Files Changed**:

* `apps/web/src/components/TitleBar.tsx` - reviewed; no code change required.

**BQC Fixes**:

* N/A - no production shell-control fix was required.

***

### Task T015 - Add public-demo release evidence

**Started**: 2026-05-31 03:38 **Completed**: 2026-05-31 03:40 **Duration**: 2 minutes

**Notes**:

* Extended public-demo Playwright evidence for desktop/mobile splash, cockpit, battlefield, mission log, roster, keyboard reachability, background music visible state, voice/state visible equivalents, reduced motion, offline shell, and synthetic/no-server limitation copy.
* Added keyboard focus evidence for battlefield hero controls and mission search.
* Existing public-demo tests already retain screenshots for splash, cockpit, battlefield board, fallbacks, reduced motion, overlays, and offline shell.

**Files Changed**:

* `tests/e2e/public-demo.e2e.ts` - broadened public-demo desktop/mobile release evidence.

**BQC Fixes**:

* Accessibility and platform compliance: evidence asserts keyboard reachability and visible focus for demo hero controls and mission search.
* Failure path completeness: audio fallback, media fallback, reduced-motion, and offline shell paths retain visible evidence.
* Trust boundary enforcement: evidence asserts synthetic/no-server/no-War-Room limitation copy.

***

### Task T016 - Apply targeted public-demo fixes discovered by evidence

**Started**: 2026-05-31 03:40 **Completed**: 2026-05-31 03:43 **Duration**: 3 minutes

**Notes**:

* Focused public-demo mobile evidence found a real mobile overflow blocker in the about-section repository link and two-column mobile layout.
* Fixed the static demo about section to use one column on mobile and wrap the repository link with `break-all`.
* Corrected the evidence selector to use the native `searchbox` role for the mission search input.
* Reran the focused public-demo mobile splash/cockpit path successfully: 1 passed.

**Files Changed**:

* `public-demo/index.html` - fixed mobile about-section layout and repository link wrapping.
* `tests/e2e/public-demo.e2e.ts` - corrected search role selector and scoped text-fit checks to text-heavy demo sections.

**BQC Fixes**:

* Accessibility and platform compliance: mission search evidence now queries the actual native `searchbox` role.
* Failure path completeness: no-overflow evidence now catches mobile link wrapping without treating bounded battlefield clipping as text-content failure.
* Text fit/mobile reachability: public-demo about copy now avoids mobile horizontal overflow.

***

### Task T017 - Update UX PRD and release validation docs

**Started**: 2026-05-31 03:43 **Completed**: 2026-05-31 03:46 **Duration**: 3 minutes

**Notes**:

* Updated UX PRD Phase 08 gates with the Session 06 evidence artifact path and no formal certification boundary.
* Updated release guide with Session 06 evidence commands, files, coverage, residual risks, and no-overclaim wording.
* Updated web README with web-owned Session 06 coverage and unsupported certification/hosted/trusted-erasure claims.
* Updated public-demo validation docs with Session 06 public-demo evidence expectations, commands, and static-artifact no-overclaim wording.

**Files Changed**:

* `.spec_system/PRD/PRD_UX.md` - added Session 06 evidence boundary.
* `docs/release.md` - added Session 06 release evidence command and no-claim section.
* `apps/web/README_web.md` - added Session 06 web evidence coverage and limitations.
* `public-demo/docs_public-demo/validation.md` - added public-demo mobile/accessibility evidence section.

**BQC Fixes**:

* Trust boundary enforcement: docs distinguish local browser/component evidence from production-hosted validation, hosted identity, analytics, push, remote access, and trusted erasure.
* Contract alignment: docs point to the source-controlled evidence artifact and exact command surfaces.

***

### Task T018 - Run focused web component tests and Biome checks

**Started**: 2026-05-31 03:46 **Completed**: 2026-05-31 03:48 **Duration**: 2 minutes

**Notes**:

* `npx vitest run apps/web/tests/MobileAccessibility.test.tsx` passed: 1 file, 8 tests.
* Initial focused Biome check reported formatting diffs only.
* Applied `npx biome format --write apps/web/tests/MobileAccessibility.test.tsx tests/e2e/support/browserGuards.ts tests/e2e/app.e2e.ts tests/e2e/public-demo.e2e.ts public-demo/index.html`.
* `npx biome check apps/web/tests/MobileAccessibility.test.tsx tests/e2e/support/browserGuards.ts tests/e2e/app.e2e.ts tests/e2e/public-demo.e2e.ts public-demo/index.html` passed.

**Files Changed**:

* `apps/web/tests/MobileAccessibility.test.tsx` - formatter applied.
* `tests/e2e/support/browserGuards.ts` - formatter applied.
* `tests/e2e/app.e2e.ts` - formatter applied.
* `tests/e2e/public-demo.e2e.ts` - formatter applied.

**BQC Fixes**:

* Contract alignment: focused component and formatting checks passed after fixture updates.

***

### Task T019 - Run app and public-demo Playwright evidence projects

**Started**: 2026-05-31 03:48 **Completed**: 2026-05-31 03:48 **Duration**: Final validation sweep

**Notes**:

* Final app command passed: `npm run test:e2e -- --project=app-desktop --project=app-mobile tests/e2e/app.e2e.ts` -> 15 passed, 1 intended mobile skip.
* Final public-demo command passed: `npm run test:e2e -- --project=public-demo-desktop --project=public-demo-mobile tests/e2e/public-demo.e2e.ts` -> 14 passed, 2 intended mobile skips.
* Playwright retained screenshots under `test-results/e2e/` for the expected app and public-demo evidence surfaces.
* Focused reruns fixed and verified app War Room reconnect/leave timing, replay share eligibility timing, public-demo `testInfo` plumbing, and heatmap/mobile overflow evidence.

**Files Changed**:

* `tests/e2e/app.e2e.ts` - final app evidence assertions and timing stabilization.
* `tests/e2e/public-demo.e2e.ts` - final public-demo evidence assertion fix.
* `apps/web/src/components/KeyboardShortcutsModal.tsx` - mobile viewport reachability fix for shortcut close control.
* `apps/web/src/components/MissionHeatmap.tsx` - mobile tag row wrap and ASCII cleanup.
* `public-demo/index.html` - mobile about-section overflow fix.

**BQC Fixes**:

* State freshness and timing: War Room leave now waits for retry reconnection to finish before resetting local room context.
* Duplicate/eligibility state: replay evidence avoids asserting a volatile share-disabled state after local events are regenerated.
* Accessibility and platform compliance: shortcut modal close remains reachable on short mobile viewports; heatmap tag pills wrap instead of forcing horizontal overflow.

***

### Task T020 - Run no-overclaim and hygiene validation

**Started**: 2026-05-31 03:48 **Completed**: 2026-05-31 03:48 **Duration**: Final validation sweep

**Notes**:

* Final Biome command passed for changed tests/components/public demo files: `npx biome check apps/web/tests/MobileAccessibility.test.tsx apps/web/tests/MissionHeatmap.test.tsx apps/web/tests/KeyboardShortcutsModal.test.tsx tests/e2e/support/browserGuards.ts tests/e2e/app.e2e.ts tests/e2e/public-demo.e2e.ts apps/web/src/components/KeyboardShortcutsModal.tsx apps/web/src/components/MissionHeatmap.tsx public-demo/index.html`.
* ASCII check over changed evidence, docs, tests, and components returned no findings.
* CRLF and final-newline checks returned no findings.
* `git diff --check` passed.
* No-overclaim grep returned only explicit no-claim, unsupported-claim, or boundary language; no positive formal WCAG, physical-device certification, hosted identity, production-hosted, public replay hosting, analytics, remote execution, or trusted erasure claim was found.

**Files Changed**:

* `apps/web/src/components/MissionHeatmap.tsx` - converted pre-existing non-ASCII comments and visible symbols to ASCII because the file is touched by this session.

**BQC Fixes**:

* Trust boundary enforcement: docs and tests keep certification/hosted/trusted-erasure wording framed as unsupported claims or explicit boundaries.
* Contract alignment: formatting, ASCII, LF, and whitespace checks passed.

***

### Task T021 - Record outcomes, manual-review status, residual risks, and handoff

**Started**: 2026-05-31 03:48 **Completed**: 2026-05-31 03:48 **Duration**: Final documentation pass

**Notes**:

* Updated the Phase 08 evidence artifact with final command outcomes, screenshot retention status, manual-review status, residual risks, and Session 07/08 handoff.
* Manual review remains not performed: screenshots are retained as Playwright attachments, but no manual keyboard, screen-reader, contrast, physical-device, or third-party accessibility audit was completed.
* Residual risks remain bounded to automated local browser/component evidence, Pixel 7 emulation limits, incomplete automated contrast scope, and separate Session 05 production-hosted evidence.

**Files Changed**:

* `.spec_system/PRD/phase_08/mobile_accessibility_certification_evidence.md` - final outcomes and manual-review status.
* `.spec_system/specs/phase08-session06-mobile-and-accessibility-certification-evidence/implementation-notes.md` - final task outcomes.
* `.spec_system/specs/phase08-session06-mobile-and-accessibility-certification-evidence/tasks.md` - final checklist state.

**BQC Fixes**:

* Trust boundary enforcement: final evidence records retained screenshots without turning them into formal certification or production-hosted proof.
* Contract alignment: Session 07/08 handoff keeps media release gates, legacy decommission, and final release candidate validation separate from Session 06 local evidence.

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://faction-os.gitbook.io/faction-os-docs/.spec_system/archive/sessions/phase08-session06-mobile-and-accessibility-certification-evidence/implementation-notes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.