> 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/phase14-session02-battlefield-preview-and-product-mockups/implementation-notes.md).

# Implementation Notes

**Session ID**: `phase14-session02-battlefield-preview-and-product-mockups` **Package**: public-website **Started**: 2026-06-01 20:04 **Last Updated**: 2026-06-01 20:27

***

## Session Progress

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

***

## Design Decisions

### Decision 1: Split the battlefield map from the preview shell

**Context**: The first complete component pass kept all DOM and scoped CSS in `BattlefieldPreview.astro`, which made the file too large for comfortable maintenance.

**Options Considered**:

1. Keep one component - simple import surface, but a large mixed-responsibility file.
2. Split the map visualization into a helper component - keeps the homepage section API simple while separating board geometry, routes, agents, and legend CSS.

**Chosen**: Split the map visualization into `BattlefieldMap.astro`. **Rationale**: The preview shell now owns section composition and rails, while the map helper owns coordinate geometry and marker styling. Both files remain below 600 lines.

***

## Post-Completion Quality Pass

* Split `public-website/src/components/marketing/BattlefieldMap.astro` out of `BattlefieldPreview.astro` after the first full implementation pass.
* Re-ran `npm --workspace @factionos/public-website run typecheck`; passed.
* Re-ran `npm --workspace @factionos/public-website run build`; passed.
* Re-ran browser smoke at 360px, 768px, 1280px, 1600px, reduced-motion, and keyboard focus; passed with updated screenshots.
* Re-ran ASCII and CRLF checks for touched text files; passed.

***

### Task T022 - Validate ASCII encoding and Unix LF line endings

**Started**: 2026-06-01 20:20 **Completed**: 2026-06-01 20:20 **Duration**: 1 minute

**Notes**:

* Ran non-ASCII checks over touched website text files and session text artifacts.
* Ran CRLF checks over touched website text files and session text artifacts.
* Confirmed `file` reports touched text files as ASCII text.
* Excluded PNG screenshot evidence from text encoding checks because those files are binary visual artifacts.

**Files Changed**:

* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/tasks.md` - Marked T022 complete and completed the checklist.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/implementation-notes.md` - Logged final encoding verification.

**BQC Fixes**:

* N/A - encoding and line-ending verification only.

***

### Task T021 - Manual browser smoke verification

**Started**: 2026-06-01 20:16 **Completed**: 2026-06-01 20:27 **Duration**: 11 minutes

**Notes**:

* Started the local preview at `http://127.0.0.1:4325/`.
* Captured and inspected screenshots for 360px, 768px, 1280px, wide desktop, and reduced-motion mode.
* Verified no page-level horizontal overflow at tested widths.
* Verified hero CTAs remain visible and reachable in tab order.
* Verified battlefield markers and route labels stay inside the map board.
* Verified reduced-motion mode disables route, ring, and scan animations while labels remain visible.
* Re-ran `npm --workspace @factionos/public-website run build` after the trace rail adjustment and map-component split; it passed.

**Evidence**:

* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/screenshots/mobile-360.png`
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/screenshots/tablet-768.png`
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/screenshots/desktop-1280.png`
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/screenshots/wide-1600.png`
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/screenshots/reduced-motion-768.png`

**Files Changed**:

* `public-website/src/components/marketing/BattlefieldPreview.astro` - Increased trace rail height so all four desktop trace rows are visible without partial clipping, then split map rendering into a helper component.
* `public-website/src/components/marketing/BattlefieldMap.astro` - Added map visualization helper during the maintainability pass.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/screenshots/` - Captured manual smoke screenshots.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/tasks.md` - Marked T021 complete and updated progress.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/implementation-notes.md` - Logged manual smoke results.

**BQC Fixes**:

* Accessibility and platform compliance: Verified reduced-motion static equivalence and focus reachability for existing homepage links.
* Failure path completeness: Fixed a trace rail clipping risk found during screenshot review before marking the manual check complete.

***

### Task T020 - Run static website build

**Started**: 2026-06-01 20:45 **Completed**: 2026-06-01 20:46 **Duration**: 1 minute

**Notes**:

* Ran `npm --workspace @factionos/public-website run build`.
* Astro built the static site successfully, including `/index.html`, blog/news pages, RSS, optimized images, and sitemap output.

