@cat-factory/orchestration 0.6.0

package/dist/modules/pipelines/PipelineService.js

@@ -0,0 +1,226 @@
+import { assertFound, ValidationError } from '@cat-factory/kernel';
+import { requireWorkspace } from '@cat-factory/kernel';
+import { validatePipelineShape } from './pipelineShape.js';
+/**
+ * The post-release-health gate watches a released PR's observability signals, so it is
+ * meaningless (and rejected) on a workspace with no observability integration wired. It
+ * is NOT part of any default pipeline — a user adds it deliberately, and only then.
+ */
+const OBSERVABILITY_GATED_KIND = 'post-release-health';
+/** Saved, reusable pipelines (the pipeline palette). */
+export class PipelineService {
+    workspaceRepository;
+    pipelineRepository;
+    idGenerator;
+    datadogConnectionRepository;
+    constructor({ workspaceRepository, pipelineRepository, idGenerator, datadogConnectionRepository, }) {
+        this.workspaceRepository = workspaceRepository;
+        this.pipelineRepository = pipelineRepository;
+        this.idGenerator = idGenerator;
+        this.datadogConnectionRepository = datadogConnectionRepository;
+    }
+    /**
+     * The post-release-health gate is only meaningful with an observability integration, so
+     * reject a chain that includes an ENABLED post-release-health step unless the workspace
+     * has one wired. Validated only when the chain/enable mask is being authored (create, or
+     * an update that changes them) so an unrelated edit to an existing pipeline never trips.
+     */
+    async assertObservabilityGatedStepAllowed(workspaceId, agentKinds, enabled) {
+        const present = agentKinds.some((kind, i) => kind === OBSERVABILITY_GATED_KIND && enabled?.[i] !== false);
+        if (!present)
+            return;
+        const connection = await this.datadogConnectionRepository?.get(workspaceId);
+        if (!connection) {
+            throw new ValidationError(`The '${OBSERVABILITY_GATED_KIND}' step needs an observability integration. Connect Datadog for this workspace first.`);
+        }
+    }
+    requireWorkspace(workspaceId) {
+        return requireWorkspace(this.workspaceRepository, workspaceId);
+    }
+    async list(workspaceId) {
+        await this.requireWorkspace(workspaceId);
+        return this.pipelineRepository.listByWorkspace(workspaceId);
+    }
+    async create(workspaceId, input) {
+        await this.requireWorkspace(workspaceId);
+        assertSomeEnabled(input.agentKinds, input.enabled);
+        validatePipelineShape({
+            agentKinds: input.agentKinds,
+            enabled: input.enabled,
+            gating: input.gating,
+        });
+        await this.assertObservabilityGatedStepAllowed(workspaceId, input.agentKinds, input.enabled);
+        const pipeline = {
+            id: this.idGenerator.next('pl'),
+            name: input.name.trim() || 'Untitled pipeline',
+            agentKinds: [...input.agentKinds],
+            ...alignedGates(input.agentKinds, input.gates),
+            ...alignedThresholds(input.agentKinds, input.thresholds),
+            ...alignedEnabled(input.agentKinds, input.enabled),
+            ...alignedConsensus(input.agentKinds, input.consensus),
+            ...alignedGating(input.agentKinds, input.gating),
+            ...normalizedLabels(input.labels),
+        };
+        await this.pipelineRepository.insert(workspaceId, pipeline);
+        return pipeline;
+    }
+    /**
+     * Clone any pipeline (built-in or custom) into a new, editable copy. The copy keeps
+     * the source's steps / gates / thresholds / enable flags but is never `builtin`, so
+     * it can be edited — this is how a built-in template is "made editable".
+     */
+    async clone(workspaceId, sourceId, input) {
+        await this.requireWorkspace(workspaceId);
+        const source = assertFound(await this.pipelineRepository.get(workspaceId, sourceId), 'Pipeline', sourceId);
+        // Validate the source's shape so a clone is rejected at clone time, not deferred to run
+        // start — the same guarantee `create`/`update` give (a built-in can't ship invalid, but
+        // a custom source mutated out of band could).
+        validatePipelineShape({
+            agentKinds: source.agentKinds,
+            enabled: source.enabled,
+            gating: source.gating,
+        });
+        const pipeline = {
+            id: this.idGenerator.next('pl'),
+            name: input.name?.trim() || `${source.name} (copy)`,
+            agentKinds: [...source.agentKinds],
+            ...(source.gates ? { gates: [...source.gates] } : {}),
+            ...(source.thresholds ? { thresholds: [...source.thresholds] } : {}),
+            ...(source.enabled ? { enabled: [...source.enabled] } : {}),
+            ...(source.consensus ? { consensus: [...source.consensus] } : {}),
+            ...(source.gating ? { gating: [...source.gating] } : {}),
+            ...(source.labels ? { labels: [...source.labels] } : {}),
+            // A clone is a fresh, active, editable copy — never `builtin`, never `archived`.
+        };
+        await this.pipelineRepository.insert(workspaceId, pipeline);
+        return pipeline;
+    }
+    /**
+     * Edit a custom pipeline in place. Only the supplied fields change; passing
+     * `agentKinds` replaces the whole chain and re-aligns the parallel arrays. Built-in
+     * catalog templates are read-only and reject this — clone them first.
+     */
+    async update(workspaceId, id, input) {
+        await this.requireWorkspace(workspaceId);
+        const existing = assertFound(await this.pipelineRepository.get(workspaceId, id), 'Pipeline', id);
+        if (existing.builtin) {
+            throw new ValidationError('Built-in pipelines are read-only. Clone it to make an editable copy.');
+        }
+        const agentKinds = input.agentKinds ?? existing.agentKinds;
+        const gates = input.gates ?? existing.gates;
+        const thresholds = input.thresholds ?? existing.thresholds;
+        const enabled = input.enabled ?? existing.enabled;
+        const consensus = input.consensus ?? existing.consensus;
+        const gating = input.gating ?? existing.gating;
+        const labels = input.labels ?? existing.labels;
+        assertSomeEnabled(agentKinds, enabled);
+        // Re-validate the shape against the EFFECTIVE (enabled) chain — disabling a producer
+        // while leaving its companion on would orphan the companion, and adding gating without
+        // an estimator is illegal — so validate whenever the chain, enable flags, OR gating
+        // change, not just on a chain replacement.
+        if (input.agentKinds || input.enabled || input.gating) {
+            validatePipelineShape({ agentKinds, enabled, gating });
+            await this.assertObservabilityGatedStepAllowed(workspaceId, agentKinds, enabled);
+        }
+        const pipeline = {
+            id: existing.id,
+            name: input.name?.trim() || existing.name,
+            agentKinds: [...agentKinds],
+            ...alignedGates(agentKinds, gates),
+            ...alignedThresholds(agentKinds, thresholds),
+            ...alignedEnabled(agentKinds, enabled),
+            ...alignedConsensus(agentKinds, consensus),
+            ...alignedGating(agentKinds, gating),
+            ...normalizedLabels(labels),
+            // `archived` is organization-only state, mutated via `organize` — preserved here.
+            ...(existing.archived ? { archived: true } : {}),
+        };
+        await this.pipelineRepository.update(workspaceId, pipeline);
+        return pipeline;
+    }
+    async remove(workspaceId, id) {
+        await this.requireWorkspace(workspaceId);
+        const existing = assertFound(await this.pipelineRepository.get(workspaceId, id), 'Pipeline', id);
+        // Built-in catalog templates are read-only — they can be cloned but never deleted
+        // (matching `update`), so the curated palette is always present. Clone to customise.
+        if (existing.builtin) {
+            throw new ValidationError('Built-in pipelines are read-only and cannot be deleted.');
+        }
+        await this.pipelineRepository.delete(workspaceId, id);
+    }
+    /**
+     * Set a pipeline's organizational metadata (labels and/or archive state). This is the
+     * ONLY mutation allowed on a BUILT-IN pipeline — it touches the library view, not the
+     * pipeline's structure, so a built-in can be tagged or archived while staying read-only
+     * for its steps. Only the supplied fields change.
+     */
+    async organize(workspaceId, id, input) {
+        await this.requireWorkspace(workspaceId);
+        const existing = assertFound(await this.pipelineRepository.get(workspaceId, id), 'Pipeline', id);
+        // Explicit-undefined check (not `??`): passing `labels: []` clears the labels, while
+        // omitting the field preserves the existing ones.
+        const labels = input.labels !== undefined ? cleanLabels(input.labels) : existing.labels;
+        const archived = input.archived !== undefined ? input.archived : existing.archived;
+        const pipeline = {
+            ...existing,
+            ...(labels && labels.length ? { labels } : { labels: undefined }),
+            ...(archived ? { archived: true } : { archived: undefined }),
+        };
+        await this.pipelineRepository.update(workspaceId, pipeline);
+        return pipeline;
+    }
+}
+// Keep gates aligned to agentKinds; only persist when at least one step is gated so an
+// all-false / absent array stays absent (a straight-through run).
+function alignedGates(agentKinds, gates) {
+    return gates?.some(Boolean) ? { gates: agentKinds.map((_, i) => gates[i] ?? false) } : {};
+}
+// Keep thresholds aligned to agentKinds; only persist when at least one step sets an
+// explicit value (else companions fall back to their default bar).
+function alignedThresholds(agentKinds, thresholds) {
+    return thresholds?.some((t) => t != null)
+        ? { thresholds: agentKinds.map((_, i) => thresholds[i] ?? null) }
+        : {};
+}
+// Keep enable flags aligned to agentKinds; only persist when at least one step is
+// explicitly disabled (the default is "every step runs", i.e. no array at all).
+function alignedEnabled(agentKinds, enabled) {
+    return enabled?.some((e) => e === false)
+        ? { enabled: agentKinds.map((_, i) => enabled[i] ?? true) }
+        : {};
+}
+// Keep consensus configs aligned to agentKinds; only persist when at least one step is
+// consensus-enabled (the default is no array at all → every step is a standard agent).
+function alignedConsensus(agentKinds, consensus) {
+    return consensus?.some((c) => c?.enabled)
+        ? { consensus: agentKinds.map((_, i) => consensus[i] ?? null) }
+        : {};
+}
+// Keep gating aligned to agentKinds; only persist when at least one step has gating enabled
+// (the default is no array at all → every step always runs).
+function alignedGating(agentKinds, gating) {
+    return gating?.some((g) => g?.enabled)
+        ? { gating: agentKinds.map((_, i) => gating[i] ?? null) }
+        : {};
+}
+// Trim, drop blanks, and dedupe labels; undefined when none remain.
+function cleanLabels(labels) {
+    if (!labels)
+        return undefined;
+    const cleaned = [...new Set(labels.map((l) => l.trim()).filter(Boolean))];
+    return cleaned.length ? cleaned : undefined;
+}
+// Only persist labels when at least one survives cleaning.
+function normalizedLabels(labels) {
+    const cleaned = cleanLabels(labels);
+    return cleaned ? { labels: cleaned } : {};
+}
+/** A pipeline with every step disabled would have nothing to run. */
+function assertSomeEnabled(agentKinds, enabled) {
+    if (!enabled)
+        return;
+    if (!agentKinds.some((_, i) => enabled[i] ?? true)) {
+        throw new ValidationError('A pipeline must keep at least one step enabled.');
+    }
+}
+//# sourceMappingURL=PipelineService.js.map

