---
doc_id: INDEX
audience: user
mode: generated
review_policy: contract
stability: stable
covers_surfaces: []
covers_sources: []
---
# Documentation index

Generated navigation for every package-local documentation page. This index intentionally owns no public surface and no production source; ownership is explicit in each primary doc's frontmatter.

## Start here

- [Getting started](./getting-started.md)
- [Choose a workflow](./choose-a-workflow.md)
- [Read before editing production sources](./read-before-edit.md)
- [Runtime contracts](./reference/runtime-contracts.md)

## Docs by audience

### agent

| Doc | Mode | Review | Stability |
| --- | --- | --- | --- |
| [concepts/completion-delivery](./concepts/completion-delivery.md) | authored | contract | stable |
| [concepts/context-projection-and-budgeting](./concepts/context-projection-and-budgeting.md) | authored | behavioral | evolving |
| [read-before-edit](./read-before-edit.md) | generated | contract | stable |
| [tools/bg_delegate](./tools/bg_delegate.md) | mixed | contract | stable |
| [tools/bg_kill](./tools/bg_kill.md) | mixed | contract | stable |
| [tools/bg_logs](./tools/bg_logs.md) | mixed | contract | stable |
| [tools/bg_result](./tools/bg_result.md) | mixed | contract | stable |
| [tools/bg_run](./tools/bg_run.md) | mixed | contract | stable |
| [tools/bg_run_pi_attested](./tools/bg_run_pi_attested.md) | mixed | contract | stable |
| [tools/bg_status](./tools/bg_status.md) | mixed | contract | stable |
| [tools/fusion_investigate](./tools/fusion_investigate.md) | mixed | contract | stable |
| [tools/fusion_reason](./tools/fusion_reason.md) | mixed | contract | stable |
| [tools/fusion_research](./tools/fusion_research.md) | mixed | contract | stable |
| [tools/fusion_validate](./tools/fusion_validate.md) | mixed | contract | stable |

### maintainer

| Doc | Mode | Review | Stability |
| --- | --- | --- | --- |
| [api/eventbus-v1](./api/eventbus-v1.md) | mixed | behavioral | evolving |
| [operations/configuration](./operations/configuration.md) | authored | contract | stable |
| [operations/releasing](./operations/releasing.md) | authored | contract | evolving |
| [operations/testing](./operations/testing.md) | authored | contract | evolving |
| [operations/troubleshooting](./operations/troubleshooting.md) | authored | contract | evolving |
| [reference/runtime-contracts](./reference/runtime-contracts.md) | mixed | contract | evolving |
| [subsystems/attested-pi-runs](./subsystems/attested-pi-runs.md) | authored | behavioral | evolving |
| [subsystems/background-task-runtime](./subsystems/background-task-runtime.md) | authored | behavioral | stable |
| [subsystems/child-launch-durability-and-safety](./subsystems/child-launch-durability-and-safety.md) | authored | behavioral | evolving |
| [subsystems/delegation](./subsystems/delegation.md) | authored | behavioral | evolving |
| [subsystems/docs-freshness-gate](./subsystems/docs-freshness-gate.md) | mixed | contract | stable |
| [subsystems/fusion](./subsystems/fusion.md) | mixed | behavioral | stable |
| [subsystems/host-ui-and-telemetry](./subsystems/host-ui-and-telemetry.md) | authored | behavioral | stable |

### user

| Doc | Mode | Review | Stability |
| --- | --- | --- | --- |
| [choose-a-workflow](./choose-a-workflow.md) | authored | contract | stable |
| [commands/bg](./commands/bg.md) | mixed | contract | stable |
| [commands/bg-clear](./commands/bg-clear.md) | mixed | contract | stable |
| [commands/bg-update](./commands/bg-update.md) | mixed | contract | stable |
| [commands/fusion](./commands/fusion.md) | mixed | contract | stable |
| [commands/fusion-models](./commands/fusion-models.md) | mixed | contract | stable |
| [commands/jobs](./commands/jobs.md) | mixed | contract | stable |
| [commands/kill](./commands/kill.md) | mixed | contract | stable |
| [commands/logs](./commands/logs.md) | mixed | contract | stable |
| [commands/task-manager](./commands/task-manager.md) | mixed | contract | stable |
| [getting-started](./getting-started.md) | authored | contract | stable |
| [INDEX](./INDEX.md) | generated | contract | stable |
| [reference/shortcuts-and-dock](./reference/shortcuts-and-dock.md) | mixed | contract | stable |