**Files Changed**:

* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/tasks.md` - Marked T020 complete and updated progress.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/implementation-notes.md` - Logged build result.

**BQC Fixes**:

* Contract alignment: Static build verified route rendering, CSS bundling, and homepage integration.

***

### Task T019 - Run Astro typecheck

**Started**: 2026-06-01 20:44 **Completed**: 2026-06-01 20:45 **Duration**: 1 minute

**Notes**:

* Ran `npm --workspace @factionos/public-website run typecheck`.
* Astro content sync and `tsc --noEmit` completed successfully.

**Files Changed**:

* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/tasks.md` - Marked T019 complete and updated progress.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/implementation-notes.md` - Logged typecheck result.

**BQC Fixes**:

* Contract alignment: Typecheck verified component imports and homepage data typing.

***

### Task T018 - Integrate BattlefieldPreview immediately after the hero

**Started**: 2026-06-01 20:43 **Completed**: 2026-06-01 20:44 **Duration**: 1 minute

**Notes**:

* Imported `BattlefieldPreview` into the homepage route.
* Rendered the preview immediately after `HeroCockpit` inside the existing `Shell`.
* Left homepage metadata and hero CTA code unchanged.

**Files Changed**:

* `public-website/src/pages/index.astro` - Added import and rendered `BattlefieldPreview` below the hero.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/tasks.md` - Marked T018 complete and updated progress.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/implementation-notes.md` - Logged homepage integration work.

**BQC Fixes**:

* Contract alignment: Homepage integration keeps the same metadata path and first hero action surface while adding the static preview below it.

***

### Task T017 - Add mobile workpad fallback layout

**Started**: 2026-06-01 20:40 **Completed**: 2026-06-01 20:43 **Duration**: 3 minutes

**Notes**:

* Reordered the narrow layout into stacked map, trace, event, and mission summary regions.
* Added phone-width sizing for the board, route labels, agent cards, coordinate labels, legend, and rails.
* Removed the trace rail scroll cap on mobile so all static rows remain reachable in normal document flow.

**Files Changed**:

* `public-website/src/components/marketing/BattlefieldPreview.astro` - Added mobile workpad media query and stacked layout behavior.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/tasks.md` - Marked T017 complete and updated progress.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/implementation-notes.md` - Logged mobile fallback work.

**BQC Fixes**:

* Accessibility and platform compliance: Mobile panels are stacked in readable document flow with no fake controls or hidden state.
* Failure path completeness: Phone-specific dimensions reduce clipping and horizontal overflow risk for dense board labels.

***

### Task T016 - Add responsive desktop and tablet layout

**Started**: 2026-06-01 20:38 **Completed**: 2026-06-01 20:40 **Duration**: 2 minutes

**Notes**:

* Added breakpoints for narrower desktop and tablet widths.
* Preserved the 16:9 board and reflowed side panels to two-column or single-column layouts before rail content can clip.
* Reduced event and legend column counts as available width decreases.

**Files Changed**:

* `public-website/src/components/marketing/BattlefieldPreview.astro` - Added responsive desktop/tablet media queries.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/tasks.md` - Marked T016 complete and updated progress.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/implementation-notes.md` - Logged responsive layout work.

**BQC Fixes**:

* Accessibility and platform compliance: Tablet layouts keep readable text regions instead of forcing horizontal overflow.

***

### Task T015 - Add lightweight animation with reduced-motion rules

**Started**: 2026-06-01 20:36 **Completed**: 2026-06-01 20:38 **Duration**: 2 minutes

**Notes**:

* Added decorative board scan, route glow, and agent ring pulse animations.
* Added reduced-motion overrides that disable the continuous motion while leaving route labels, rings, agent states, and legend text visible.

**Files Changed**:

* `public-website/src/components/marketing/BattlefieldPreview.astro` - Added animation keyframes and reduced-motion CSS.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/tasks.md` - Marked T015 complete and updated progress.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/implementation-notes.md` - Logged animation and reduced-motion work.

**BQC Fixes**:

* Accessibility and platform compliance: Continuous animation is disabled under reduced-motion while static state indicators remain.

***

### Task T014 - Add tactical coordinate, grid, and map legend treatment

