Skip to content

Commit 8480ae8

Browse files
docs: fix incorrect job name 'Execution' → correct 'Agent'/'SafeOutputs' names (#620)
The three pipeline jobs are named Agent (Stage 1), Detection (Stage 2), and SafeOutputs (Stage 3). Three documentation files incorrectly referred to Stage 1 as the 'Execution job' (docs/extending.md, docs/filter-ir.md) and to Stage 3 as the 'Execution job' (docs/network.md). Fix all three to use the actual job identifiers from the compiled pipeline templates. Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent c7d49a6 commit 8480ae8

3 files changed

Lines changed: 5 additions & 5 deletions

File tree

docs/extending.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ pub trait CompilerExtension {
4040
fn required_hosts(&self) -> Vec<String>; // AWF network allowlist
4141
fn required_bash_commands(&self) -> Vec<String>; // Agent bash allow-list
4242
fn prompt_supplement(&self) -> Option<String>; // Agent prompt markdown
43-
fn prepare_steps(&self) -> Vec<String>; // Execution job steps (install, etc.)
43+
fn prepare_steps(&self) -> Vec<String>; // Agent job steps (install, etc.)
4444
fn setup_steps(&self, ctx: &CompileContext) -> Result<Vec<String>>; // Setup job steps (gates, pre-checks)
4545
fn mcpg_servers(&self, ctx: &CompileContext) -> Result<Vec<(String, McpgServerConfig)>>; // MCPG entries
4646
fn allowed_copilot_tools(&self) -> Vec<String>; // --allow-tool values
@@ -53,8 +53,8 @@ pub trait CompilerExtension {
5353
```
5454

5555
**`prepare_steps()` vs `setup_steps()`**: `prepare_steps()` injects into the
56-
Execution job (before the agent runs). `setup_steps()` injects into the Setup
57-
job (before the Execution job starts). Use `setup_steps()` for pre-activation
56+
Agent job (before the agent runs). `setup_steps()` injects into the Setup
57+
job (before the Agent job starts). Use `setup_steps()` for pre-activation
5858
gates or checks that must complete before the agent is launched.
5959

6060
**Phase ordering**: Extensions are sorted by phase — runtimes

docs/filter-ir.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -367,7 +367,7 @@ When Tier 2/3 filters are configured, the `TriggerFiltersExtension`
367367
during compilation via the `validate()` trait method
368368

369369
The extension uses the `setup_steps()` trait method (not `prepare_steps()`)
370-
because the gate must run in the **Setup job** (before the Execution job).
370+
because the gate must run in the **Setup job** (before the Agent job).
371371

372372
### Tier 1 Inline Path
373373

docs/network.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -128,7 +128,7 @@ permissions:
128128
### Security Model
129129

130130
- **`permissions.read`**: Mints a read-only ADO-scoped token given to the agent inside the AWF sandbox (Stage 1). The agent can query ADO APIs but cannot write.
131-
- **`permissions.write`**: Mints a write-capable ADO-scoped token used **only** by the executor in Stage 3 (`Execution` job). This token is never exposed to the agent.
131+
- **`permissions.write`**: Mints a write-capable ADO-scoped token used **only** by the executor in Stage 3 (`SafeOutputs` job). This token is never exposed to the agent.
132132
- **Both omitted**: No ADO tokens are passed anywhere. The agent has no ADO API access.
133133

134134
### Compile-Time Validation

0 commit comments

Comments
 (0)