## Docs by category

- **api**: [api/eventbus-v1](./api/eventbus-v1.md)
- **commands**: [commands/bg](./commands/bg.md), [commands/bg-clear](./commands/bg-clear.md), [commands/bg-update](./commands/bg-update.md), [commands/fusion](./commands/fusion.md), [commands/fusion-models](./commands/fusion-models.md), [commands/jobs](./commands/jobs.md), [commands/kill](./commands/kill.md), [commands/logs](./commands/logs.md), [commands/task-manager](./commands/task-manager.md)
- **concepts**: [concepts/completion-delivery](./concepts/completion-delivery.md), [concepts/context-projection-and-budgeting](./concepts/context-projection-and-budgeting.md)
- **operations**: [operations/configuration](./operations/configuration.md), [operations/releasing](./operations/releasing.md), [operations/testing](./operations/testing.md), [operations/troubleshooting](./operations/troubleshooting.md)
- **reference**: [reference/runtime-contracts](./reference/runtime-contracts.md), [reference/shortcuts-and-dock](./reference/shortcuts-and-dock.md)
- **root**: [choose-a-workflow](./choose-a-workflow.md), [getting-started](./getting-started.md), [INDEX](./INDEX.md), [read-before-edit](./read-before-edit.md)
- **subsystems**: [subsystems/attested-pi-runs](./subsystems/attested-pi-runs.md), [subsystems/background-task-runtime](./subsystems/background-task-runtime.md), [subsystems/child-launch-durability-and-safety](./subsystems/child-launch-durability-and-safety.md), [subsystems/delegation](./subsystems/delegation.md), [subsystems/docs-freshness-gate](./subsystems/docs-freshness-gate.md), [subsystems/fusion](./subsystems/fusion.md), [subsystems/host-ui-and-telemetry](./subsystems/host-ui-and-telemetry.md)
- **tools**: [tools/bg_delegate](./tools/bg_delegate.md), [tools/bg_kill](./tools/bg_kill.md), [tools/bg_logs](./tools/bg_logs.md), [tools/bg_result](./tools/bg_result.md), [tools/bg_run](./tools/bg_run.md), [tools/bg_run_pi_attested](./tools/bg_run_pi_attested.md), [tools/bg_status](./tools/bg_status.md), [tools/fusion_investigate](./tools/fusion_investigate.md), [tools/fusion_reason](./tools/fusion_reason.md), [tools/fusion_research](./tools/fusion_research.md), [tools/fusion_validate](./tools/fusion_validate.md)

## Public surface owners

| Surface | Primary doc |
| --- | --- |
| `command:bg` | [commands/bg](./commands/bg.md) |
| `command:bg-clear` | [commands/bg-clear](./commands/bg-clear.md) |
| `command:bg-tasks` | [commands/task-manager](./commands/task-manager.md) |
| `command:bg-update` | [commands/bg-update](./commands/bg-update.md) |
| `command:fusion` | [commands/fusion](./commands/fusion.md) |
| `command:fusion-models` | [commands/fusion-models](./commands/fusion-models.md) |
| `command:jobs` | [commands/jobs](./commands/jobs.md) |
| `command:kill` | [commands/kill](./commands/kill.md) |
| `command:logs` | [commands/logs](./commands/logs.md) |
| `command:tasks` | [commands/task-manager](./commands/task-manager.md) |
| `eventbus:background-task-v1` | [api/eventbus-v1](./api/eventbus-v1.md) |
| `renderer:background-task-notification` | [concepts/completion-delivery](./concepts/completion-delivery.md) |
| `renderer:fusion-result` | [subsystems/fusion](./subsystems/fusion.md) |
| `shortcut:ctrl+alt+c` | [reference/shortcuts-and-dock](./reference/shortcuts-and-dock.md) |
| `shortcut:shift+down` | [reference/shortcuts-and-dock](./reference/shortcuts-and-dock.md) |
| `tool:bg_delegate` | [tools/bg_delegate](./tools/bg_delegate.md) |
| `tool:bg_kill` | [tools/bg_kill](./tools/bg_kill.md) |
| `tool:bg_logs` | [tools/bg_logs](./tools/bg_logs.md) |
| `tool:bg_result` | [tools/bg_result](./tools/bg_result.md) |
| `tool:bg_run` | [tools/bg_run](./tools/bg_run.md) |
| `tool:bg_run_pi_attested` | [tools/bg_run_pi_attested](./tools/bg_run_pi_attested.md) |
| `tool:bg_status` | [tools/bg_status](./tools/bg_status.md) |
| `tool:fusion_investigate` | [tools/fusion_investigate](./tools/fusion_investigate.md) |
| `tool:fusion_reason` | [tools/fusion_reason](./tools/fusion_reason.md) |
| `tool:fusion_research` | [tools/fusion_research](./tools/fusion_research.md) |
| `tool:fusion_validate` | [tools/fusion_validate](./tools/fusion_validate.md) |
| `workflow:investigate` | [subsystems/fusion](./subsystems/fusion.md) |
| `workflow:reason` | [subsystems/fusion](./subsystems/fusion.md) |
| `workflow:research` | [subsystems/fusion](./subsystems/fusion.md) |
| `workflow:validate` | [subsystems/fusion](./subsystems/fusion.md) |

