@cat-factory/app 0.152.0 → 0.153.0

package/app/stores/pipelines/draftActions.ts

@@ -0,0 +1,307 @@
+import { computed } from 'vue'
+import type { AgentKind, Pipeline } from '~/types/domain'
+import type { ConsensusStepConfig } from '~/types/consensus'
+import type { StepOptions } from '@cat-factory/contracts'
+import { companionForProducer } from '~/utils/catalog'
+import { defaultConsensusConfig, type PipelinesContext } from './context'
+
+/**
+ * The pipeline-builder draft manipulation: inserting/removing/reordering steps and toggling each
+ * step's per-step config, plus `clearDraft` / `loadForEdit`. Extracted from the store setup into a
+ * factory closing over the shared {@link PipelinesContext} so behaviour is byte-identical to the
+ * former in-closure functions — the split is purely to keep the setup within the size budget.
+ */
+export function createPipelineDraftActions(ctx: PipelinesContext) {
+  const {
+    draft,
+    draftGates,
+    draftEnabled,
+    draftThresholds,
+    draftConsensus,
+    draftGating,
+    draftFollowUps,
+    draftTesterQuality,
+    draftStepOptions,
+    draftLabels,
+    draftPurpose,
+    draftName,
+    draftDescription,
+    editingId,
+  } = ctx
+
+  /** Insert a step (with its default per-step config) at `index`, keeping arrays aligned. */
+  function insertAt(index: number, kind: AgentKind) {
+    draft.value.splice(index, 0, kind)
+    draftGates.value.splice(index, 0, false)
+    draftEnabled.value.splice(index, 0, true)
+    draftThresholds.value.splice(index, 0, null)
+    draftConsensus.value.splice(index, 0, null)
+    draftGating.value.splice(index, 0, null)
+    draftFollowUps.value.splice(index, 0, null)
+    draftTesterQuality.value.splice(index, 0, null)
+    draftStepOptions.value.splice(index, 0, null)
+  }
+
+  function addToDraft(kind: AgentKind) {
+    insertAt(draft.value.length, kind)
+  }
+
+  function removeFromDraft(index: number) {
+    draft.value.splice(index, 1)
+    draftGates.value.splice(index, 1)
+    draftEnabled.value.splice(index, 1)
+    draftThresholds.value.splice(index, 1)
+    draftConsensus.value.splice(index, 1)
+    draftGating.value.splice(index, 1)
+    draftFollowUps.value.splice(index, 1)
+    draftTesterQuality.value.splice(index, 1)
+    draftStepOptions.value.splice(index, 1)
+  }
+
+  function moveInDraft(from: number, to: number) {
+    if (to < 0 || to >= draft.value.length) return
+    const [item] = draft.value.splice(from, 1)
+    if (item) draft.value.splice(to, 0, item)
+    const [gate] = draftGates.value.splice(from, 1)
+    draftGates.value.splice(to, 0, gate ?? false)
+    const [on] = draftEnabled.value.splice(from, 1)
+    draftEnabled.value.splice(to, 0, on ?? true)
+    const [th] = draftThresholds.value.splice(from, 1)
+    draftThresholds.value.splice(to, 0, th ?? null)
+    const [cons] = draftConsensus.value.splice(from, 1)
+    draftConsensus.value.splice(to, 0, cons ?? null)
+    const [gat] = draftGating.value.splice(from, 1)
+    draftGating.value.splice(to, 0, gat ?? null)
+    const [fu] = draftFollowUps.value.splice(from, 1)
+    draftFollowUps.value.splice(to, 0, fu ?? null)
+    const [tq] = draftTesterQuality.value.splice(from, 1)
+    draftTesterQuality.value.splice(to, 0, tq ?? null)
+    const [so] = draftStepOptions.value.splice(from, 1)
+    draftStepOptions.value.splice(to, 0, so ?? null)
+  }
+
+  /** Whether the producer step at `index` currently has its companion attached after it. */
+  function hasCompanion(index: number): boolean {
+    const companion = companionForProducer(draft.value[index] ?? '')
+    return companion !== undefined && draft.value[index + 1] === companion
+  }
+
+  /**
+   * Toggle the dependent companion on the producer step at `index`: insert it immediately
+   * after (turn on) or remove it (turn off). A no-op for a kind that has no companion.
+   */
+  function toggleCompanion(index: number) {
+    const companion = companionForProducer(draft.value[index] ?? '')
+    if (!companion) return
+    if (draft.value[index + 1] === companion) removeFromDraft(index + 1)
+    else insertAt(index + 1, companion)
+  }
+
+  /** Toggle estimate gating on/off for the (companion) step at `index`. */
+  function toggleDraftGating(index: number) {
+    draftGating.value[index] = draftGating.value[index]?.enabled
+      ? null
+      : { enabled: true, minRisk: 0.5, minImpact: 0.5, onMissingEstimate: 'run' }
+  }
+
+  /**
+   * The draft as a list of "units" for rendering: each step is one unit, EXCEPT a companion
+   * that sits immediately after its producer — that companion is folded into the producer's
+   * unit (`companionIndex`) and surfaced as a toggle on it, not a standalone row. The backend
+   * now REJECTS a companion that is not immediately after its producer (strict adjacency in
+   * `validatePipelineShape`), so a saved pipeline never has one — but a stray companion that
+   * still shows up in the draft (e.g. a pre-existing pipeline saved before adjacency was
+   * enforced) is emitted as its own standalone unit so it stays visible and removable/
+   * reorderable into a valid shape rather than being silently dropped — and, crucially, so
+   * every `draft` index belongs to exactly one unit, which is what lets {@link moveUnit}
+   * reorder by unit boundaries without ever dropping a step.
+   * `index`/`companionIndex` are positions in the raw `draft` arrays.
+   */
+  const units = computed(() => {
+    const out: { index: number; kind: AgentKind; companionIndex: number | null }[] = []
+    let folded = -1 // draft index already consumed as the previous unit's adjacent companion
+    for (let i = 0; i < draft.value.length; i++) {
+      const kind = draft.value[i]
+      if (kind === undefined || i === folded) continue
+      const companion = companionForProducer(kind)
+      const companionIndex = companion && draft.value[i + 1] === companion ? i + 1 : null
+      if (companionIndex !== null) folded = companionIndex
+      out.push({ index: i, kind, companionIndex })
+    }
+    return out
+  })
+
+  /**
+   * Move the unit at visible position `from` to `to`, carrying its attached companion. Rebuilds
+   * every parallel array by the SAME unit boundaries so they stay index-aligned.
+   */
+  function moveUnit(from: number, to: number) {
+    const u = units.value
+    if (to < 0 || to >= u.length || from === to) return
+    const reorder = <T>(arr: T[]): T[] => {
+      const chunks = u.map((unit) =>
+        arr.slice(unit.index, unit.index + (unit.companionIndex !== null ? 2 : 1)),
+      )
+      const [moved] = chunks.splice(from, 1)
+      if (moved) chunks.splice(to, 0, moved)
+      return chunks.flat()
+    }
+    draft.value = reorder(draft.value)
+    draftGates.value = reorder(draftGates.value)
+    draftEnabled.value = reorder(draftEnabled.value)
+    draftThresholds.value = reorder(draftThresholds.value)
+    draftConsensus.value = reorder(draftConsensus.value)
+    draftGating.value = reorder(draftGating.value)
+    draftFollowUps.value = reorder(draftFollowUps.value)
+    draftTesterQuality.value = reorder(draftTesterQuality.value)
+    draftStepOptions.value = reorder(draftStepOptions.value)
+  }
+
+  /** Toggle the consensus mechanism on the draft step at `index` (default config / off). */
+  function toggleDraftConsensus(index: number) {
+    draftConsensus.value[index] = draftConsensus.value[index] ? null : defaultConsensusConfig()
+  }
+
+  /** Replace the consensus config of the draft step at `index` (builder editor edits). */
+  function setDraftConsensus(index: number, config: ConsensusStepConfig | null) {
+    draftConsensus.value[index] = config
+  }
+
+  /** Toggle the approval gate on the draft step at `index`. */
+  function toggleDraftGate(index: number) {
+    draftGates.value[index] = !draftGates.value[index]
+  }
+
+  /** Toggle the Follow-up companion on the draft (coder) step at `index` (default on → off). */
+  function toggleDraftFollowUps(index: number) {
+    // Default (null/true) is enabled, so the first toggle disables it (false); toggle back to null.
+    draftFollowUps.value[index] = draftFollowUps.value[index] === false ? null : false
+  }
+
+  /**
+   * Toggle the test quality-control companion on the draft (Tester) step at `index`. The
+   * companion is enabled by default (a `null` entry), so the first toggle disables it
+   * (`{ enabled: false }`, dropping any gating) and the next restores the default.
+   */
+  function toggleDraftTesterQuality(index: number) {
+    draftTesterQuality.value[index] =
+      draftTesterQuality.value[index]?.enabled === false ? null : { enabled: false }
+  }
+
+  /**
+   * Toggle estimate gating on/off for the QC companion on the draft (Tester) step at `index`.
+   * A no-op while the companion is disabled (nothing to gate). Enabling gating pins the config
+   * to `{ enabled: true, gating }` so the thresholds are editable; disabling drops back to the
+   * default `null` (enabled, ungated).
+   */
+  function toggleDraftTesterQualityGating(index: number) {
+    const cur = draftTesterQuality.value[index]
+    if (cur?.enabled === false) return
+    draftTesterQuality.value[index] = cur?.gating?.enabled
+      ? null
+      : {
+          enabled: true,
+          gating: { enabled: true, minRisk: 0.5, minImpact: 0.5, onMissingEstimate: 'run' },
+        }
+  }
+
+  /** Enable/disable the draft step at `index` without removing it. */
+  function toggleDraftEnabled(index: number) {
+    draftEnabled.value[index] = draftEnabled.value[index] === false
+  }
+
+  /** Whether auto-recommendation is on for the draft (requirements-review) step at `index`. */
+  function draftAutoRecommendEnabled(index: number): boolean {
+    return draftStepOptions.value[index]?.autoRecommend !== false
+  }
+
+  /**
+   * Toggle the requirements-review auto-recommendation on the draft step at `index`. It is on by
+   * default, so we store ONLY the opt-out (`{ autoRecommend: false }`); toggling back drops the
+   * 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
+  }
+
+  /** The skill picked for the draft `skill` step at `index` (its `stepOptions.skillId`). */
+  function draftSkillId(index: number): string | undefined {
+    return draftStepOptions.value[index]?.skillId
+  }
+
+  /**
+   * Set (or clear) the picked skill on the draft `skill` step at `index`. Merges into the
+   * step's `StepOptions` bag rather than clobbering it; clearing drops the field and, if the
+   * 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
+  }
+
+  function clearDraft() {
+    draft.value = []
+    draftGates.value = []
+    draftEnabled.value = []
+    draftThresholds.value = []
+    draftConsensus.value = []
+    draftGating.value = []
+    draftFollowUps.value = []
+    draftTesterQuality.value = []
+    draftStepOptions.value = []
+    draftLabels.value = []
+    draftPurpose.value = null
+    draftName.value = 'New pipeline'
+    draftDescription.value = ''
+    editingId.value = null
+  }
+
+  /** Load an existing (custom) pipeline into the draft so it can be edited in place. */
+  function loadForEdit(pipeline: Pipeline) {
+    draft.value = [...pipeline.agentKinds]
+    draftGates.value = pipeline.agentKinds.map((_, i) => pipeline.gates?.[i] ?? false)
+    draftEnabled.value = pipeline.agentKinds.map((_, i) => pipeline.enabled?.[i] ?? true)
+    draftThresholds.value = pipeline.agentKinds.map((_, i) => pipeline.thresholds?.[i] ?? null)
+    draftConsensus.value = pipeline.agentKinds.map((_, i) => pipeline.consensus?.[i] ?? null)
+    draftGating.value = pipeline.agentKinds.map((_, i) => pipeline.gating?.[i] ?? null)
+    draftFollowUps.value = pipeline.agentKinds.map((_, i) => pipeline.followUps?.[i] ?? null)
+    draftTesterQuality.value = pipeline.agentKinds.map(
+      (_, i) => pipeline.testerQuality?.[i] ?? null,
+    )
+    draftStepOptions.value = pipeline.agentKinds.map((_, i) => pipeline.stepOptions?.[i] ?? null)
+    draftLabels.value = [...(pipeline.labels ?? [])]
+    draftPurpose.value = pipeline.purpose ?? null
+    draftName.value = pipeline.name
+    draftDescription.value = pipeline.description ?? ''
+    editingId.value = pipeline.id
+  }
+
+  return {
+    addToDraft,
+    removeFromDraft,
+    moveInDraft,
+    hasCompanion,
+    toggleCompanion,
+    toggleDraftGating,
+    units,
+    moveUnit,
+    toggleDraftConsensus,
+    setDraftConsensus,
+    toggleDraftGate,
+    toggleDraftFollowUps,
+    toggleDraftTesterQuality,
+    toggleDraftTesterQualityGating,
+    toggleDraftEnabled,
+    draftAutoRecommendEnabled,
+    toggleDraftAutoRecommend,
+    draftSkillId,
+    setDraftSkillId,
+    clearDraft,
+    loadForEdit,
+  }
+}