**Started**: 2026-06-01 20:32 **Completed**: 2026-06-01 20:36 **Duration**: 4 minutes

**Notes**:

* Added coordinate column and row labels from typed static data.
* Added a map legend with text labels and descriptions for every state tone.
* Kept visual dots decorative while state meaning is carried by visible label and description text.

**Files Changed**:

* `public-website/src/components/marketing/BattlefieldPreview.astro` - Added coordinate labels, legend markup, and legend CSS.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/tasks.md` - Marked T014 complete and updated progress.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/implementation-notes.md` - Logged coordinate and legend work.

**BQC Fixes**:

* Accessibility and platform compliance: Coordinates and legend are labelled lists with non-color-only state descriptions.

***

### Task T013 - Implement event stream snippets with explicit sample labels

**Started**: 2026-06-01 20:30 **Completed**: 2026-06-01 20:32 **Duration**: 2 minutes

**Notes**:

* Added explicit static timeline notice inside the event stream panel.
* Styled event rows into deterministic sample cards with visible time, label, and detail text.
* Kept event copy clear that rows are not telemetry, replay data, or hosted runtime output.

**Files Changed**:

* `public-website/src/components/marketing/BattlefieldPreview.astro` - Added event stream note and event row CSS.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/tasks.md` - Marked T013 complete and updated progress.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/implementation-notes.md` - Logged event stream work.

**BQC Fixes**:

* Trust boundary enforcement: Event stream copy explicitly rejects live telemetry and hosted runtime implications.
* Error information boundaries: Event rows expose only authored sample details.

***

### Task T012 - Implement file/tool trace rail with sanitized labels and bounded ordering

**Started**: 2026-06-01 20:27 **Completed**: 2026-06-01 20:30 **Duration**: 3 minutes

**Notes**:

* Added visible trace ordering with two-digit row markers while preserving ordered-list semantics.
* Added bounded rail styling with max height and stable scrollbar gutter.
* Styled trace rows with sanitized labels, targets, and details from the static data module.

**Files Changed**:

* `public-website/src/components/marketing/BattlefieldPreview.astro` - Added trace row indexes and bounded trace rail CSS.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/tasks.md` - Marked T012 complete and updated progress.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/implementation-notes.md` - Logged trace rail work.

**BQC Fixes**:

* Error information boundaries: The rail displays sanitized sample labels only and avoids paths, prompts, commands, and output.
* Accessibility and platform compliance: Trace order is visible and also encoded through ordered-list markup.

***

### Task T011 - Implement mission state panel with active objective and static boundary copy

**Started**: 2026-06-01 20:24 **Completed**: 2026-06-01 20:27 **Duration**: 3 minutes

**Notes**:

* Added mission posture badges, a visible active objective, and an accessible static progress meter.
* Added a typed `progressPercent` field so the meter and visible progress copy stay aligned.
* Kept boundary copy explicit that the preview does not read prompts, local paths, terminal output, visitor devices, or hosted sessions.

**Files Changed**:

* `public-website/src/data/homepage.ts` - Added numeric progress data for the static mission panel.
* `public-website/src/components/marketing/BattlefieldPreview.astro` - Added mission badges and progress meter markup/CSS.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/tasks.md` - Marked T011 complete and updated progress.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/implementation-notes.md` - Logged mission state work.

**BQC Fixes**:

* Accessibility and platform compliance: Progress has `role="meter"` with numeric and text alternatives.
* Trust boundary enforcement: Boundary copy remains visible near the mission state.

***

### Task T010 - Render agent tokens and active status rings

**Started**: 2026-06-01 20:20 **Completed**: 2026-06-01 20:24 **Duration**: 4 minutes

**Notes**:

* Added agent token rendering from typed map positions with visible names, roles, status text, status details, and ring labels.
* Added CSS status rings and tone classes for cyan, green, purple, warning, and critical states.
* Adjusted the board away from an atomic image role so route and agent lists remain semantically available.

**Files Changed**:

* `public-website/src/components/marketing/BattlefieldPreview.astro` - Added agent helper, agent list markup, and status ring CSS.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/tasks.md` - Marked T010 complete and updated progress.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/implementation-notes.md` - Logged agent rendering work.

**BQC Fixes**:

