> 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/phase18-session11-validation-documentation-and-handoff/tasks.md).

# Task Checklist

**Session ID**: `phase18-session11-validation-documentation-and-handoff` **Total Tasks**: 24 **Estimated Duration**: 3-4 hours **Created**: 2026-06-10

***

## Legend

* `[x]` = Completed
* `[ ]` = Pending
* `[P]` = Parallelizable (can run with other \[P] tasks)
* `[S1811]` = Session reference (phase 18, session 11)
* `TNNN` = Task ID

***

## Progress Summary

| Category       | Total  | Done   | Remaining |
| -------------- | ------ | ------ | --------- |
| Setup          | 3      | 3      | 0         |
| Foundation     | 5      | 5      | 0         |
| Implementation | 11     | 11     | 0         |
| Testing        | 5      | 5      | 0         |
| **Total**      | **24** | **24** | **0**     |

***

## Setup (3 tasks)

Session closeout inventory and acceptance mapping.

* [x] T001 \[S1811] Review the Phase 18 PRD, Session 11 stub, and Sessions 01-10 validation evidence to build the Quest Board acceptance matrix (`.spec_system/specs/phase18-session11-validation-documentation-and-handoff/phase18-validation-record.md`)
* [x] T002 \[S1811] Inventory stable docs and current source coverage for API routes, protocol contracts, server engines, web cards, keyboard shortcuts, privacy inventory, prompt docs, and unsupported routes (`.spec_system/specs/phase18-session11-validation-documentation-and-handoff/phase18-docs-handoff.md`)
* [x] T003 \[S1811] Verify no earlier-session blockers remain and define temporary local validation state, redaction rules, and broad gate commands (`.spec_system/specs/phase18-session11-validation-documentation-and-handoff/phase18-validation-record.md`)

***

## Foundation (5 tasks)

Evidence scaffolding and parity reconciliation targets.

* [x] T004 \[S1811] \[P] Create validation record scaffold with sections for protocol, manager, routes, WebSocket, idle lifecycle, summaries, scanners, scan orchestration, analysis, project scan, web cards, actions, shortcuts, persistence, focused tests, and broad gates (`.spec_system/specs/phase18-session11-validation-documentation-and-handoff/phase18-validation-record.md`)
* [x] T005 \[S1811] \[P] Create docs handoff scaffold with stable-doc ownership matrix, update checklist, route support inventory, privacy inventory changes, and final handoff notes (`.spec_system/specs/phase18-session11-validation-documentation-and-handoff/phase18-docs-handoff.md`)
* [x] T006 \[S1811] \[P] Create session security-compliance scaffold covering `suggestions.json`, code-derived text, scan roots, provider transfer opt-in, local-only persistence, and no-claim boundaries (`.spec_system/specs/phase18-session11-validation-documentation-and-handoff/security-compliance.md`)
* [x] T007 \[S1811] Build Appendix A parity closeout matrix with shipped, deliberately excluded, and follow-up classifications for every preserved Quest Board audit row (`.spec_system/specs/phase18-session11-validation-documentation-and-handoff/phase18-validation-record.md`)
* [x] T008 \[S1811] Verify the unsupported route inventory against shipped suggestion, issue, scan, analysis, project-scan, summary, and status routes with deliberately excluded routes preserved (`apps/server/src/lib/unsupportedRoutes.ts`)

***

## Implementation (11 tasks)

Stable docs updates and validation evidence.