package/dist/modules/pipelines/PipelineService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PipelineService.js","sourceRoot":"","sources":["../../../src/modules/pipelines/PipelineService.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAOlE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAE1D;;;;GAIG;AACH,MAAM,wBAAwB,GAAG,qBAAqB,CAAA;AActD,wDAAwD;AACxD,MAAM,OAAO,eAAe;IACT,mBAAmB,CAAqB;IACxC,kBAAkB,CAAoB;IACtC,WAAW,CAAa;IACxB,2BAA2B,CAA8B;IAE1E,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACX,2BAA2B,GACC;QAC5B,IAAI,CAAC,mBAAmB,GAAG,mBAAmB,CAAA;QAC9C,IAAI,CAAC,kBAAkB,GAAG,kBAAkB,CAAA;QAC5C,IAAI,CAAC,WAAW,GAAG,WAAW,CAAA;QAC9B,IAAI,CAAC,2BAA2B,GAAG,2BAA2B,CAAA;IAChE,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,mCAAmC,CAC/C,WAAmB,EACnB,UAAoB,EACpB,OAA8B;QAE9B,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAC7B,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,wBAAwB,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CACzE,CAAA;QACD,IAAI,CAAC,OAAO;YAAE,OAAM;QACpB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,2BAA2B,EAAE,GAAG,CAAC,WAAW,CAAC,CAAA;QAC3E,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,eAAe,CACvB,QAAQ,wBAAwB,sFAAsF,CACvH,CAAA;QACH,CAAC;IACH,CAAC;IAEO,gBAAgB,CAAC,WAAmB;QAC1C,OAAO,gBAAgB,CAAC,IAAI,CAAC,mBAAmB,EAAE,WAAW,CAAC,CAAA;IAChE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,WAAmB;QAC5B,MAAM,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAA;QACxC,OAAO,IAAI,CAAC,kBAAkB,CAAC,eAAe,CAAC,WAAW,CAAC,CAAA;IAC7D,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,WAAmB,EAAE,KAA0B;QAC1D,MAAM,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAA;QACxC,iBAAiB,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;QAClD,qBAAqB,CAAC;YACpB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC,CAAA;QACF,MAAM,IAAI,CAAC,mCAAmC,CAAC,WAAW,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;QAC5F,MAAM,QAAQ,GAAa;YACzB,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;YAC/B,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,mBAAmB;YAC9C,UAAU,EAAE,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC;YACjC,GAAG,YAAY,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC;YAC9C,GAAG,iBAAiB,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC;YACxD,GAAG,cAAc,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC;YAClD,GAAG,gBAAgB,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC;YACtD,GAAG,aAAa,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC;YAChD,GAAG,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC;SAClC,CAAA;QACD,MAAM,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;QAC3D,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK,CAAC,WAAmB,EAAE,QAAgB,EAAE,KAAyB;QAC1E,MAAM,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAA;QACxC,MAAM,MAAM,GAAG,WAAW,CACxB,MAAM,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,EACxD,UAAU,EACV,QAAQ,CACT,CAAA;QACD,wFAAwF;QACxF,wFAAwF;QACxF,8CAA8C;QAC9C,qBAAqB,CAAC;YACpB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC,CAAA;QACF,MAAM,QAAQ,GAAa;YACzB,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;YAC/B,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC,IAAI,SAAS;YACnD,UAAU,EAAE,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC;YAClC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrD,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACpE,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3D,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,iFAAiF;SAClF,CAAA;QACD,MAAM,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;QAC3D,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,WAAmB,EAAE,EAAU,EAAE,KAA0B;QACtE,MAAM,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAA;QACxC,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,CAAC,CAAA;QAChG,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACrB,MAAM,IAAI,eAAe,CACvB,sEAAsE,CACvE,CAAA;QACH,CAAC;QACD,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,QAAQ,CAAC,UAAU,CAAA;QAC1D,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAA;QAC3C,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,QAAQ,CAAC,UAAU,CAAA;QAC1D,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAA;QACjD,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,QAAQ,CAAC,SAAS,CAAA;QACvD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAA;QAC9C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAA;QAC9C,iBAAiB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;QACtC,qFAAqF;QACrF,uFAAuF;QACvF,oFAAoF;QACpF,2CAA2C;QAC3C,IAAI,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACtD,qBAAqB,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;YACtD,MAAM,IAAI,CAAC,mCAAmC,CAAC,WAAW,EAAE,UAAU,EAAE,OAAO,CAAC,CAAA;QAClF,CAAC;QACD,MAAM,QAAQ,GAAa;YACzB,EAAE,EAAE,QAAQ,CAAC,EAAE;YACf,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,QAAQ,CAAC,IAAI;YACzC,UAAU,EAAE,CAAC,GAAG,UAAU,CAAC;YAC3B,GAAG,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC;YAClC,GAAG,iBAAiB,CAAC,UAAU,EAAE,UAAU,CAAC;YAC5C,GAAG,cAAc,CAAC,UAAU,EAAE,OAAO,CAAC;YACtC,GAAG,gBAAgB,CAAC,UAAU,EAAE,SAAS,CAAC;YAC1C,GAAG,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC;YACpC,GAAG,gBAAgB,CAAC,MAAM,CAAC;YAC3B,kFAAkF;YAClF,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjD,CAAA;QACD,MAAM,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;QAC3D,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,WAAmB,EAAE,EAAU;QAC1C,MAAM,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAA;QACxC,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,CAAC,CAAA;QAChG,kFAAkF;QAClF,qFAAqF;QACrF,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACrB,MAAM,IAAI,eAAe,CAAC,yDAAyD,CAAC,CAAA;QACtF,CAAC;QACD,MAAM,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,CAAA;IACvD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,WAAmB,EAAE,EAAU,EAAE,KAA4B;QAC1E,MAAM,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAA;QACxC,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,CAAC,CAAA;QAChG,qFAAqF;QACrF,kDAAkD;QAClD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAA;QACvF,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAA;QAClF,MAAM,QAAQ,GAAa;YACzB,GAAG,QAAQ;YACX,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;YACjE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;SAC7D,CAAA;QACD,MAAM,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;QAC3D,OAAO,QAAQ,CAAA;IACjB,CAAC;CACF;AAED,uFAAuF;AACvF,kEAAkE;AAClE,SAAS,YAAY,CAAC,UAAoB,EAAE,KAA4B;IACtE,OAAO,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;AAC3F,CAAC;AAED,qFAAqF;AACrF,mEAAmE;AACnE,SAAS,iBAAiB,CACxB,UAAoB,EACpB,UAAyC;IAEzC,OAAO,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC;QACvC,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,EAAE;QACjE,CAAC,CAAC,EAAE,CAAA;AACR,CAAC;AAED,kFAAkF;AAClF,gFAAgF;AAChF,SAAS,cAAc,CACrB,UAAoB,EACpB,OAA8B;IAE9B,OAAO,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC;QACtC,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,EAAE;QAC3D,CAAC,CAAC,EAAE,CAAA;AACR,CAAC;AAED,uFAAuF;AACvF,uFAAuF;AACvF,SAAS,gBAAgB,CACvB,UAAoB,EACpB,SAAqD;IAErD,OAAO,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC;QACvC,CAAC,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,EAAE;QAC/D,CAAC,CAAC,EAAE,CAAA;AACR,CAAC;AAED,4FAA4F;AAC5F,6DAA6D;AAC7D,SAAS,aAAa,CACpB,UAAoB,EACpB,MAAyC;IAEzC,OAAO,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC;QACpC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,EAAE;QACzD,CAAC,CAAC,EAAE,CAAA;AACR,CAAC;AAED,oEAAoE;AACpE,SAAS,WAAW,CAAC,MAA4B;IAC/C,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAA;IAC7B,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IACzE,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;AAC7C,CAAC;AAED,2DAA2D;AAC3D,SAAS,gBAAgB,CAAC,MAA4B;IACpD,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAA;IACnC,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;AAC3C,CAAC;AAED,qEAAqE;AACrE,SAAS,iBAAiB,CAAC,UAAoB,EAAE,OAA8B;IAC7E,IAAI,CAAC,OAAO;QAAE,OAAM;IACpB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,eAAe,CAAC,iDAAiD,CAAC,CAAA;IAC9E,CAAC;AACH,CAAC"}

