@cat-factory/app 0.255.0 → 0.255.1

package/app/components/pipeline/PipelineBuilder.vue

@@ -1,6 +1,6 @@
 <script setup lang="ts">
 import { computed, ref, watch } from 'vue'
-import { purposeAllowsAgentCategory } from '@cat-factory/contracts'
+import { DEPLOYER_AGENT_KIND } from '@cat-factory/contracts'
 import type { AgentKind, Pipeline } from '~/types/domain'
 import AgentPalette from '~/components/palettes/AgentPalette.vue'
 import AgentKindIcon from '~/components/pipeline/AgentKindIcon.vue'
@@ -189,31 +189,6 @@ const skills = useSkillsStore()
 // skill picker. A `skill` step is parametrized by the picked skill (`stepOptions.skillId`).
 const skillSelectItems = computed(() => skills.catalog.map((s) => ({ label: s.name, value: s.id })))
 
-// An enabled `skill` step with no picked skill — mirrors the backend save/start rejection
-// (`assertValidSkillSteps`), surfaced as an inline hint so the user fixes it before saving.
-const skillStepNeedsPick = computed(() =>
-  pipelines.draft.some(
-    (k, i) => k === 'skill' && pipelines.draftEnabled[i] !== false && !pipelines.draftSkillId(i),
-  ),
-)
-
-// Steps whose agent category the chosen purpose CONTRADICTS (a non-`build` purpose writes no code
-// and runs no tests, so the Implementation/Testing categories are disallowed, see
-// `purposeAllowsAgentCategory`). Only reachable by switching an existing draft to a non-`build`
-// purpose AFTER such steps were added, since the palette offers neither. The backend has no
-// kind→category map to gate on, so the builder is the enforcement point: save is blocked until the
-// offending steps are removed (or the purpose set back to Build).
-//
-// Deliberately the compatibility predicate, not the palette's narrower relevance one: a purpose
-// that merely stops SUGGESTING a category must not turn a pipeline somebody already built into
-// one they cannot save.
-const stepsDisallowedByPurpose = computed(() =>
-  pipelines.draft.filter((kind) => {
-    const category = agentKindMeta(kind).category
-    return !!category && !purposeAllowsAgentCategory(pipelines.draftPurpose, category)
-  }),
-)
-
 // The workspace's foundational-services catalog, for the binary-output storage/context picker.
 const foundational = useFoundationalServicesStore()
 
@@ -231,18 +206,22 @@ function showBinaryOutputPicker(kind: AgentKind): boolean {
   return agentKindMeta(kind).binaryOutput === true
 }
 
-// An enabled generator step with no storage selection — mirrors the backend save/start
-// rejection (`assertValidBinaryOutputSteps`), surfaced as an inline hint so the user fixes it
-// before the round trip. Same disposition as `skillStepNeedsPick`, for the same reason: both
-// are a step parametrized by a selection it cannot run without.
-const binaryOutputStepNeedsPick = computed(() =>
-  pipelines.draft.some(
-    (kind, i) =>
-      showBinaryOutputPicker(kind) &&
-      pipelines.draftEnabled[i] !== false &&
-      !pipelines.draftBinaryOutput(i)?.storageServiceId,
-  ),
-)
+/**
+ * Whether to offer the Deployer's "keep this environment past the run" declaration on the step at
+ * `index`. An OVERRIDE in the `showOverrideField` sense — reclaiming what a run stood up is the
+ * default and the everyday shape, and a deliberately retained preview environment is not the
+ * everyday delivery loop — so it is `advanced`-tier, and a step that already CARRIES the
+ * declaration keeps showing it in either mode (never hide the way back).
+ *
+ * Hiding it strands nobody: the fault it answers (`deployer_without_disposer`) always has the
+ * tier-neutral fix of adding the Disposer back, which both the inline hint and the save refusal
+ * name FIRST. That is what makes this different from the binary-output picker above, where the
+ * selection is required and hiding it would leave a step with no savable form at all.
+ */
+function showRetainEnvironmentToggle(kind: AgentKind, index: number): boolean {
+  if (kind !== DEPLOYER_AGENT_KIND) return false
+  return showOverrideField(uiMode.isAdvanced, pipelines.draftRetainEnvironment(index) || null)
+}
 
 // A step's picked skill id is no longer in the account catalog (the source dir was renamed or
 // unlinked). The step will fail cleanly at dispatch; flag it so the user re-picks.
@@ -370,22 +349,12 @@ function companionLabel(kind: string): string | null {
   return companion ? agentKindMeta(companion).label : null
 }
 
-// Surfaced as an inline hint: a gated step needs a task-estimator before it (mirrors the
-// backend validation, which also rejects the save/start). Both the companion estimate gate
-// (`draftGating`) and the Tester QC companion's estimate gate (`draftTesterQuality[i].gating`)
-// count — either without a preceding estimator is rejected on save.
-const gatingNeedsEstimator = computed(() => {
-  const kinds = pipelines.draft
-  const hasEstimatorBefore = (i: number) =>
-    kinds.slice(0, i).some((k, j) => k === 'task-estimator' && pipelines.draftEnabled[j] !== false)
-  for (let i = 0; i < kinds.length; i++) {
-    if (pipelines.draftEnabled[i] === false) continue
-    const gated =
-      pipelines.draftGating[i]?.enabled || pipelines.draftTesterQuality[i]?.gating?.enabled
-    if (gated && !hasEstimatorBefore(i)) return true
-  }
-  return false
-})
+// Everything that is WRONG with the draft, as an ordered list of hints the template renders once,
+// plus the purpose conflict that also disables Save. Lives in its own composable because each of
+// these is one predicate beside one identically-styled line, and five of them had crowded out the
+// component (`usePipelineDraftWarnings`).
+const { hints: draftWarnings, stepsDisallowedByPurpose } =
+  usePipelineDraftWarnings(showBinaryOutputPicker)
 
 // ---- draft labels ----------------------------------------------------------
 const newLabel = ref('')
