> 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/phase19-session06-executor-registry/tasks.md).

# Task Checklist

**Session ID**: `phase19-session06-executor-registry` **Total Tasks**: 22 **Estimated Duration**: 3-4 hours **Created**: 2026-06-26

***

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

***

## Setup (3 tasks)

* [x] T001 \[S1906] Verify completed prerequisite artifacts and current guarded-action approval boundary (`.spec_system/specs/phase19-session05-attention-and-permissions/validation.md`)
* [x] T002 \[S1906] \[P] Create executor registry unit test scaffold for ready, non-ready, timeout, failure, cleanup, rollback, and bounded output cases (`apps/server/tests/executorRegistry.test.ts`)
* [x] T003 \[S1906] \[P] Create executor panel component test scaffold for family cards, run-history drawer, offline, empty, failed, executed, and redaction states (`apps/web/tests/ExecutorFamiliesPanel.test.tsx`)

***

## Foundation (5 tasks)

* [x] T004 \[S1906] Create registry entry types, guarded family/kind mapping, capability probe contracts, timeout policy, and execute contract with cleanup on scope exit for all acquired resources (`apps/server/src/managers/executorRegistry.ts`)
* [x] T005 \[S1906] Implement non-ready repair guidance and bounded execution result builders with schema-validated input and explicit error mapping (`apps/server/src/managers/executorRegistry.ts`)
* [x] T006 \[S1906] Add a default production registry that keeps concrete executor families unavailable, observe-only, proposal-only, or approved-not-executing unless an entry explicitly reports executor-ready (`apps/server/src/managers/executorRegistry.ts`)
* [x] T007 \[S1906] Extend command-center manager helpers for guarded execution run creation, probe updates, deterministic run ordering, and bounded result summaries with idempotency protection (`apps/server/src/managers/orchestrationCommandCenter.ts`)
* [x] T008 \[S1906] Wire the default executor registry into server construction and route dependencies without adding new runtime services (`apps/server/src/server.ts`)

***

## Implementation (9 tasks)

* [x] T009 \[S1906] Update guarded-action approval logic to use registry results while preserving reject, expire, stale revision, duplicate decision, and compact result behavior with duplicate-trigger prevention while in-flight (`apps/server/src/managers/guardedActions.ts`)
* [x] T010 \[S1906] Update guarded-action routes to persist command-center execution runs and emit paired guarded-action plus command-center execution events with duplicate-trigger prevention while in-flight (`apps/server/src/routes/guardedActions.ts`)
* [x] T011 \[S1906] Add executor probe and execution detail route bindings with validated ids, compact errors, and no raw payload echo (`apps/server/src/routes/commandCenter.ts`)
* [x] T012 \[S1906] Add command-center validation helpers for executor capability ids, execution ids, probe requests, stale revisions, and blocked raw fields with explicit error mapping (`apps/server/src/lib/commandCenterValidation.ts`)
* [x] T013 \[S1906] Extend orchestration diagnostics with registry ready/non-ready counts and recent execution counts without raw execution payloads (`apps/server/src/lib/orchestrationDiagnostics.ts`)
* [x] T014 \[S1906] Add web API helpers for executor probes and execution details with timeout, offline, stale revision, duplicate trigger, and redacted error handling (`apps/web/src/lib/orchestrationApi.ts`)
* [x] T015 \[S1906] Add executor family summaries, run-history views, requirement copy, action availability, and redaction helpers for broad UI records (`apps/web/src/lib/commandCenterUi.ts`)
* [x] T016 \[S1906] Create executor family cards with explicit loading, empty, error, and offline states plus product-facing copy only (`apps/web/src/components/orchestration/ExecutorFamiliesPanel.tsx`)
* [x] T017 \[S1906] Create scoped execution run-history details with bounded result summaries, state metadata, focus management, Escape close support, and no raw output rendering (`apps/web/src/components/orchestration/ExecutorRunHistoryDrawer.tsx`)

***

## Integration (3 tasks)

* [x] T018 \[S1906] Wire the Executors tab to the executor family panel and run-history selection with platform-appropriate accessibility labels, focus management, and input support (`apps/web/src/components/orchestration/CommandCenterPanes.tsx`)
* [x] T019 \[S1906] Delegate execution-run drawer rendering while preserving existing command-center drawer behavior and selected-record cleanup on re-entry (`apps/web/src/components/orchestration/OrchestrationDrawer.tsx`)
* [x] T020 \[S1906] Export executor components from the orchestration component index for stable test and panel imports (`apps/web/src/components/orchestration/index.ts`)

***

## Testing And Documentation (2 tasks)

* [x] T021 \[S1906] Update focused protocol-adjacent, server, web, and WebSocket tests for ready execution, non-ready repair guidance, bounded output, duplicate triggers, stale revisions, event emission, and malformed frame handling (`apps/server/tests/guardedActions.test.ts`, `apps/server/tests/commandCenterManager.test.ts`, `apps/server/tests/commandCenterRoutes.test.ts`, `apps/server/tests/websocket.test.ts`, `apps/server/tests/orchestrationDiagnostics.test.ts`, `apps/web/tests/orchestrationApi.test.ts`, `apps/web/tests/commandCenterUi.test.ts`, `apps/web/tests/commandCenterStore.test.ts`, `apps/web/tests/OrchestrationPanel.test.tsx`)
* [x] T022 \[S1906] Update API and package docs, then run typecheck, focused tests, lint, format check, diff check, and ASCII/LF validation (`docs/api/README_api.md`, `docs/api/event-api-hook-contracts.md`, `apps/server/README_server.md`, `apps/web/README_web.md`, `npm --workspace apps/server run typecheck`, `npm --workspace apps/web run typecheck`, `npm run lint`, `npm run format:check`, `git diff --check`)

***

## 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 `validate` after code review

***

## Next Steps

Run the `validate` workflow step.


---

# 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/phase19-session06-executor-registry/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.