package/dist/modules/pipelines/pipelineShape.d.ts

@@ -0,0 +1,53 @@
+import type { StepGating } from '@cat-factory/kernel';
+/**
+ * Structural validation shared by the pipeline builder (save) and the execution engine
+ * (run start), so a pipeline that is invalid is rejected at BOTH boundaries.
+ *
+ * A run is built from the ENABLED steps alone, executed consecutively, so both checks
+ * reason over the enabled subset:
+ *
+ *  - {@link assertValidCompanionPlacement}: a companion (reviewer / architect-companion /
+ *    spec-companion) must run IMMEDIATELY after an ENABLED step it can review. Companions are
+ *    dependent agents — they make no sense without their producer — so the builder surfaces
+ *    them as toggles attached to the producer (inserting them immediately after), and the
+ *    validation enforces exactly that adjacency: a companion's nearest preceding enabled step
+ *    must be one of its targets. (The engine still reviews the nearest preceding target, but
+ *    that target is now guaranteed to be the immediate predecessor.)
+ *  - {@link assertValidGating}: a step gated on the task estimate must be a companion (the
+ *    only kind it is safe to skip — skipping a producer would starve its downstream steps),
+ *    must set at least one axis threshold (or it would always skip), and needs a
+ *    `task-estimator` to have run before it (or the gate has nothing to consult).
+ */
+export interface PipelineShape {
+    agentKinds: string[];
+    enabled?: boolean[];
+    gating?: (StepGating | null)[];
+}
+export declare function validatePipelineShape(pipeline: PipelineShape): void;
+/**
+ * A companion step is only valid when the step IMMEDIATELY before it (over the enabled
+ * subset) produces output it is allowed to review (a step whose kind is in the companion's
+ * target allow-list). Validated over the enabled subset — that is exactly the chain the run
+ * executes — so it also rejects "disable the producer but leave its companion on" (which
+ * would leave the companion grading nothing at runtime) AND "slip another step between the
+ * producer and its companion". Companions are surfaced in the builder as toggles attached to
+ * their producer and run immediately after it, so adjacency is required.
+ */
+export declare function assertValidCompanionPlacement(agentKinds: string[], enabled?: boolean[]): void;
+/**
+ * Validate every ENABLED step that carries enabled estimate gating. A disabled gated step
+ * never runs, so it imposes no requirement; an enabled one must satisfy all three rules:
+ *
+ *  1. The gated step must be a COMPANION kind. Gating means "skip this step when the task is
+ *     light", and skipping is only safe for a dependent companion — skipping a producer
+ *     (coder / spec-writer / architect) would leave its downstream steps (tester, merger,
+ *     …) running against output that was never produced. (The consensus-gating sibling can
+ *     degrade to the standard agent; step-gating removes the step, so it is companion-only.)
+ *  2. It must set at least one axis threshold. With none, the axis loop in
+ *     `shouldRunGatedStep` never matches, so a step with an estimate would ALWAYS skip — the
+ *     opposite of the usual intent — making the toggle a silent footgun.
+ *  3. An enabled `task-estimator` must run earlier in the chain, or the gate has no estimate
+ *     to consult.
+ */
+export declare function assertValidGating(agentKinds: string[], enabled?: boolean[], gating?: (StepGating | null)[]): void;
+//# sourceMappingURL=pipelineShape.d.ts.map

