Skip to main content
← Back to list
01Issue
FeatureOpenSwamp CLIPublic
AssigneesNone

Relationships

#4855 Docs: nested workflows inherit their caller's placement (swamp-club#4766)

Opened by stack72 · 11/18/2026

When swamp-club#4766 ships, a nested workflow step passes its placement and worker pin to the child run by default, so a child runs where its caller runs. The manual still describes placement inheritance as stopping at workflow, job and step.

Pages to update:

  • content/manual/reference/workflows.md: the nested workflow step section and the placement fields.
  • content/manual/reference/remote-execution.md: the placement inheritance rules.

Suggested content:

  • A nested workflow step inherits the effective placement of the step that calls it (workflow, job and step fields merged), plus the caller's worker affinity pin.
  • New step field placement, valid only on a nested workflow step: inherit (default) or own. With own, the child uses only its own YAML, which was the behaviour before this change. own cannot be combined with target, labels or platform on the same step.
  • target, labels and platform on a nested workflow step now place that child for that call.
  • A child that declares target, labels or platform in its own YAML overrides what it inherited field by field and drops the inherited pin.
  • A child cannot require the orchestrator from its own YAML; only the caller's placement own keeps it there.
  • A child that moves to a worker has its vault secrets and environment snapshot delivered to that worker with its dispatch.
  • Inheritance chains through grandchildren, and a child resumed on its own returns to the same placement.
  • Fan-out jobs still plan from the child's own selector, and a workflow step inside a fan-out job stays refused.
  • Behaviour change note: on serve with workers, an unplaced child under a placed parent now runs on the parent's worker instead of the serve host.
02Bog Flow
◉OPEN○TRIAGED○IN PROGRESS○SHIPPED

Open

11/18/2026, 2:57:41 AM

No activity in this phase yet.

03Sludge Pulse

Sign in to post a ripple.