* Accessibility and platform compliance: Agent markers include visible status text and hidden ring labels, and are rendered as semantic list items rather than fake controls.
* State freshness on re-entry: No client state or hydration was introduced, so there is no stale interactive lifecycle.

***

### Task T009 - Implement battlefield map grid and mission route rendering

**Started**: 2026-06-01 20:16 **Completed**: 2026-06-01 20:20 **Duration**: 4 minutes

**Notes**:

* Added route rendering from typed route coordinates with computed CSS custom properties for start, midpoint, length, and angle.
* Added route labels and route state text directly on the map so paths do not rely on color alone.
* Kept route rendering as DOM/CSS inside static Astro; no SVG, canvas, WebGL, hydration, or runtime calls were added.

**Files Changed**:

* `public-website/src/components/marketing/BattlefieldPreview.astro` - Added route helper, route list markup, and route CSS.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/tasks.md` - Marked T009 complete and updated progress.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/implementation-notes.md` - Logged route rendering work.

**BQC Fixes**:

* Accessibility and platform compliance: Route labels expose route names and state text instead of making color carry meaning.
* Contract alignment: Route geometry is derived from the typed static data contract.

***

### Task T008 - Add base preview CSS structure with stable desktop frame

**Started**: 2026-06-01 20:12 **Completed**: 2026-06-01 20:16 **Duration**: 4 minutes

**Notes**:

* Added scoped component CSS for the section header, workpad grid, map shell, 16:9 board, panel placement, and bounded list regions.
* Kept the map frame stable with `aspect-ratio: 16 / 9` and `overflow: hidden` inside the board.
* Used `:global(...)` only where needed to place root classes passed into child `Panel` components.

**Files Changed**:

* `public-website/src/components/marketing/BattlefieldPreview.astro` - Added base layout and board CSS.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/tasks.md` - Marked T008 complete and updated progress.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/implementation-notes.md` - Logged base CSS work.

**BQC Fixes**:

* Accessibility and platform compliance: The board remains a labelled visual region with surrounding semantic data panels.
* Failure path completeness: Stable dimensions and bounded regions reduce responsive clipping risks before adding dense map elements.

***

### Task T007 - Create BattlefieldPreview shell using existing primitives

**Started**: 2026-06-01 20:09 **Completed**: 2026-06-01 20:12 **Duration**: 3 minutes

**Notes**:

* Created `BattlefieldPreview.astro` with `Section`, `Panel`, and `Badge` primitives.
* Added semantic labels for the preview section, mission map, mission state, trace rail, and event stream.
* Wired the component to typed homepage data while keeping it server-rendered Astro only.

**Files Changed**:

* `public-website/src/components/marketing/BattlefieldPreview.astro` - Added initial component shell and data rendering structure.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/tasks.md` - Marked T007 complete and updated progress.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/implementation-notes.md` - Logged component shell work.

**BQC Fixes**:

* Accessibility and platform compliance: The shell includes labelled section, map, trace, and event regions.
* Contract alignment: Component consumes the typed homepage data module.

***

### Task T006 - Define bounded file/tool trace and event stream snippets

**Started**: 2026-06-01 20:08 **Completed**: 2026-06-01 20:09 **Duration**: 1 minute

**Notes**:

* Added four trace rows and four event rows with deterministic ordering.
* Used sanitized artifact and tool-state labels rather than file paths, command bodies, raw prompts, terminal output, or user-provided content.
* Kept event wording explicit that rows are sample data from the static homepage module.

**Files Changed**:

* `public-website/src/data/homepage.ts` - Added bounded trace and event stream data.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/tasks.md` - Marked T006 complete and updated progress.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/implementation-notes.md` - Logged bounded trace and event data work.

**BQC Fixes**:

* Error information boundaries: Trace and event rows avoid internal paths, command output, prompts, and secrets.
* Contract alignment: Trace and event arrays satisfy the declared battlefield data contract.

***

### Task T005 - Define synthetic mission map, agent token, status ring, route, and coordinate data

**Started**: 2026-06-01 20:06 **Completed**: 2026-06-01 20:08 **Duration**: 2 minutes

**Notes**:

