> 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/phase20-session03-queue-git-execution/tasks.md).

# Task Checklist

**Session ID**: `phase20-session03-queue-git-execution` **Total Tasks**: 20 **Estimated Duration**: 3-4 hours **Created**: 2026-06-28

***

Legend: `[x]` completed; `[ ]` pending; `[P]` parallelizable; `[SNNMM]` session ref; `TNNN` task ID.

***

## Progress Summary

| Metric              | Value     |
| ------------------- | --------- |
| Tasks Completed     | 20 / 20   |
| Estimated Remaining | 0 minutes |
| Blockers            | 0         |

***

## Setup (2 tasks)

* [x] T001 \[S2003] Verify Session 01 and Session 02 artifacts, current queue execution contracts, and Git workbench behavior before editing (`.spec_system/specs/phase20-session02-queue-terminal-execution/validation.md`)
* [x] T002 \[S2003] Confirm focused command targets for protocol, server, web, CLI, Playwright, ASCII/LF, and whitespace verification (`package.json`)

***

## Foundation (5 tasks)

* [x] T003 \[S2003] \[P] Extend Git queue executable payload and execution summary contracts with blocked raw-field validation (`packages/protocol/src/taskQueue.ts`)
* [x] T004 \[S2003] \[P] Add protocol tests for Git executable parsing, safe event shape, blocked raw Git fields, and queue-targeted Git run metadata (`packages/protocol/tests/orchestration.test.ts`)
* [x] T005 \[S2003] Generalize task queue private executable storage and safe summary creation for Git without regressing terminal summaries (`apps/server/src/managers/taskQueue.ts`)
* [x] T006 \[S2003] Validate Git executable create, update, and dispatch bodies with schema-validated input and explicit error mapping (`apps/server/src/lib/orchestrationValidation.ts`)
* [x] T007 \[S2003] Expose compact Git workbench recovery/result metadata needed by queue dispatch without broad raw output (`apps/server/src/managers/gitWorkbenchManager.ts`)

***

## Implementation (8 tasks)

* [x] T008 \[S2003] Add Git dispatch to the task execution coordinator with preview/execute integration, policy-blocked push handling, idempotency protection, and compensation on failure (`apps/server/src/managers/taskExecutionCoordinator.ts`)
* [x] T009 \[S2003] Wire route dispatch to terminal or Git coordinator paths and emit queue plus execution events with bounded payloads and deterministic ordering (`apps/server/src/routes/orchestration.ts`)
* [x] T010 \[S2003] Inject Git workbench dependencies into the coordinator while preserving terminal queue behavior (`apps/server/src/server.ts`)
* [x] T011 \[S2003] Update web API create/dispatch shaping and response parsing for Git executable queue tasks with raw Git privacy checks (`apps/web/src/lib/orchestrationApi.ts`)
* [x] T012 \[S2003] Build Git queue view models, action labels, recovery text, and result summaries with product-facing copy only (`apps/web/src/lib/orchestrationUi.ts`)
* [x] T013 \[S2003] Add Git creation, dispatch, retry, recovery, and duplicate-disabled controls to the queue workbench with platform-appropriate accessibility labels, focus management, and input support (`apps/web/src/components/orchestration/QueueWorkbench.tsx`)
* [x] T014 \[S2003] Add File/Git workbench `Create queue task` flow and pane wiring with duplicate-trigger prevention while in-flight (`apps/web/src/components/orchestration/FileGitWorkbench.tsx`)
* [x] T015 \[S2003] Reconcile queue-targeted Git execution runs in the web store and clear Git queue in-flight keys without adding terminal drawer links (`apps/web/src/store/useGameStore.ts`)

***

## Testing (4 tasks)

* [x] T016 \[S2003] \[P] Add server coordinator and route tests for Git status, stage, unstage, blocked push, failed command, stale revision, duplicate dispatch, exact argv, and dual event emission (`apps/server/tests/taskExecutionCoordinator.test.ts`)
* [x] T017 \[S2003] \[P] Add web API, UI, panes, and store tests for Git queue creation, dispatch labels, recovery guidance, result summaries, File/Git queue creation, and broad raw-output exclusion (`apps/web/tests/CommandCenterPanes.test.tsx`)
* [x] T018 \[S2003] \[P] Add compact Git queue diagnostics tests and documentation updates for API events, web UX, CLI diagnostics, policy-blocked push, and privacy boundaries (`docs/api/README_api.md`)
* [x] T019 \[S2003] Add desktop and mobile Playwright coverage for the visible queue-to-Git dispatch flow with product-surface privacy assertions (`tests/e2e/orchestration-command-center.e2e.ts`)

***

## Completion (1 task)

* [x] T020 \[S2003] Run focused tests plus `npm run format:check`, `npm run lint`, `npm run typecheck`, `npm test`, focused Playwright desktop/mobile, `git diff --check`, and ASCII/LF verification (`verification-commands`)

***

## Completion Checklist

* [x] All tasks marked `[x]`
* [x] All tests and checks passing
* [x] All files ASCII-encoded with LF line endings
* [x] implementation-notes.md updated
* [x] Ready for `implement` to start the implement -> creview -> validate sequence

***

## Next Steps

Run `creview` to review and repair all uncommitted changes before validation.


---

# 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/phase20-session03-queue-git-execution/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.