@@ -563,37 +532,16 @@ async function clone(p: Pipeline) {
             />
           </div>
 
+          <!-- Every draft fault the builder can name, each mirroring a refusal the save boundary
+             makes, so the user fixes it before the round trip (`usePipelineDraftWarnings`). -->
           <p
-            v-if="gatingNeedsEstimator"
-            class="mb-2 flex items-center gap-1.5 rounded-md border border-amber-800/50 bg-amber-950/30 px-2 py-1 text-[11px] text-amber-300"
-          >
-            <UIcon name="i-lucide-alert-triangle" class="h-3.5 w-3.5 shrink-0" />
-            {{ t('pipeline.builder.gatingNeedsEstimator') }}
-          </p>
-
-          <p
-            v-if="skillStepNeedsPick"
+            v-for="warning in draftWarnings"
+            :key="warning.key"
             class="mb-2 flex items-center gap-1.5 rounded-md border border-amber-800/50 bg-amber-950/30 px-2 py-1 text-[11px] text-amber-300"
+            :data-testid="warning.testId"
           >
             <UIcon name="i-lucide-alert-triangle" class="h-3.5 w-3.5 shrink-0" />
-            {{ t('pipeline.builder.skillNeedsPick') }}
-          </p>
-
-          <p
-            v-if="binaryOutputStepNeedsPick"
-            class="mb-2 flex items-center gap-1.5 rounded-md border border-amber-800/50 bg-amber-950/30 px-2 py-1 text-[11px] text-amber-300"
-            data-testid="binary-output-needs-pick"
-          >
-            <UIcon name="i-lucide-alert-triangle" class="h-3.5 w-3.5 shrink-0" />
-            {{ t('pipeline.builder.binaryOutputNeedsPick') }}
-          </p>
-
-          <p
-            v-if="stepsDisallowedByPurpose.length"
-            class="mb-2 flex items-center gap-1.5 rounded-md border border-amber-800/50 bg-amber-950/30 px-2 py-1 text-[11px] text-amber-300"
-          >
-            <UIcon name="i-lucide-alert-triangle" class="h-3.5 w-3.5 shrink-0" />
-            {{ t('pipeline.builder.purposeStepsConflict') }}
+            {{ t(warning.key) }}
           </p>
 
           <div
@@ -766,6 +714,27 @@ async function clone(p: Pipeline) {
                     "
                     @click="pipelines.toggleDraftAutoRecommend(unit.index)"
                   />
+                  <!-- Keep the environment this Deployer stands up past the end of the run: the
+                     preview a reviewer pokes at after the PR is open. Off by default, and the
+                     save boundary refuses a Deployer that neither reclaims nor declares this,
+                     so the tick is how an unreclaimed environment says it is deliberate. -->
+                  <UButton
+                    v-if="showRetainEnvironmentToggle(unit.kind, unit.index)"
+                    :icon="
+                      pipelines.draftRetainEnvironment(unit.index)
+                        ? 'i-lucide-lock'
+                        : 'i-lucide-cloud-off'
+                    "
+                    :color="pipelines.draftRetainEnvironment(unit.index) ? 'warning' : 'neutral'"
+                    variant="ghost"
+                    size="xs"
+                    :title="
+                      pipelines.draftRetainEnvironment(unit.index)
+                        ? t('pipeline.builder.retainEnvironmentClearTooltip')
+                        : t('pipeline.builder.retainEnvironmentSetTooltip')
+                    "
+                    @click="pipelines.toggleDraftRetainEnvironment(unit.index)"
+                  />
                   <!-- System prompt: replace what this agent kind ships with, for every run in
                      this workspace, with the full revision history to switch back through. -->
                   <UButton

package/app/composables/usePipelineDraftWarnings.ts

@@ -0,0 +1,136 @@
+import { computed, type ComputedRef } from 'vue'
+import {
+  pipelineEnvironmentProblems,
+  purposeAllowsAgentCategory,
+  type PipelineEnvironmentProblemReason,
+} from '@cat-factory/contracts'
+import type { AgentKind } from '~/types/domain'
+import { agentKindMeta } from '~/utils/catalog'
+import { usePipelinesStore } from '~/stores/pipelines'
+
+/**
+ * Everything the pipeline builder can say is WRONG with the draft in front of it, as an ordered
+ * list of translation keys, plus the one finding that also blocks the save.
+ *
+ * Extracted from `PipelineBuilder.vue` because these grew into one concern wearing five copies of
+ * the same coat: each was a `computed` predicate beside a `<p>` with byte-identical classes, so
+ * every new rule cost another near-duplicate pair in a component that had run out of room for
+ * them. Here they are a list the template renders once.
+ *
+ * Every entry MIRRORS a refusal the backend already makes at save (or, for the purpose conflict,
+ * one only the builder can make, since the backend has no kind→category map). The point is to
+ * surface it before the round trip, never to be the sole enforcement: a hint that disagrees with
+ * the boundary would let an unsavable draft look clean, so each is derived from the same shared
+ * rule the boundary runs rather than from a hand-written restatement of it.
+ */
+export interface PipelineDraftWarnings {
+  /** One entry per distinct finding, in the order the builder shows them. */
+  hints: ComputedRef<PipelineDraftHint[]>
+  /**
+   * The draft steps whose agent category the chosen purpose CONTRADICTS. Exposed as the list
+   * rather than folded into {@link hints} alone because it is the one finding that also disables
+   * the Save button: the builder is the enforcement point, so an empty list is a precondition.
+   */
+  stepsDisallowedByPurpose: ComputedRef<AgentKind[]>
+}
+
+/** One rendered warning: its i18n key, plus the test id where a spec asserts on it. */
+export interface PipelineDraftHint {
+  key: string
+  testId?: string
+}
+
+/**
+ * The environment-lifecycle faults, mapped onto the copy that names the fix for each. An
+ * exhaustive `Record` over the reason union, so a fault added to the shared rule fails the build
+ * here rather than rendering as a blank hint.
+ */
+const ENVIRONMENT_HINT_KEYS: Record<PipelineEnvironmentProblemReason, string> = {
+  consumer_without_deployer: 'pipeline.builder.envNeedsDeployer',
+  consumer_after_disposer: 'pipeline.builder.envConsumerAfterDisposer',
+  deployer_without_disposer: 'pipeline.builder.envNeedsDisposer',
+  disposer_without_deployer: 'pipeline.builder.envDisposerNeedsDeployer',
+  retained_deployer_reclaimed: 'pipeline.builder.envRetainedButReclaimed',
+}
+
+export function usePipelineDraftWarnings(
+  showBinaryOutputPicker: (kind: AgentKind) => boolean,
+): PipelineDraftWarnings {
+  const pipelines = usePipelinesStore()
+
+  const enabled = (i: number) => pipelines.draftEnabled[i] !== false
+
+  // A gated step with no task-estimator before it (mirrors `assertValidGating`, which rejects the
+  // save and the start). Both the step's own estimate gate (`draftGating`) and the Tester QC
+  // companion's (`draftTesterQuality[i].gating`) count.
+  const gatingNeedsEstimator = computed(() => {
+    const kinds = pipelines.draft
+    const hasEstimatorBefore = (i: number) =>
+      kinds.slice(0, i).some((k, j) => k === 'task-estimator' && enabled(j))
+    return kinds.some((_, i) => {
+      if (!enabled(i)) return false
+      const gated =
+        pipelines.draftGating[i]?.enabled || pipelines.draftTesterQuality[i]?.gating?.enabled
+      return !!gated && !hasEstimatorBefore(i)
+    })
+  })
+
+  // The environment lifecycle a draft has to spell out: provision (Deployer) → consume (a tester /
+  // acceptance / human-test step) → reclaim (Disposer, or a Deployer that declares its environment
+  // outlives the run). One message per DISTINCT fault, so a draft missing both a Deployer and a
+  // Disposer says so at once instead of over two rejected saves.
+  const environmentHintKeys = computed(() => {
+    const problems = pipelineEnvironmentProblems(
+      pipelines.draft,
+      pipelines.draftEnabled,
+      pipelines.draftStepOptions,
+    )
+    return [...new Set(problems.map((p) => ENVIRONMENT_HINT_KEYS[p.reason]))]
+  })
+
+  // An enabled `skill` step with no picked skill (mirrors `assertValidSkillSteps`).
+  const skillStepNeedsPick = computed(() =>
+    pipelines.draft.some((k, i) => k === 'skill' && enabled(i) && !pipelines.draftSkillId(i)),
+  )
+
+  // An enabled generator step with no storage selection (mirrors `assertValidBinaryOutputSteps`).
+  // Same disposition as `skillStepNeedsPick`: both are a step parametrized by a selection it
+  // cannot run without.
+  const binaryOutputStepNeedsPick = computed(() =>
+    pipelines.draft.some(
+      (kind, i) =>
+        showBinaryOutputPicker(kind) &&
+        enabled(i) &&
+        !pipelines.draftBinaryOutput(i)?.storageServiceId,
+    ),
+  )
+
+  // Steps whose agent category the chosen purpose CONTRADICTS (a non-`build` purpose writes no
+  // code and runs no tests, so the Implementation/Testing categories are disallowed). Only
+  // reachable by switching an existing draft to a non-`build` purpose AFTER such steps were added,
+  // since the palette offers neither.
+  //
+  // Deliberately the COMPATIBILITY predicate, not the palette's narrower relevance one: a purpose
+  // that merely stops SUGGESTING a category must not turn a pipeline somebody already built into
+  // one they cannot save.
+  const stepsDisallowedByPurpose = computed(() =>
+    pipelines.draft.filter((kind) => {
+      const category = agentKindMeta(kind).category
+      return !!category && !purposeAllowsAgentCategory(pipelines.draftPurpose, category)
+    }),
+  )
+
+  const hints = computed<PipelineDraftHint[]>(() => [
+    ...(gatingNeedsEstimator.value ? [{ key: 'pipeline.builder.gatingNeedsEstimator' }] : []),
+    ...environmentHintKeys.value.map((key) => ({ key, testId: 'env-lifecycle-hint' })),
+    ...(skillStepNeedsPick.value ? [{ key: 'pipeline.builder.skillNeedsPick' }] : []),
+    ...(binaryOutputStepNeedsPick.value
+      ? [{ key: 'pipeline.builder.binaryOutputNeedsPick', testId: 'binary-output-needs-pick' }]
+      : []),
+    ...(stepsDisallowedByPurpose.value.length
+      ? [{ key: 'pipeline.builder.purposeStepsConflict' }]
+      : []),
+  ])
+
+  return { hints, stepsDisallowedByPurpose }
+}

package/app/stores/pipelines/draftRetainEnvironment.spec.ts

@@ -0,0 +1,62 @@
+import { describe, expect, it } from 'vitest'
+import { pipelineEnvironmentProblems } from '@cat-factory/contracts'
+import { usePipelinesStore } from '~/stores/pipelines'
+
+/**
+ * The pipeline-builder draft's retain declaration (`stepOptions.retainEnvironment`): how an author
+ * says a Deployer's environment is MEANT to outlive the run, which is the only savable form of
+ * "deploy a preview and leave it up" (the reclaim rule refuses a Deployer that neither reclaims
+ * nor declares this). Same contract as the option helpers beside it: merge into the bag, normalize
+ * an emptied bag back to null.
+ */
+describe('pipelines store — per-step retain-environment declaration', () => {
+  it('stores only the opt-in, and normalizes the bag away when it is cleared', () => {
+    const pipelines = usePipelinesStore()
+    pipelines.addToDraft('deployer')
+    // OFF by default, and stored as ABSENCE rather than `false`: reclaiming is the default, so a
+    // step that never touched this persists exactly the shape it always did.
+    expect(pipelines.draftRetainEnvironment(0)).toBe(false)
+    expect(pipelines.draftStepOptions[0]).toBeNull()
+
+    pipelines.toggleDraftRetainEnvironment(0)
+    expect(pipelines.draftRetainEnvironment(0)).toBe(true)
+    expect(pipelines.draftStepOptions[0]).toEqual({ retainEnvironment: true })
+
+    pipelines.toggleDraftRetainEnvironment(0)
+    expect(pipelines.draftRetainEnvironment(0)).toBe(false)
+    expect(pipelines.draftStepOptions[0]).toBeNull()
+  })
+
+  it('merges with the other options on the same step rather than clobbering them', () => {
+    const pipelines = usePipelinesStore()
+    pipelines.addToDraft('deployer')
+    pipelines.setDraftAgentVariantId(0, 'acme:fast')
+
+    pipelines.toggleDraftRetainEnvironment(0)
+    expect(pipelines.draftStepOptions[0]).toEqual({
+      agentVariantId: 'acme:fast',
+      retainEnvironment: true,
+    })
+
+    pipelines.toggleDraftRetainEnvironment(0)
+    expect(pipelines.draftStepOptions[0]).toEqual({ agentVariantId: 'acme:fast' })
+  })
+
+  it('turns a draft the save boundary refuses into one it accepts', () => {
+    // The point of the whole field, asserted against the SAME rule the backend refuses on rather
+    // than against a restatement of it: without the declaration this draft has no savable form,
+    // since dropping the Deployer instead just moves the fault onto the tester.
+    const pipelines = usePipelinesStore()
+    for (const kind of ['coder', 'deployer', 'human-test'] as const) pipelines.addToDraft(kind)
+    const problems = () =>
+      pipelineEnvironmentProblems(
+        pipelines.draft,
+        pipelines.draftEnabled,
+        pipelines.draftStepOptions,
+      ).map((p) => p.reason)
+
+    expect(problems()).toEqual(['deployer_without_disposer'])
+    pipelines.toggleDraftRetainEnvironment(1)
+    expect(problems()).toEqual([])
+  })
+})

package/app/stores/pipelines/draftStepConfig.ts

@@ -15,6 +15,27 @@ import { defaultConsensusConfig, type PipelinesContext } from './context'
  * touches nothing else, which is what makes the two independent; both are spread into the store,
  * so the store's API is unchanged.
  */
+/**
+ * Write ONE field of the step's `StepOptions` bag at `index`, merging into whatever else that step
+ * carries and normalizing an emptied bag back to `null`. `undefined` CLEARS the field.
+ *
+ * Every per-step option below goes through this rather than repeating the clone/assign/normalize
+ * dance, because the two halves that are easy to get wrong are shared by all of them: replacing
+ * the bag loses the neighbouring options a step may also carry, and leaving a `{}` behind makes a
+ * step that is back on every default persist a shape it never had.
+ */
+function patchStepOption<K extends keyof StepOptions>(
+  draftStepOptions: PipelinesContext['draftStepOptions'],
+  index: number,
+  key: K,
+  value: StepOptions[K] | undefined,
+) {
+  const next: StepOptions = { ...draftStepOptions.value[index] }
+  if (value === undefined) delete next[key]
+  else next[key] = value
+  draftStepOptions.value[index] = Object.keys(next).length ? next : null
+}
+
 export function createPipelineStepConfigActions(ctx: PipelinesContext) {
   const {
     draftGates,
@@ -118,10 +139,27 @@ export function createPipelineStepConfigActions(ctx: PipelinesContext) {
    * flag. Merges with any other future StepOptions fields rather than clobbering the whole bag.
    */
   function toggleDraftAutoRecommend(index: number) {
-    const next: StepOptions = { ...draftStepOptions.value[index] }
-    if (draftAutoRecommendEnabled(index)) next.autoRecommend = false
-    else delete next.autoRecommend
-    draftStepOptions.value[index] = Object.keys(next).length ? next : null
+    const off = draftAutoRecommendEnabled(index) ? false : undefined
+    patchStepOption(draftStepOptions, index, 'autoRecommend', off)
+  }
+
+  /**
+   * Whether the draft `deployer` step at `index` declares that its environments outlive the run
+   * (its `stepOptions.retainEnvironment`). OFF by default: the everyday shape is a run that
+   * reclaims what it stood up, and the save boundary refuses a Deployer that does neither.
+   */
+  function draftRetainEnvironment(index: number): boolean {
+    return draftStepOptions.value[index]?.retainEnvironment === true
+  }
+
+  /**
+   * Toggle the retain declaration on the draft `deployer` step at `index`. It is off by default,
+   * so we store ONLY the opt-in (the mirror of `toggleDraftAutoRecommend`, which stores only the
+   * opt-out); toggling back drops the flag and, if the bag empties, the whole entry.
+   */
+  function toggleDraftRetainEnvironment(index: number) {
+    const on = draftRetainEnvironment(index) ? undefined : true
+    patchStepOption(draftStepOptions, index, 'retainEnvironment', on)
   }
 
   /** The skill picked for the draft `skill` step at `index` (its `stepOptions.skillId`). */
@@ -135,10 +173,7 @@ export function createPipelineStepConfigActions(ctx: PipelinesContext) {
    * bag empties, the whole entry (so it normalizes away like the other options).
    */
   function setDraftSkillId(index: number, skillId: string | undefined) {
-    const next: StepOptions = { ...draftStepOptions.value[index] }
-    if (skillId) next.skillId = skillId
-    else delete next.skillId
-    draftStepOptions.value[index] = Object.keys(next).length ? next : null
+    patchStepOption(draftStepOptions, index, 'skillId', skillId || undefined)
   }
 
   /**
@@ -156,10 +191,7 @@ export function createPipelineStepConfigActions(ctx: PipelinesContext) {
    * shipped prompt persists nothing.
    */
   function setDraftAgentVariantId(index: number, agentVariantId: string | undefined) {
-    const next: StepOptions = { ...draftStepOptions.value[index] }
-    if (agentVariantId) next.agentVariantId = agentVariantId
-    else delete next.agentVariantId
-    draftStepOptions.value[index] = Object.keys(next).length ? next : null
+    patchStepOption(draftStepOptions, index, 'agentVariantId', agentVariantId || undefined)
   }
 
   /**
@@ -188,17 +220,16 @@ export function createPipelineStepConfigActions(ctx: PipelinesContext) {
    * wrong thing.
    */
   function setDraftBinaryOutput(index: number, config: BinaryOutputConfig | undefined) {
-    const next: StepOptions = { ...draftStepOptions.value[index] }
-    if (config?.storageServiceId) {
-      const { storageServiceId, contextServiceIds, generatorIds, modalities } = config
-      next.binaryOutput = {
-        storageServiceId,
-        ...(contextServiceIds?.length ? { contextServiceIds } : {}),
-        ...(generatorIds?.length ? { generatorIds } : {}),
-        ...(modalities?.length ? { modalities } : {}),
-      }
-    } else delete next.binaryOutput
-    draftStepOptions.value[index] = Object.keys(next).length ? next : null
+    const { storageServiceId, contextServiceIds, generatorIds, modalities } = config ?? {}
+    const selection = storageServiceId
+      ? {
+          storageServiceId,
+          ...(contextServiceIds?.length ? { contextServiceIds } : {}),
+          ...(generatorIds?.length ? { generatorIds } : {}),
+          ...(modalities?.length ? { modalities } : {}),
+        }
+      : undefined
+    patchStepOption(draftStepOptions, index, 'binaryOutput', selection)
   }
 
   /**
@@ -216,10 +247,7 @@ export function createPipelineStepConfigActions(ctx: PipelinesContext) {
    * other fields here.
    */
   function setDraftMaxOutputTokens(index: number, maxOutputTokens: number | undefined) {
-    const next: StepOptions = { ...draftStepOptions.value[index] }
-    if (maxOutputTokens != null) next.maxOutputTokens = maxOutputTokens
-    else delete next.maxOutputTokens
-    draftStepOptions.value[index] = Object.keys(next).length ? next : null
+    patchStepOption(draftStepOptions, index, 'maxOutputTokens', maxOutputTokens ?? undefined)
   }
 
   return {
@@ -234,6 +262,8 @@ export function createPipelineStepConfigActions(ctx: PipelinesContext) {
     toggleDraftEnabled,
     draftAutoRecommendEnabled,
     toggleDraftAutoRecommend,
+    draftRetainEnvironment,
+    toggleDraftRetainEnvironment,
     draftSkillId,
     setDraftSkillId,
     draftAgentVariantId,

package/app/utils/catalog.ts

@@ -210,12 +210,14 @@ export const AGENT_ARCHETYPES: AgentArchetype[] = [
   },
   {
     // Provisions the ephemeral environment the tester / human-test / playwright steps read, which
-    // is why it leads the testing group. A palette block for the same reason `disposer` is one:
-    // `assertDeployerBeforeConsumer` REFUSES a run whose chain reaches an env consumer with no
-    // Deployer in front of it on a deployable service, and a hand-built pipeline that hits that
-    // refusal has no reseed to fall back on.
+    // is why it leads the testing group.
+    //
+    // `basic`, and it has to be: a pipeline that reaches an env consumer with no Deployer in
+    // front of it is refused at SAVE (`validatePipelineAuthoring`), and the API Tester it serves
+    // is itself `basic`. Leaving the Deployer out of the basic palette would leave a basic-mode
+    // user composing a pipeline they cannot save and cannot see the fix for.
     kind: 'deployer',
-    tier: 'intermediate',
+    tier: 'basic',
     label: 'Deployer',
     icon: 'i-lucide-cloud-upload',
     color: '#34d399',
@@ -276,8 +278,11 @@ export const AGENT_ARCHETYPES: AgentArchetype[] = [
     // is the point of it: after the automated tester, or after a human has finished with the live
     // URL. Without one, the TTL sweep reclaims environments on a timer long after the run
     // settled, which is a fine backstop and cannot close the run's own teardown proof.
+    //
+    // `basic` for the same reason the Deployer is: a chain that deploys and never reclaims is
+    // refused at save, so the fix has to be reachable wherever the fault can be composed.
     kind: 'disposer',
-    tier: 'intermediate',
+    tier: 'basic',
     label: 'Disposer',
     icon: 'i-lucide-cloud-off',
     color: '#34d399',

package/i18n/locales/de.json

@@ -4293,6 +4293,13 @@
       "binaryOutputPlaceholder": "Speicherdienst wählen",
       "binaryOutputContextPlaceholder": "Optional: Dienste, die den Umfang bestimmen",
       "binaryOutputNeedsPick": "Für einen Schritt, der binäre Ausgaben erzeugt, ist kein Speicherdienst gewählt. Wähle einen vor dem Speichern.",
+      "envNeedsDeployer": "Vor einem Tester-, manuellen Test- oder Playwright-Schritt wird ein Deployer benötigt. Füge einen hinzu, sonst lässt sich die Pipeline nicht speichern (bei einem Service ohne Provisionierung bleibt er wirkungslos).",
+      "envNeedsDisposer": "Nach einem Deployer wird ein Disposer benötigt, der die bereitgestellte Umgebung wieder freigibt. Füge einen hinzu oder markiere den Deployer so, dass er seine Umgebung über den Lauf hinaus behält, sonst lässt sich die Pipeline nicht speichern.",
+      "envDisposerNeedsDeployer": "Vor diesem Disposer steht kein Deployer, es gibt also nichts freizugeben. Füge einen Deployer hinzu oder entferne den Disposer.",
+      "envConsumerAfterDisposer": "Ein Tester-, manueller Test- oder Playwright-Schritt läuft erst, nachdem der Disposer die Umgebung bereits freigegeben hat, es bliebe also nichts übrig, wogegen er laufen könnte. Verschiebe den Disposer hinter diesen Schritt oder füge davor einen weiteren Deployer ein.",
+      "envRetainedButReclaimed": "Dieser Deployer ist so markiert, dass er seine Umgebung über den Lauf hinaus behält, aber ein nachfolgender Disposer gibt genau diese Umgebung frei. Entferne den Disposer oder hebe die Markierung auf.",
+      "retainEnvironmentSetTooltip": "Wird am Ende des Laufs freigegeben. Klicke, um diese Umgebung danach weiterlaufen zu lassen (eine Vorschau, die Prüfende nach dem Öffnen des PR nutzen); die TTL oder ein Betreiber fährt sie dann herunter.",
+      "retainEnvironmentClearTooltip": "Läuft nach dem Ende des Laufs weiter. Klicke, um sie wieder per Disposer-Schritt freizugeben.",
       "binaryOutputNoStorage": "Kein Dienst im Katalog dieses Boards deklariert die Fähigkeit {capability}. Registriere einen, oder ergänze die Fähigkeit beim gemeinten Dienst unter den grundlegenden Diensten.",
       "binaryOutputMissing": "Dieser Speicherdienst ist nicht mehr im Katalog; wähle einen anderen.",
       "binaryOutputNotStorage": "Dieser Dienst deklariert die Fähigkeit {capability} nicht mehr, deshalb werden Läufe abgelehnt; wähle einen anderen.",

package/i18n/locales/en.json

@@ -4881,6 +4881,13 @@
       "binaryOutputPlaceholder": "Pick a storage service",
       "binaryOutputContextPlaceholder": "Optional: services that scope the generation",
       "binaryOutputNeedsPick": "A step that generates binary outputs has no storage service selected. Pick one before saving.",
+      "envNeedsDeployer": "A Tester, human-test or Playwright step needs a Deployer before it. Add one or the pipeline won't save (it is a no-op on a service that provisions nothing).",
+      "envNeedsDisposer": "A Deployer needs a Disposer after it to reclaim the environment it stands up. Add one, or mark the Deployer as keeping its environment past the run, otherwise the pipeline won't save.",
+      "envDisposerNeedsDeployer": "This Disposer has no Deployer before it, so there is nothing for it to reclaim. Add a Deployer, or remove the Disposer.",
+      "envConsumerAfterDisposer": "A Tester, human-test or Playwright step runs after the Disposer has already reclaimed the environment, so nothing would be left to run against. Move the Disposer below that step, or add another Deployer before it.",
+      "envRetainedButReclaimed": "This Deployer is marked as keeping its environment past the run, but a Disposer after it reclaims exactly that environment. Remove the Disposer, or clear the keep-environment setting.",
+      "retainEnvironmentSetTooltip": "Reclaimed at the end of the run. Click to keep this environment running afterwards (a preview reviewers use once the PR is open); its TTL or an operator then takes it down.",
+      "retainEnvironmentClearTooltip": "Kept running after the run ends. Click to go back to reclaiming it with a Disposer step.",
       "binaryOutputNoStorage": "No service in this board's catalog declares the {capability} capability. Register one, or add the capability to the service you meant, under foundational services.",
       "binaryOutputMissing": "This storage service is no longer in the catalog; pick another.",
       "binaryOutputNotStorage": "This service no longer declares the {capability} capability, so runs will be refused; pick another.",

package/i18n/locales/es.json

@@ -4732,6 +4732,13 @@
       "binaryOutputPlaceholder": "Elige un servicio de almacenamiento",
       "binaryOutputContextPlaceholder": "Opcional: servicios que delimitan la generación",
       "binaryOutputNeedsPick": "Un paso que genera salidas binarias no tiene servicio de almacenamiento elegido. Elige uno antes de guardar.",
+      "envNeedsDeployer": "Un paso de Tester, prueba manual o Playwright necesita un Deployer antes. Añade uno o la canalización no se guardará (no hace nada en un servicio que no aprovisiona).",
+      "envNeedsDisposer": "Un Deployer necesita un Disposer después para liberar el entorno que levanta. Añade uno, o marca el Deployer para que conserve su entorno más allá de la ejecución; de lo contrario la canalización no se guardará.",
+      "envDisposerNeedsDeployer": "Este Disposer no tiene ningún Deployer antes, así que no hay nada que liberar. Añade un Deployer o quita el Disposer.",
+      "envConsumerAfterDisposer": "Un paso de Tester, prueba manual o Playwright se ejecuta después de que el Disposer ya haya liberado el entorno, así que no quedaría nada contra lo que ejecutarlo. Mueve el Disposer por debajo de ese paso, o añade otro Deployer antes.",
+      "envRetainedButReclaimed": "Este Deployer está marcado para conservar su entorno más allá de la ejecución, pero un Disposer posterior libera exactamente ese entorno. Quita el Disposer o desmarca la opción de conservar el entorno.",
+      "retainEnvironmentSetTooltip": "Se libera al terminar la ejecución. Haz clic para mantener este entorno en marcha después (una vista previa que los revisores usan con el PR abierto); luego lo retirará su TTL o un operador.",
+      "retainEnvironmentClearTooltip": "Se mantiene en marcha tras la ejecución. Haz clic para volver a liberarlo con un paso Disposer.",
       "binaryOutputNoStorage": "Ningún servicio del catálogo de este tablero declara la capacidad {capability}. Registra uno, o añade la capacidad al servicio que tenías en mente, en servicios fundamentales.",
       "binaryOutputMissing": "Este servicio de almacenamiento ya no está en el catálogo; elige otro.",
       "binaryOutputNotStorage": "Este servicio ya no declara la capacidad {capability}, así que las ejecuciones se rechazarán; elige otro.",

package/i18n/locales/fr.json

@@ -4732,6 +4732,13 @@
       "binaryOutputPlaceholder": "Choisir un service de stockage",
       "binaryOutputContextPlaceholder": "Facultatif : services qui délimitent la génération",
       "binaryOutputNeedsPick": "Une étape qui génère des sorties binaires n'a aucun service de stockage choisi. Choisissez-en un avant d'enregistrer.",
+      "envNeedsDeployer": "Une étape Tester, de test manuel ou Playwright a besoin d'un Deployer avant elle. Ajoutez-en un, sinon le pipeline ne sera pas enregistré (il ne fait rien sur un service qui ne provisionne rien).",
+      "envNeedsDisposer": "Un Deployer a besoin d'un Disposer après lui pour libérer l'environnement qu'il provisionne. Ajoutez-en un, ou marquez le Deployer comme conservant son environnement au-delà de l'exécution, sinon le pipeline ne sera pas enregistré.",
+      "envDisposerNeedsDeployer": "Ce Disposer n'a aucun Deployer avant lui, il n'a donc rien à libérer. Ajoutez un Deployer ou retirez le Disposer.",
+      "envConsumerAfterDisposer": "Une étape Tester, de test manuel ou Playwright s'exécute après que le Disposer a déjà libéré l'environnement : il ne resterait rien pour l'exécuter. Déplacez le Disposer après cette étape, ou ajoutez un autre Deployer avant elle.",
+      "envRetainedButReclaimed": "Ce Deployer est marqué comme conservant son environnement au-delà de l'exécution, mais un Disposer placé après lui libère précisément cet environnement. Retirez le Disposer, ou désactivez la conservation de l'environnement.",
+      "retainEnvironmentSetTooltip": "Libéré à la fin de l'exécution. Cliquez pour laisser cet environnement actif ensuite (un aperçu que les relecteurs utilisent une fois la PR ouverte) ; son TTL ou un opérateur l'arrêtera.",
+      "retainEnvironmentClearTooltip": "Reste actif après la fin de l'exécution. Cliquez pour le libérer de nouveau via une étape Disposer.",
       "binaryOutputNoStorage": "Aucun service du catalogue de ce tableau ne déclare la capacité {capability}. Enregistrez-en un, ou ajoutez la capacité au service que vous visiez, dans les services fondamentaux.",
       "binaryOutputMissing": "Ce service de stockage n'est plus dans le catalogue ; choisissez-en un autre.",
       "binaryOutputNotStorage": "Ce service ne déclare plus la capacité {capability}, les exécutions seront donc refusées ; choisissez-en un autre.",

package/i18n/locales/he.json

@@ -4732,6 +4732,13 @@
       "binaryOutputPlaceholder": "בחר שירות אחסון",
       "binaryOutputContextPlaceholder": "לא חובה: שירותים שמגדירים את היקף היצירה",
       "binaryOutputNeedsPick": "לשלב שמייצר פלטים בינאריים לא נבחר שירות אחסון. בחר אחד לפני השמירה.",
+      "envNeedsDeployer": "שלב Tester, בדיקה ידנית או Playwright דורש Deployer לפניו. הוסף אחד, אחרת הצינור לא יישמר (בשירות שאינו מקצה סביבה הוא לא עושה דבר).",
+      "envNeedsDisposer": "אחרי Deployer נדרש Disposer שישחרר את הסביבה שהוקצתה. הוסף אחד, או סמן את ה-Deployer כשומר על הסביבה שלו גם אחרי הריצה, אחרת הצינור לא יישמר.",
+      "envDisposerNeedsDeployer": "לפני ה-Disposer הזה אין Deployer, ולכן אין מה לשחרר. הוסף Deployer או הסר את ה-Disposer.",
+      "envConsumerAfterDisposer": "שלב Tester, בדיקה ידנית או Playwright רץ אחרי שה-Disposer כבר שחרר את הסביבה, ולכן לא יישאר דבר להריץ מולו. העבר את ה-Disposer מתחת לשלב הזה, או הוסף Deployer נוסף לפניו.",
+      "envRetainedButReclaimed": "ה-Deployer הזה מסומן כשומר על הסביבה שלו גם אחרי הריצה, אך Disposer שאחריו משחרר בדיוק את אותה סביבה. הסר את ה-Disposer, או בטל את סימון שמירת הסביבה.",
+      "retainEnvironmentSetTooltip": "משוחררת בסוף הריצה. לחץ כדי להשאיר את הסביבה פעילה אחריה (תצוגה מקדימה שסוקרים משתמשים בה אחרי פתיחת ה-PR); ה-TTL או מפעיל יורידו אותה בהמשך.",
+      "retainEnvironmentClearTooltip": "נשארת פעילה אחרי סיום הריצה. לחץ כדי לחזור לשחרור שלה בשלב Disposer.",
       "binaryOutputNoStorage": "אף שירות בקטלוג של לוח זה אינו מצהיר על יכולת {capability}. רשום שירות כזה, או הוסף את היכולת לשירות שהתכוונת אליו, תחת שירותי בסיס.",
       "binaryOutputMissing": "שירות אחסון זה כבר אינו בקטלוג; בחר אחר.",
       "binaryOutputNotStorage": "השירות הזה כבר אינו מצהיר על יכולת {capability}, ולכן הרצות יידחו; בחר אחר.",

package/i18n/locales/it.json

@@ -4293,6 +4293,13 @@
       "binaryOutputPlaceholder": "Scegli un servizio di archiviazione",
       "binaryOutputContextPlaceholder": "Facoltativo: servizi che delimitano la generazione",
       "binaryOutputNeedsPick": "Un passo che genera output binari non ha un servizio di archiviazione scelto. Scegline uno prima di salvare.",
+      "envNeedsDeployer": "Un passaggio Tester, di test manuale o Playwright ha bisogno di un Deployer prima di sé. Aggiungine uno, altrimenti la pipeline non verrà salvata (su un servizio che non effettua provisioning non fa nulla).",
+      "envNeedsDisposer": "Un Deployer ha bisogno di un Disposer dopo di sé, che liberi l'ambiente creato. Aggiungine uno, oppure contrassegna il Deployer come tale da mantenere il proprio ambiente oltre l'esecuzione, altrimenti la pipeline non verrà salvata.",
+      "envDisposerNeedsDeployer": "Questo Disposer non ha alcun Deployer prima di sé, quindi non ha nulla da liberare. Aggiungi un Deployer oppure rimuovi il Disposer.",
+      "envConsumerAfterDisposer": "Un passaggio Tester, di test manuale o Playwright viene eseguito dopo che il Disposer ha già liberato l'ambiente, quindi non resterebbe nulla su cui eseguirlo. Sposta il Disposer dopo quel passaggio, oppure aggiungi un altro Deployer prima di esso.",
+      "envRetainedButReclaimed": "Questo Deployer è contrassegnato come tale da mantenere il proprio ambiente oltre l'esecuzione, ma un Disposer successivo libera proprio quell'ambiente. Rimuovi il Disposer, oppure togli il contrassegno di mantenimento dell'ambiente.",
+      "retainEnvironmentSetTooltip": "Liberato al termine dell'esecuzione. Fai clic per lasciare questo ambiente attivo dopo (un'anteprima che i revisori usano a PR aperta); lo spegneranno poi il suo TTL o un operatore.",
+      "retainEnvironmentClearTooltip": "Resta attivo dopo la fine dell'esecuzione. Fai clic per tornare a liberarlo con un passaggio Disposer.",
       "binaryOutputNoStorage": "Nessun servizio nel catalogo di questa board dichiara la capacità {capability}. Registrane uno, oppure aggiungi la capacità al servizio che intendevi, nei servizi fondamentali.",
       "binaryOutputMissing": "Questo servizio di archiviazione non è più nel catalogo; scegline un altro.",
       "binaryOutputNotStorage": "Questo servizio non dichiara più la capacità {capability}, quindi le esecuzioni verranno rifiutate; scegline un altro.",

package/i18n/locales/ja.json

@@ -4732,6 +4732,13 @@
       "binaryOutputPlaceholder": "保存サービスを選択",
       "binaryOutputContextPlaceholder": "任意: 生成の範囲を定めるサービス",
       "binaryOutputNeedsPick": "バイナリ成果物を生成するステップに保存サービスが選択されていません。保存前に選んでください。",
+      "envNeedsDeployer": "Tester、手動テスト、または Playwright のステップの前には Deployer が必要です。追加しないとパイプラインは保存できません（プロビジョニングしないサービスでは何もしません）。",
+      "envNeedsDisposer": "Deployer の後には、用意した環境を解放する Disposer が必要です。追加するか、Deployer に実行後も環境を残す設定を付けてください。どちらもない場合、パイプラインは保存できません。",
+      "envDisposerNeedsDeployer": "この Disposer の前に Deployer がないため、解放する対象がありません。Deployer を追加するか、Disposer を削除してください。",
+      "envConsumerAfterDisposer": "Tester、手動テスト、または Playwright のステップが、Disposer が環境を解放した後に実行されるため、実行対象が残りません。Disposer をそのステップより後ろに移すか、その前にもう一つ Deployer を追加してください。",
+      "envRetainedButReclaimed": "この Deployer には実行後も環境を残す設定が付いていますが、後続の Disposer がまさにその環境を解放します。Disposer を削除するか、環境を残す設定を解除してください。",
+      "retainEnvironmentSetTooltip": "実行の終了時に解放されます。クリックすると実行後も環境を残します（PR を開いた後にレビュアーが使うプレビュー用）。その後は TTL または運用者が停止します。",
+      "retainEnvironmentClearTooltip": "実行の終了後も環境を残します。クリックすると Disposer ステップで解放する動作に戻ります。",
       "binaryOutputNoStorage": "このボードのカタログに {capability} 機能を宣言するサービスがありません。基盤サービスで新たに登録するか、意図したサービスにこの機能を追加してください。",
       "binaryOutputMissing": "この保存サービスはカタログに存在しません。別のサービスを選んでください。",
       "binaryOutputNotStorage": "このサービスは {capability} 機能を宣言しなくなったため、実行は拒否されます。別のサービスを選んでください。",

package/i18n/locales/pl.json

@@ -4732,6 +4732,13 @@
       "binaryOutputPlaceholder": "Wybierz usługę przechowywania",
       "binaryOutputContextPlaceholder": "Opcjonalnie: usługi wyznaczające zakres generowania",
       "binaryOutputNeedsPick": "Krok generujący wyjścia binarne nie ma wybranej usługi przechowywania. Wybierz ją przed zapisaniem.",
+      "envNeedsDeployer": "Krok Tester, testu manualnego lub Playwright wymaga Deployera przed sobą. Dodaj go, inaczej potok nie zostanie zapisany (przy usłudze bez provisioningu nic nie robi).",
+      "envNeedsDisposer": "Deployer wymaga Disposera po sobie, który zwolni utworzone środowisko. Dodaj go albo oznacz Deployera jako zachowującego środowisko po zakończeniu przebiegu, inaczej potok nie zostanie zapisany.",
+      "envDisposerNeedsDeployer": "Przed tym Disposerem nie ma Deployera, więc nie ma czego zwalniać. Dodaj Deployera albo usuń Disposera.",
+      "envConsumerAfterDisposer": "Krok Tester, testu manualnego lub Playwright wykonuje się po tym, jak Disposer zwolnił już środowisko, więc nie zostanie nic, na czym mógłby działać. Przesuń Disposera poniżej tego kroku albo dodaj przed nim kolejnego Deployera.",
+      "envRetainedButReclaimed": "Ten Deployer jest oznaczony jako zachowujący środowisko po zakończeniu przebiegu, ale Disposer za nim zwalnia dokładnie to środowisko. Usuń Disposera albo wyłącz zachowywanie środowiska.",
+      "retainEnvironmentSetTooltip": "Zwalniane na koniec przebiegu. Kliknij, aby zostawić to środowisko działające po jego zakończeniu (podgląd, z którego recenzenci korzystają po otwarciu PR); później wyłączy je TTL lub operator.",
+      "retainEnvironmentClearTooltip": "Działa po zakończeniu przebiegu. Kliknij, aby wrócić do zwalniania go krokiem Disposer.",
       "binaryOutputNoStorage": "Żadna usługa w katalogu tej tablicy nie deklaruje możliwości {capability}. Zarejestruj taką usługę albo dodaj tę możliwość właściwej usłudze w usługach podstawowych.",
       "binaryOutputMissing": "Tej usługi przechowywania nie ma już w katalogu; wybierz inną.",
       "binaryOutputNotStorage": "Ta usługa nie deklaruje już możliwości {capability}, więc uruchomienia będą odrzucane; wybierz inną.",

package/i18n/locales/tr.json

@@ -4732,6 +4732,13 @@
       "binaryOutputPlaceholder": "Bir depolama hizmeti seç",
       "binaryOutputContextPlaceholder": "İsteğe bağlı: üretimin kapsamını belirleyen hizmetler",
       "binaryOutputNeedsPick": "İkili çıktı üreten bir adımda depolama hizmeti seçilmemiş. Kaydetmeden önce birini seç.",
+      "envNeedsDeployer": "Tester, manuel test veya Playwright adımının öncesinde bir Deployer gerekir. Bir tane ekle, yoksa işlem hattı kaydedilmez (hiçbir şey sağlamayan bir hizmette etkisizdir).",
+      "envNeedsDisposer": "Bir Deployer'ın ardından, oluşturduğu ortamı geri alan bir Disposer gerekir. Bir tane ekle ya da Deployer'ı, ortamını çalıştırma sonrasında da koruyacak biçimde işaretle; aksi hâlde işlem hattı kaydedilmez.",
+      "envDisposerNeedsDeployer": "Bu Disposer'dan önce bir Deployer yok, dolayısıyla geri alınacak bir şey de yok. Bir Deployer ekle ya da Disposer'ı kaldır.",
+      "envConsumerAfterDisposer": "Tester, manuel test veya Playwright adımı, Disposer ortamı geri aldıktan sonra çalışıyor; dolayısıyla üzerinde çalışılacak bir şey kalmaz. Disposer'ı bu adımın altına taşı ya da öncesine bir Deployer daha ekle.",
+      "envRetainedButReclaimed": "Bu Deployer, ortamını çalıştırma sonrasında da koruyacak biçimde işaretli, ancak ardındaki bir Disposer tam olarak o ortamı geri alıyor. Disposer'ı kaldır ya da ortamı koruma işaretini temizle.",
+      "retainEnvironmentSetTooltip": "Çalıştırmanın sonunda geri alınır. Bu ortamı sonrasında da açık bırakmak için tıkla (PR açıldıktan sonra inceleyicilerin kullandığı bir önizleme); ardından TTL'i ya da bir operatör kapatır.",
+      "retainEnvironmentClearTooltip": "Çalıştırma bittikten sonra da açık kalır. Disposer adımıyla geri almaya dönmek için tıkla.",
       "binaryOutputNoStorage": "Bu panonun katalogundaki hiçbir hizmet {capability} yeteneğini bildirmiyor. Temel hizmetler altında bir hizmet kaydet ya da kastettiğin hizmete bu yeteneği ekle.",
       "binaryOutputMissing": "Bu depolama hizmeti artık katalogda yok; başka birini seç.",
       "binaryOutputNotStorage": "Bu hizmet artık {capability} yeteneğini bildirmiyor, bu yüzden çalıştırmalar reddedilecek; başka birini seç.",

package/i18n/locales/uk.json

@@ -4732,6 +4732,13 @@
       "binaryOutputPlaceholder": "Оберіть службу зберігання",
       "binaryOutputContextPlaceholder": "Необовʼязково: служби, які визначають межі генерації",
       "binaryOutputNeedsPick": "Для кроку, який генерує бінарні результати, не обрано службу зберігання. Оберіть її перед збереженням.",
+      "envNeedsDeployer": "Крок Tester, ручного тесту або Playwright потребує Deployer перед собою. Додай його, інакше конвеєр не збережеться (для служби без провізіювання він нічого не робить).",
+      "envNeedsDisposer": "Після Deployer потрібен Disposer, який звільнить створене середовище. Додай його або познач Deployer як такий, що зберігає своє середовище після завершення прогону, інакше конвеєр не збережеться.",
+      "envDisposerNeedsDeployer": "Перед цим Disposer немає Deployer, тож звільняти нічого. Додай Deployer або прибери Disposer.",
+      "envConsumerAfterDisposer": "Крок Tester, ручного тесту або Playwright виконується після того, як Disposer уже звільнив середовище, тож не залишиться нічого, на чому його запускати. Перемісти Disposer нижче за цей крок або додай ще один Deployer перед ним.",
+      "envRetainedButReclaimed": "Цей Deployer позначено як такий, що зберігає своє середовище після прогону, але Disposer після нього звільняє саме це середовище. Прибери Disposer або зніми позначку збереження середовища.",
+      "retainEnvironmentSetTooltip": "Звільняється наприкінці прогону. Натисни, щоб залишити це середовище працювати після нього (попередній перегляд, яким рецензенти користуються після відкриття PR); згодом його вимкне TTL або оператор.",
+      "retainEnvironmentClearTooltip": "Працює після завершення прогону. Натисни, щоб повернутися до звільнення його кроком Disposer.",
       "binaryOutputNoStorage": "Жодна служба в каталозі цієї дошки не заявляє здатність {capability}. Зареєструйте таку службу або додайте цю здатність потрібній службі в базових службах.",
       "binaryOutputMissing": "Цієї служби зберігання більше немає в каталозі; оберіть іншу.",
       "binaryOutputNotStorage": "Ця служба більше не заявляє здатність {capability}, тому запуски буде відхилено; оберіть іншу.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.255.0",
+  "version": "0.255.1",
   "description": "Reusable Nuxt layer for the Agent Architecture Board SPA (components, stores, composables, pages). Consume it from a thin deployment app via `extends: ['@cat-factory/app']` and point it at your backend with NUXT_PUBLIC_API_BASE. See deploy/frontend for an example.",
   "repository": {
     "type": "git",
@@ -40,7 +40,7 @@
     "valibot": "^1.4.2",
     "vue": "3.5.40",
     "wretch": "^3.0.9",
-    "@cat-factory/contracts": "0.281.0"
+    "@cat-factory/contracts": "0.282.0"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",