package/dist/modules/pipelines/pipelineShape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipelineShape.d.ts","sourceRoot":"","sources":["../../../src/modules/pipelines/pipelineShape.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAGrD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,OAAO,CAAC,EAAE,OAAO,EAAE,CAAA;IACnB,MAAM,CAAC,EAAE,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,CAAA;CAC/B;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAGnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CAoB7F;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAAE,EACpB,OAAO,CAAC,EAAE,OAAO,EAAE,EACnB,MAAM,CAAC,EAAE,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,GAC7B,IAAI,CA0BN"}

package/dist/modules/pipelines/pipelineShape.js

@@ -0,0 +1,74 @@
+import { ValidationError } from '@cat-factory/kernel';
+import { companionTargets, isCompanionKind, TASK_ESTIMATOR_AGENT_KIND } from '@cat-factory/agents';
+export function validatePipelineShape(pipeline) {
+    assertValidCompanionPlacement(pipeline.agentKinds, pipeline.enabled);
+    assertValidGating(pipeline.agentKinds, pipeline.enabled, pipeline.gating);
+}
+/**
+ * A companion step is only valid when the step IMMEDIATELY before it (over the enabled
+ * subset) produces output it is allowed to review (a step whose kind is in the companion's
+ * target allow-list). Validated over the enabled subset — that is exactly the chain the run
+ * executes — so it also rejects "disable the producer but leave its companion on" (which
+ * would leave the companion grading nothing at runtime) AND "slip another step between the
+ * producer and its companion". Companions are surfaced in the builder as toggles attached to
+ * their producer and run immediately after it, so adjacency is required.
+ */
+export function assertValidCompanionPlacement(agentKinds, enabled) {
+    const isEnabled = (i) => enabled?.[i] !== false;
+    for (let i = 0; i < agentKinds.length; i++) {
+        const kind = agentKinds[i];
+        if (kind === undefined || !isCompanionKind(kind) || !isEnabled(i))
+            continue;
+        const targets = companionTargets(kind);
+        // The nearest preceding ENABLED step must be a producer this companion can review.
+        let predecessor;
+        for (let j = i - 1; j >= 0; j--) {
+            if (isEnabled(j)) {
+                predecessor = agentKinds[j];
+                break;
+            }
+        }
+        if (predecessor === undefined || !targets.includes(predecessor)) {
+            throw new ValidationError(`Companion '${kind}' must run immediately after an enabled step it can review (${targets.join(', ')}).`);
+        }
+    }
+}
+/**
+ * Validate every ENABLED step that carries enabled estimate gating. A disabled gated step
+ * never runs, so it imposes no requirement; an enabled one must satisfy all three rules:
+ *
+ *  1. The gated step must be a COMPANION kind. Gating means "skip this step when the task is
+ *     light", and skipping is only safe for a dependent companion — skipping a producer
+ *     (coder / spec-writer / architect) would leave its downstream steps (tester, merger,
+ *     …) running against output that was never produced. (The consensus-gating sibling can
+ *     degrade to the standard agent; step-gating removes the step, so it is companion-only.)
+ *  2. It must set at least one axis threshold. With none, the axis loop in
+ *     `shouldRunGatedStep` never matches, so a step with an estimate would ALWAYS skip — the
+ *     opposite of the usual intent — making the toggle a silent footgun.
+ *  3. An enabled `task-estimator` must run earlier in the chain, or the gate has no estimate
+ *     to consult.
+ */
+export function assertValidGating(agentKinds, enabled, gating) {
+    if (!gating)
+        return;
+    const isEnabled = (i) => enabled?.[i] !== false;
+    for (let i = 0; i < agentKinds.length; i++) {
+        const g = gating[i];
+        if (!g?.enabled || !isEnabled(i))
+            continue;
+        const kind = agentKinds[i];
+        if (kind === undefined || !isCompanionKind(kind)) {
+            throw new ValidationError(`Step '${kind}' cannot be estimate-gated — only companion steps (reviewer / architect-companion / spec-companion) may be skipped on the estimate.`);
+        }
+        if (g.minComplexity === undefined && g.minRisk === undefined && g.minImpact === undefined) {
+            throw new ValidationError(`Step '${kind}' is estimate-gated but sets no threshold — set at least one of complexity / risk / impact, or it would always be skipped.`);
+        }
+        const hasEstimator = agentKinds
+            .slice(0, i)
+            .some((k, j) => k === TASK_ESTIMATOR_AGENT_KIND && isEnabled(j));
+        if (!hasEstimator) {
+            throw new ValidationError(`Step '${kind}' is gated on the task estimate but no enabled '${TASK_ESTIMATOR_AGENT_KIND}' step runs before it. Add a task-estimator earlier in the pipeline.`);
+        }
+    }
+}
+//# sourceMappingURL=pipelineShape.js.map