* [x] T009 \[S1811] Update API docs for the shipped `/suggestions/*`, `/issues/*`, summary, scan, analysis, project-scan, status, and `suggestion_update` contracts with schema-validated inputs and explicit error mapping (`docs/api/README_api.md`)
* [x] T010 \[S1811] Update protocol docs with Quest Board contract ownership, event guidance, REST aliases, compatibility events, and consumer expectations (`packages/protocol/README_protocol.md`)
* [x] T011 \[S1811] Update server docs with SuggestionManager persistence, engine boundaries, route ownership, freshness windows, scan privacy, provider opt-in, and local-first redaction boundaries (`apps/server/README_server.md`)
* [x] T012 \[S1811] Update web docs with typed Quest Board cards, loading/empty/error/offline states, accept/dismiss/assign actions, scan triggers, feedback behavior, and `1`/`2`/`3`/`Alt+X`/`Alt+R` shortcut coverage (`apps/web/README_web.md`)
* [x] T013 \[S1811] Update architecture docs with Quest Board runtime flow, source-of-truth ownership, persistence, engine write paths, snapshot delivery, and web action boundaries (`docs/ARCHITECTURE.md`)
* [x] T014 \[S1811] Update privacy, security, and docs index records with `suggestions.json`, manual deletion path, code-derived text handling, provider opt-in, hosted-service exclusions, and trusted-erasure no-claim wording (`docs/privacy-and-security.md`)
* [x] T015 \[S1811] Reconcile the idle-suggestion prompt documentation with the shipped hero-idle lifecycle, transcript fallback, cooldown, timeout, fallback, session-summary, card action, and shortcut behavior (`apps/server/src/llm/prompts/idle-suggestion-engine.md`)
* [x] T016 \[S1811] Reconcile final unsupported-route code and docs so only genuinely unshipped or deliberately excluded historical Quest Board routes remain listed (`apps/server/src/lib/unsupportedRoutes.ts`)
* [x] T017 \[S1811] Execute and record redacted end-to-end evidence for hero-idle generation, `suggestion_update` hydration, typed card rendering, accept/dismiss/issue-dismiss/assign/bulk actions, restart persistence, and dismissed-ID survival (`.spec_system/specs/phase18-session11-validation-documentation-and-handoff/phase18-validation-record.md`)
* [x] T018 \[S1811] Execute and record redacted evidence for full/diff/stale scans, ignore patterns, on-demand analysis, project scan, status routes, freshness caches, fallback paths, and provider-transfer disabled behavior (`.spec_system/specs/phase18-session11-validation-documentation-and-handoff/phase18-validation-record.md`)
* [x] T019 \[S1811] Update Phase 18 tracker, master PRD progress, Appendix A closeout status, implementation notes, and final handoff notes together (`.spec_system/PRD/phase_18/PRD_phase_18.md`)

***

## Testing (5 tasks)

Focused package tests, broad gates, and artifact checks.

* [x] T020 \[S1811] \[P] Run focused protocol and server tests for suggestion contracts, events, manager persistence, routes, WebSocket hydration, idle lifecycle, summaries, scanners, scan orchestration, analysis, project scan, and unsupported routes (`.spec_system/specs/phase18-session11-validation-documentation-and-handoff/phase18-validation-record.md`)
* [x] T021 \[S1811] \[P] Run focused web tests for Quest Board normalization, store reducers, action client, component controls, trigger feedback, keyboard shortcuts, and shortcut help (`.spec_system/specs/phase18-session11-validation-documentation-and-handoff/phase18-validation-record.md`)
* [x] T022 \[S1811] Run root `npm run format:check`, `npm run lint`, `npm run typecheck --workspaces --if-present`, and `npm test`, then record pass results or precise blockers (`.spec_system/specs/phase18-session11-validation-documentation-and-handoff/phase18-validation-record.md`)
* [x] T023 \[S1811] Run ASCII, LF, and secret scan checks after new artifacts are staged or validation-ready, with any blocker recorded precisely (`.spec_system/specs/phase18-session11-validation-documentation-and-handoff/phase18-validation-record.md`)
* [x] T024 \[S1811] Finalize implementation notes, validation report, security-compliance report, docs handoff, and implementation summary with ready-for-validate status (`.spec_system/specs/phase18-session11-validation-documentation-and-handoff/validation.md`)

***

## Completion Checklist

Before marking session complete:

* [x] All tasks marked `[x]`
* [x] All tests passing or blockers recorded precisely
* [x] All files ASCII-encoded
* [x] implementation-notes.md updated
* [x] Ready for the validate workflow step

***

## Next Steps

Run the validate workflow step to verify Session 11 completion.


---

# 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/phase18-session11-validation-documentation-and-handoff/tasks.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.