* Added `homepageBattlefieldPreview` with synthetic mission summary, map labels, agent tokens, route segments, coordinate bands, and legend entries.
* Kept all values authored sample copy with no user names, raw prompts, local paths, command output, credentials, or hosted runtime claims.
* Included non-color-only state descriptions in labels, statuses, ring labels, and legend copy.

**Files Changed**:

* `public-website/src/data/homepage.ts` - Added mission map, route, agent, coordinate, and legend sample data.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/tasks.md` - Marked T005 complete and updated progress.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/implementation-notes.md` - Logged static sample data work.

**BQC Fixes**:

* Trust boundary enforcement: Sample copy explicitly states that no prompts, local paths, terminal output, hosted sessions, or visitor device data are inspected.
* Contract alignment: Added values through the typed `HomepageBattlefieldPreview` contract.

***

### Task T004 - Extend homepage data types for battlefield agents, missions, traces, and events

**Started**: 2026-06-01 20:05 **Completed**: 2026-06-01 20:06 **Duration**: 1 minute

**Notes**:

* Added typed battlefield preview contracts for mission copy, agent positions, routes, legend entries, traces, events, and coordinate labels.
* Kept the data model deterministic and package-local so the upcoming component can render without fetching, hydration, storage, or visitor-specific state.

**Files Changed**:

* `public-website/src/data/homepage.ts` - Added battlefield preview type definitions.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/tasks.md` - Marked T004 complete and updated progress.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/implementation-notes.md` - Logged type contract work.

**BQC Fixes**:

* Trust boundary enforcement: The contract keeps all preview data static and typed in the audited homepage data module.

***

### Task T003 - Confirm marketing component placement for the battlefield preview

**Started**: 2026-06-01 20:04 **Completed**: 2026-06-01 20:05 **Duration**: 1 minute

**Notes**:

* Confirmed marketing homepage components live in `public-website/src/components/marketing`.
* Confirmed existing component conventions: import shared layout/system primitives, use typed data from `src/data/homepage.ts`, and keep visualization CSS scoped to the component.
* Chose `public-website/src/components/marketing/BattlefieldPreview.astro` as the placement specified by the session.

**Files Changed**:

* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/tasks.md` - Marked T003 complete and updated progress.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/implementation-notes.md` - Logged component placement decision.

**BQC Fixes**:

* N/A - setup review only.

***

### Task T002 - Review existing homepage hero integration and marketing component patterns

**Started**: 2026-06-01 20:04 **Completed**: 2026-06-01 20:04 **Duration**: 1 minute

**Notes**:

* Reviewed `public-website/src/pages/index.astro`; the homepage currently renders only `HeroCockpit` inside `Shell`.
* Reviewed `HeroCockpit.astro` and `LiveStatusPanel.astro` to match static data imports, scoped CSS, Section usage, terminal framing, privacy copy, and responsive patterns.
* Confirmed hero CTAs are provided by `ButtonLink` and must remain the first homepage action surface.

**Files Changed**:

* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/tasks.md` - Marked T002 complete and updated progress.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/implementation-notes.md` - Logged hero and component pattern review.

**BQC Fixes**:

* N/A - setup review only.

***

### Task T001 - Verify public website prerequisites, package commands, and static-site boundary

**Started**: 2026-06-01 20:04 **Completed**: 2026-06-01 20:04 **Duration**: 1 minute

**Notes**:

* Ran the spec analysis and prerequisite checks, including package-specific validation for `public-website`.
* Confirmed `public-website/package.json` keeps static Astro scripts and does not add server adapters, analytics, auth, forms, WebSocket, iframe, canvas, or WebGL dependencies.
* Reviewed public website README and ADRs for local-first, optional analytics, and quarantined media rules.

**Files Changed**:

* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/tasks.md` - Marked T001 complete and updated progress.
* `.spec_system/specs/phase14-session02-battlefield-preview-and-product-mockups/implementation-notes.md` - Logged prerequisite and static-boundary verification.

**BQC Fixes**:

* N/A - setup review only.

***

## Task Log

### 2026-06-01 - Session Start

**Environment verified**:

* [x] Prerequisites confirmed
* [x] Tools available
* [x] Directory structure ready
* [x] Package context resolved to `public-website`
* [x] Static-site boundary reviewed

***


---

# 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/phase14-session02-battlefield-preview-and-product-mockups/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.