package/dist/modules/pipelines/pipelineShape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipelineShape.js","sourceRoot":"","sources":["../../../src/modules/pipelines/pipelineShape.ts"],"names":[],"mappings":"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"}

package/dist/modules/recurring/RecurringPipelineService.d.ts

@@ -0,0 +1,76 @@
+import type { Clock, CreateScheduleInput, ExecutionRepository, IdGenerator, PipelineRepository, PipelineSchedule, PipelineScheduleRepository, ScheduleRun, ServiceRepository, UpdateScheduleInput, WorkspaceMountRepository, WorkspaceRepository } from '@cat-factory/kernel';
+import type { BlockRepository } from '@cat-factory/kernel';
+import type { ExecutionService } from '../execution/ExecutionService.js';
+export interface RecurringPipelineServiceDependencies {
+    pipelineScheduleRepository: PipelineScheduleRepository;
+    workspaceRepository: WorkspaceRepository;
+    pipelineRepository: PipelineRepository;
+    blockRepository: BlockRepository;
+    executionRepository: ExecutionRepository;
+    executionService: ExecutionService;
+    idGenerator: IdGenerator;
+    clock: Clock;
+    /**
+     * In-org shared services. When wired, a new schedule (and its reused on-board block) is
+     * stamped with the frame's service, and {@link RecurringPipelineService.list} returns the
+     * schedules of every service the workspace mounts — so a shared service's recurring
+     * pipelines appear on every board that mounts it (and still fire once per org).
+     */
+    serviceRepository?: ServiceRepository;
+    workspaceMountRepository?: WorkspaceMountRepository;
+}
+/**
+ * Manages a workspace's recurring pipelines. Each schedule owns one reused
+ * on-board block (a task leaf inside the chosen service frame); the cron sweeper
+ * calls {@link runDue} to fire every due schedule by starting its pipeline against
+ * that block (skipping any whose block already has an active run), recording each
+ * fire in the run-history table the inspector reads.
+ */
+export declare class RecurringPipelineService {
+    private readonly schedules;
+    private readonly workspaceRepository;
+    private readonly pipelineRepository;
+    private readonly blockRepository;
+    private readonly executionRepository;
+    private readonly executionService;
+    private readonly idGenerator;
+    private readonly clock;
+    private readonly serviceRepository?;
+    private readonly workspaceMountRepository?;
+    constructor(deps: RecurringPipelineServiceDependencies);
+    private requireWorkspace;
+    list(workspaceId: string): Promise<PipelineSchedule[]>;
+    /**
+     * Create a recurring pipeline on a service frame. Materialises the reused on-board
+     * block (a task leaf inside the frame), computes the first `nextRunAt`, and
+     * persists the schedule.
+     */
+    create(workspaceId: string, input: CreateScheduleInput): Promise<PipelineSchedule>;
+    update(workspaceId: string, id: string, patch: UpdateScheduleInput): Promise<PipelineSchedule>;
+    /** Remove a schedule, its reused block, and its run history. */
+    remove(workspaceId: string, id: string): Promise<void>;
+    /** A schedule's run history (most recent first), with live status overlaid. */
+    listRuns(workspaceId: string, id: string): Promise<ScheduleRun[]>;
+    /** Fire a schedule immediately (ignoring its cadence), if its block is free. */
+    runNow(workspaceId: string, id: string): Promise<PipelineSchedule>;
+    /**
+     * Fire every due schedule across all workspaces. The cron/interval sweepers call
+     * this; it skips any schedule whose block already has an active run. Returns the
+     * number of runs started (for logging).
+     */
+    runDue(now: number): Promise<{
+        fired: number;
+        skipped: number;
+    }>;
+    /**
+     * Start a schedule's pipeline against its reused block. Finalises the prior run's
+     * history row (its execution is about to be replaced), records a new running row,
+     * and advances `lastRunAt`/`nextRunAt`. Returns false (without starting) when the
+     * block already has an active run.
+     */
+    private fire;
+    private advanceCadence;
+    /** Map an execution's state to a history-row status + short outcome. */
+    private deriveRunOutcome;
+}
+//# sourceMappingURL=RecurringPipelineService.d.ts.map