package/app/stores/pipelines/persistence.ts

@@ -0,0 +1,136 @@
+import type { Pipeline } from '~/types/domain'
+import { useWorkspaceStore } from '~/stores/workspace'
+import type { PipelinesContext } from './context'
+
+/**
+ * The pipeline persistence operations — building the draft payload and the create/update/clone/
+ * remove/reseed/organize API calls. Extracted from the store setup into a factory closing over the
+ * shared {@link PipelinesContext} plus the draft-lifecycle helpers it drives (`clearDraft` /
+ * `loadForEdit`, owned by {@link createPipelineDraftActions}), so behaviour is byte-identical to the
+ * former in-closure functions — the split is purely to keep the setup within the size budget.
+ */
+export function createPipelinePersistence(
+  ctx: PipelinesContext,
+  draft: { clearDraft: () => void; loadForEdit: (pipeline: Pipeline) => void },
+) {
+  const { api, upsertPipeline, dropPipeline, editingId } = ctx
+  const { clearDraft, loadForEdit } = draft
+
+  /** The optional arrays to send, omitting the ones that are at their defaults. */
+  function draftPayload() {
+    return {
+      name: ctx.draftName.value.trim() || 'Untitled pipeline',
+      // ALWAYS send description (like stepOptions) so an update can CLEAR it — an omitted field
+      // reads as "keep existing", so toggling the last of the text away must send the empty string.
+      // The backend trims + drops a blank one, so this is a no-op on create / an empty description.
+      description: ctx.draftDescription.value.trim(),
+      agentKinds: [...ctx.draft.value],
+      // Only send gates when at least one step is gated.
+      ...(ctx.draftGates.value.some(Boolean) ? { gates: [...ctx.draftGates.value] } : {}),
+      // Only send enabled when at least one step is disabled (default is all-on).
+      ...(ctx.draftEnabled.value.some((e) => e === false)
+        ? { enabled: [...ctx.draftEnabled.value] }
+        : {}),
+      // Only send thresholds when at least one step pins an explicit value.
+      ...(ctx.draftThresholds.value.some((t) => t != null)
+        ? { thresholds: [...ctx.draftThresholds.value] }
+        : {}),
+      // Only send consensus when at least one step is consensus-enabled.
+      ...(ctx.draftConsensus.value.some((c) => c?.enabled)
+        ? { consensus: [...ctx.draftConsensus.value] }
+        : {}),
+      // Only send gating when at least one step has gating enabled.
+      ...(ctx.draftGating.value.some((g) => g?.enabled)
+        ? { gating: [...ctx.draftGating.value] }
+        : {}),
+      // Only send followUps when at least one step disables it (default is on, so only the
+      // explicit `false` opt-outs are worth persisting).
+      ...(ctx.draftFollowUps.value.some((f) => f === false)
+        ? { followUps: [...ctx.draftFollowUps.value] }
+        : {}),
+      // Only send testerQuality when at least one Tester step deviates from the default
+      // (companion disabled, or an estimate gate configured) — the default (null/enabled,
+      // ungated) is not worth persisting.
+      ...(ctx.draftTesterQuality.value.some((q) => q?.enabled === false || q?.gating?.enabled)
+        ? { testerQuality: [...ctx.draftTesterQuality.value] }
+        : {}),
+      // ALWAYS send stepOptions, unlike the legacy per-step arrays above. Those omit-when-default,
+      // which means an update can never CLEAR them (an omitted field reads as "keep existing"), so
+      // toggling the last opt-out back to its default on a saved pipeline would silently not
+      // persist. Sending the aligned array always lets `update` overwrite; the backend normalizes
+      // an all-default array away (stores nothing), so this is a no-op on create / all-default.
+      stepOptions: ctx.draftStepOptions.value.map((o) => o ?? null),
+      // Only send labels when there are any.
+      ...(ctx.draftLabels.value.length ? { labels: [...ctx.draftLabels.value] } : {}),
+      // Only send purpose when the pipeline is classified (null ⇒ leave unclassified). Like the
+      // legacy per-step arrays, an omitted `purpose` on update reads as "keep existing"; clearing
+      // a classification back to unclassified is not a supported edit (every built-in ships one).
+      ...(ctx.draftPurpose.value ? { purpose: ctx.draftPurpose.value } : {}),
+    }
+  }
+
+  /** Persist the draft: update the pipeline being edited, else create a new one. */
+  async function saveDraft(): Promise<Pipeline | null> {
+    if (ctx.draft.value.length === 0) return null
+    const wsId = useWorkspaceStore().requireId()
+    const payload = draftPayload()
+    if (editingId.value) {
+      const updated = await api.updatePipeline(wsId, editingId.value, payload)
+      upsertPipeline(updated)
+      clearDraft()
+      return updated
+    }
+    const pipeline = await api.createPipeline(wsId, payload)
+    upsertPipeline(pipeline)
+    clearDraft()
+    return pipeline
+  }
+
+  /** Clone any pipeline (built-in or custom) into an editable copy, ready to edit. */
+  async function clonePipeline(id: string): Promise<Pipeline> {
+    const clone = await api.clonePipeline(useWorkspaceStore().requireId(), id)
+    upsertPipeline(clone)
+    loadForEdit(clone)
+    return clone
+  }
+
+  async function removePipeline(id: string) {
+    await api.removePipeline(useWorkspaceStore().requireId(), id)
+    dropPipeline(id)
+    if (editingId.value === id) clearDraft()
+  }
+
+  /**
+   * Reseed a built-in pipeline from the backend's current catalog definition: restores its
+   * canonical structure + version (adopting an update, or repairing a drifted/invalid copy)
+   * while preserving its labels/archive state. Replaces the pipeline in the cache.
+   */
+  async function reseed(id: string): Promise<Pipeline> {
+    const updated = await api.reseedPipeline(useWorkspaceStore().requireId(), id)
+    upsertPipeline(updated)
+    if (editingId.value === id) clearDraft()
+    return updated
+  }
+
+  /** Set a pipeline's organizational metadata (labels / archive). Works on built-ins too. */
+  async function organize(id: string, body: { labels?: string[]; archived?: boolean }) {
+    const updated = await api.organizePipeline(useWorkspaceStore().requireId(), id, body)
+    upsertPipeline(updated)
+    return updated
+  }
+
+  const archive = (id: string) => organize(id, { archived: true })
+  const unarchive = (id: string) => organize(id, { archived: false })
+  const setLabels = (id: string, labels: string[]) => organize(id, { labels })
+
+  return {
+    saveDraft,
+    clonePipeline,
+    removePipeline,
+    reseed,
+    organize,
+    archive,
+    unarchive,
+    setLabels,
+  }
+}