## Public surface inventory

| Kind | Name | ID | Provenance |
| --- | --- | --- | --- |
| command | `bg` | `command:bg` | `src/extension.ts:517` |
| command | `bg-clear` | `command:bg-clear` | `src/extension.ts:559` |
| command | `bg-tasks` | `command:bg-tasks` | `src/extension.ts:551` |
| command | `bg-update` | `command:bg-update` | `src/extension.ts:567` |
| command | `fusion` | `command:fusion` | `src/fusion-extension.ts:996` |
| command | `fusion-models` | `command:fusion-models` | `src/fusion-extension.ts:1029` |
| command | `jobs` | `command:jobs` | `src/extension.ts:605` |
| command | `kill` | `command:kill` | `src/extension.ts:649` |
| command | `logs` | `command:logs` | `src/extension.ts:618` |
| command | `tasks` | `command:tasks` | `src/extension.ts:543` |
| tool | `bg_delegate` | `tool:bg_delegate` | `src/delegate-extension.ts:292` |
| tool | `bg_kill` | `tool:bg_kill` | `src/extension.ts:908` |
| tool | `bg_logs` | `tool:bg_logs` | `src/extension.ts:863` |
| tool | `bg_result` | `tool:bg_result` | `src/delegate-extension.ts:453` |
| tool | `bg_run` | `tool:bg_run` | `src/extension.ts:682` |
| tool | `bg_run_pi_attested` | `tool:bg_run_pi_attested` | `src/extension.ts:767` |
| tool | `bg_status` | `tool:bg_status` | `src/extension.ts:832` |
| tool | `fusion_investigate` | `tool:fusion_investigate` | `src/fusion-extension.ts:1197` |
| tool | `fusion_reason` | `tool:fusion_reason` | `src/fusion-extension.ts:1179` |
| tool | `fusion_research` | `tool:fusion_research` | `src/fusion-extension.ts:1216` |
| tool | `fusion_validate` | `tool:fusion_validate` | `src/fusion-extension.ts:1236` |
| shortcut | `ctrl+alt+c` | `shortcut:ctrl+alt+c` | `src/extension.ts:597` |
| shortcut | `shift+down` | `shortcut:shift+down` | `src/extension.ts:590` |
| renderer | `background-task-notification` | `renderer:background-task-notification` | `src/extension.ts:426` |
| renderer | `fusion-result` | `renderer:fusion-result` | `src/fusion-extension.ts:980` |
| eventbus | `background-task-v1` | `eventbus:background-task-v1` | `src/core/extension-api.ts` |
| workflow | `investigate` | `workflow:investigate` | `src/core/fusion/workflows.ts:80` |
| workflow | `reason` | `workflow:reason` | `src/core/fusion/workflows.ts:61` |
| workflow | `research` | `workflow:research` | `src/core/fusion/workflows.ts:99` |
| workflow | `validate` | `workflow:validate` | `src/core/fusion/workflows.ts:118` |