package/dist/modules/recurring/RecurringPipelineService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecurringPipelineService.d.ts","sourceRoot":"","sources":["../../../src/modules/recurring/RecurringPipelineService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,KAAK,EACL,mBAAmB,EAEnB,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,gBAAgB,EAChB,0BAA0B,EAC1B,WAAW,EAEX,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACpB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAE1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AAGxE,MAAM,WAAW,oCAAoC;IACnD,0BAA0B,EAAE,0BAA0B,CAAA;IACtD,mBAAmB,EAAE,mBAAmB,CAAA;IACxC,kBAAkB,EAAE,kBAAkB,CAAA;IACtC,eAAe,EAAE,eAAe,CAAA;IAChC,mBAAmB,EAAE,mBAAmB,CAAA;IACxC,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,WAAW,EAAE,WAAW,CAAA;IACxB,KAAK,EAAE,KAAK,CAAA;IACZ;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;IACrC,wBAAwB,CAAC,EAAE,wBAAwB,CAAA;CACpD;AAWD;;;;;;GAMG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;IACtD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAqB;IACzD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAoB;IACvD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiB;IACjD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAqB;IACzD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkB;IACnD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAO;IAC7B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAmB;IACtD,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAA0B;IAEpE,YAAY,IAAI,EAAE,oCAAoC,EAWrD;IAED,OAAO,CAAC,gBAAgB;IAIlB,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAsB3D;IAED;;;;OAIG;IACG,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA0DvF;IAEK,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CA2B3B;IAED,gEAAgE;IAC1D,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM3D;IAED,+EAA+E;IACzE,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAatE;IAED,gFAAgF;IAC1E,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAKvE;IAED;;;;OAIG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAUrE;IAED;;;;;OAKG;YACW,IAAI;YAiGJ,cAAc;IAY5B,wEAAwE;IACxE,OAAO,CAAC,gBAAgB;CAezB"}