> 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/phase03-session05-web-orchestration-cockpit-controls/tasks.md). # Task Checklist **Session ID**: `phase03-session05-web-orchestration-cockpit-controls` **Total Tasks**: 23 **Estimated Duration**: 3-4 hours **Created**: 2026-05-29 *** ## Legend * `[x]` = Completed * `[ ]` = Pending * `[P]` = Parallelizable (can run with other \[P] tasks) * `[SNNMM]` = Session reference (NN=phase number, MM=session number) * `TNNN` = Task ID *** ## Progress Summary | Category | Total | Done | Remaining | | -------------- | ------ | ------ | --------- | | Setup | 3 | 3 | 0 | | Foundation | 6 | 6 | 0 | | Implementation | 11 | 11 | 0 | | Testing | 3 | 3 | 0 | | **Total** | **23** | **23** | **0** | *** ## Setup (3 tasks) Initial configuration and environment preparation. ### Cross-package * [x] T001 \[S0305] Verify Session 05 prerequisites, completed Session 02/03/04 dependencies, and web orchestration owner rows (`.spec_system/PRD/phase_03/orchestration_gap_matrix.md`) * [x] T002 \[S0305] Create implementation notes and security artifact placeholders (`.spec_system/specs/phase03-session05-web-orchestration-cockpit-controls/implementation-notes.md`) * [x] T003 \[S0305] Confirm current web shell, store, WebSocket, API, and privacy baselines (`apps/web/README_web.md`) *** ## Foundation (6 tasks) Core structures and base implementations. ### apps/server * [x] T004 \[S0305] \[P] Add WebSocket orchestration hydration context with compact queue, template, mission graph, and guarded-action frames (`apps/server/src/ws/handlers.ts`) ### apps/web * [x] T005 \[S0305] \[P] Create orchestration REST helper with auth headers, timeout, bounded parsing, and failure-path handling (`apps/web/src/lib/orchestrationApi.ts`) * [x] T006 \[S0305] \[P] Create orchestration UI copy helpers with status mapping, privacy-safe text, and exhaustive enum handling (`apps/web/src/lib/orchestrationUi.ts`) * [x] T007 \[S0305] Extend game store orchestration state, selections, and reducers for Phase 03 frames with state reset or revalidation on re-entry (`apps/web/src/store/useGameStore.ts`) * [x] T008 \[S0305] Extend cockpit surface metadata for orchestration loading, empty, offline, error, and unavailable states (`apps/web/src/lib/cockpitShell.ts`) * [x] T009 \[S0305] Confirm WebSocket frame parsing and cleanup behavior for orchestration events with cleanup on scope exit for all acquired resources (`apps/web/src/store/useWsClient.ts`) *** ## Implementation (11 tasks) Main feature implementation. ### apps/server * [x] T010 \[S0305] Wire task queue, agent template, and mission graph managers into WebSocket handler registration without changing auth, CORS, Origin, rate-limit, or body-size defaults (`apps/server/src/server.ts`) * [x] T011 \[S0305] Emit compact orchestration hydration frames on WebSocket connect with schema-aligned payloads and no sensitive raw fields (`apps/server/src/ws/handlers.ts`) ### apps/web * [x] T012 \[S0305] Create orchestration cockpit panel shell with explicit loading, empty, error, offline, and unavailable states (`apps/web/src/components/OrchestrationPanel.tsx`) * [x] T013 \[S0305] Implement queue and template sections with bounded pagination cues, validated filters, deterministic ordering, and accessible reference controls (`apps/web/src/components/OrchestrationPanel.tsx`) * [x] T014 \[S0305] Implement lineage and mission graph sections with missing-reference fallback behavior and transcript-identifier redaction (`apps/web/src/components/OrchestrationPanel.tsx`) * [x] T015 \[S0305] Implement guarded-action decision controls with duplicate-trigger prevention while in-flight, revision checks, and state reset on update (`apps/web/src/components/OrchestrationPanel.tsx`) * [x] T016 \[S0305] Wire orchestration panel into the cockpit shell without obscuring mission, roster, battlefield, or War Room stub surfaces (`apps/web/src/App.tsx`) * [x] T017 \[S0305] Synchronize queue, lineage, and guarded-action hero/mission references through existing open actions with revalidation on re-entry (`apps/web/src/store/useGameStore.ts`) * [x] T018 \[S0305] Preserve replay, export, notification, and settings privacy boundaries for orchestration frames and broad UI copy (`apps/web/src/lib/orchestrationUi.ts`) * [x] T019 \[S0305] Update web and API docs for shipped local web orchestration controls without overstating hosted, War Room, inbound-command, analytics, or remote-execution scope (`apps/web/README_web.md`) ### docs/api * [x] T020 \[S0305] Update concise API docs for web cockpit consumption of local orchestration frames and boundaries (`docs/api/README_api.md`) *** ## Testing (3 tasks) Verification and quality assurance. ### apps/server * [x] T021 \[S0305] \[P] Write server WebSocket hydration tests for compact queue, template, mission graph, guarded-action frames, and sensitive-field non-echo (`apps/server/tests/websocket.test.ts`) ### apps/web * [x] T022 \[S0305] \[P] Write web reducer, copy-helper, panel, shell, selection-sync, and privacy tests for orchestration controls (`apps/web/tests/OrchestrationPanel.test.tsx`) ### Cross-package * [x] T023 \[S0305] Run focused web/server typecheck, Vitest, browser smoke, ASCII/LF, and patch hygiene checks and record results (`.spec_system/specs/phase03-session05-web-orchestration-cockpit-controls/implementation-notes.md`) *** ## Completion Checklist Before marking session complete: * [x] All tasks marked `[x]` * [x] Focused tests passing * [x] Browser smoke validation recorded for desktop and mobile cockpit reachability * [x] All touched files ASCII-encoded * [x] implementation-notes.md updated * [x] security-compliance.md updated * [x] Ready for the validate workflow step *** ## Next Steps Run the implement workflow step to begin AI-led implementation. --- # 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/phase03-session05-web-orchestration-cockpit-controls/tasks.md?ask=&goal= ``` `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.