@cat-factory/orchestration 0.6.0

package/dist/modules/review/IterativeReviewService.d.ts.map

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

package/dist/modules/review/IterativeReviewService.js

@@ -0,0 +1,327 @@
+import { generateText } from 'ai';
+import { assertFound, DEFAULT_MAX_REQUIREMENT_ITERATIONS, inlineModelRef, ValidationError, } from '@cat-factory/kernel';
+import { catFactoryObservability } from '@cat-factory/agents';
+import { coerceReviewItems, disposeReview, extractJson, } from '../requirements/requirements.logic.js';
+/** Output budget for the rework generation (a full standard-format document). */
+const REWORK_MAX_OUTPUT_TOKENS = 16_000;
+/** An item still needs a human while `open`. */
+const isOpen = (i) => i.status === 'open';
+/** Map a reviewer pass's disposition to the review status it parks (or advances) at. */
+function statusForDisposition(d) {
+    if (d === 'auto-pass')
+        return 'incorporated';
+    if (d === 'exceeded')
+        return 'exceeded';
+    return 'ready';
+}
+/**
+ * Stateless, synchronous iterative reviewer (no container, no durable driver). The LLM is
+ * reached through the provider-agnostic {@link ModelProvider} port — the same one the
+ * document planner uses — so this service never imports a provider SDK or an API key. The
+ * model is resolved exactly like an agent step: a model pinned on the block wins, else the
+ * workspace's per-kind default, else the routing default (which falls back to Cloudflare
+ * Workers AI when no direct provider key is set). Reads of an existing review work
+ * regardless.
+ *
+ * @typeParam TReview      The persisted review type (adds a kind-specific document field).
+ * @typeParam TContext     The reviewer's per-kind context (the subject under review).
+ * @typeParam TContextInput Extra per-call inputs threaded into context gathering (e.g. an
+ *                          investigation report for clarity); `{}` when a kind needs none.
+ */
+export class IterativeReviewService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    // ---- public surface (shared by every kind) ------------------------------
+    /** Whether the LLM-backed review path is available. */
+    get enabled() {
+        return (!!this.deps.modelProviderResolver || !!this.deps.modelProvider) && !!this.deps.modelRef;
+    }
+    /** The current review for a block, or null if none has been run. */
+    async getForBlock(workspaceId, blockId) {
+        return this.repository.getByBlock(workspaceId, blockId);
+    }
+    /**
+     * Run a fresh review of a block (iteration 1). Replaces any prior review for the block
+     * (answers from a stale run don't carry over). The returned review's `status` encodes the
+     * disposition: `incorporated` (auto-pass — advance), `ready` (findings to answer) or
+     * `exceeded` (findings but the iteration budget is already 1).
+     */
+    async review(workspaceId, blockId, opts = {}) {
+        const block = assertFound(await this.deps.blockRepository.get(workspaceId, blockId), 'Block', blockId);
+        const maxIterations = opts.maxIterations ?? DEFAULT_MAX_REQUIREMENT_ITERATIONS;
+        const concernThreshold = opts.concernThreshold ?? 'none';
+        const context = await this.gatherContext(workspaceId, block, opts);
+        const { ref, items } = await this.runReviewer(workspaceId, block, context);
+        const now = this.deps.clock.now();
+        const disposition = disposeReview(items, { iteration: 1, maxIterations, concernThreshold });
+        const review = this.newReview({
+            id: this.deps.idGenerator.next(this.reviewIdPrefix),
+            blockId,
+            status: statusForDisposition(disposition),
+            items,
+            model: `${ref.provider}:${ref.model}`,
+            iteration: 1,
+            maxIterations,
+            createdAt: now,
+            updatedAt: now,
+        });
+        await this.repository.deleteByBlock(workspaceId, blockId);
+        await this.repository.upsert(workspaceId, review);
+        if (disposition !== 'auto-pass')
+            await this.notifyFindings(workspaceId, block, items.length);
+        return review;
+    }
+    /**
+     * Re-review the block against its current incorporated document (one more reviewer pass;
+     * `iteration` increments). Keeps the review id + the document; replaces the items with the
+     * fresh findings and re-encodes the disposition into `status`. Called after an
+     * incorporation so the loop can converge (`incorporated`), continue (`ready`) or stop for a
+     * human (`exceeded`).
+     */
+    async reReview(workspaceId, reviewId, opts = {}) {
+        const review = await this.load(workspaceId, reviewId);
+        const block = assertFound(await this.deps.blockRepository.get(workspaceId, review.blockId), 'Block', review.blockId);
+        const concernThreshold = opts.concernThreshold ?? 'none';
+        const context = await this.gatherContext(workspaceId, block, {});
+        const doc = this.readDoc(review);
+        if (doc)
+            this.applyIncorporatedDoc(context, doc);
+        const { ref, items } = await this.runReviewer(workspaceId, block, context);
+        const now = this.deps.clock.now();
+        const iteration = (review.iteration ?? 1) + 1;
+        const maxIterations = review.maxIterations ?? DEFAULT_MAX_REQUIREMENT_ITERATIONS;
+        const disposition = disposeReview(items, { iteration, maxIterations, concernThreshold });
+        const updated = {
+            ...review,
+            status: statusForDisposition(disposition),
+            items,
+            model: `${ref.provider}:${ref.model}`,
+            iteration,
+            maxIterations,
+            updatedAt: now,
+        };
+        await this.repository.upsert(workspaceId, updated);
+        if (disposition !== 'auto-pass')
+            await this.notifyFindings(workspaceId, block, items.length);
+        return updated;
+    }
+    /** Record a human's answer to one item (and flip it to `answered`). */
+    async replyToItem(workspaceId, reviewId, itemId, reply) {
+        return this.mutateItem(workspaceId, reviewId, itemId, (item, now) => {
+            item.reply = reply;
+            if (item.status === 'open')
+                item.status = 'answered';
+            item.updatedAt = now;
+        });
+    }
+    /** Set an item's status (resolve / dismiss / reopen). */
+    async setItemStatus(workspaceId, reviewId, itemId, status) {
+        return this.mutateItem(workspaceId, reviewId, itemId, (item, now) => {
+            item.status = status;
+            item.updatedAt = now;
+        });
+    }
+    /**
+     * Incorporate the human's answers (and dismissals) into one self-contained, standard-format
+     * document. Requires every finding to be answered or dismissed (no `open` items). The
+     * optional `feedback` is the human's "do it differently" direction when redoing a merge they
+     * were unhappy with, folded into the prompt alongside the prior document. Stores the document
+     * on the review and parks it `merged` for the human to re-review or redo.
+     */
+    async incorporate(workspaceId, reviewId, opts = {}) {
+        const review = await this.load(workspaceId, reviewId);
+        const block = assertFound(await this.deps.blockRepository.get(workspaceId, review.blockId), 'Block', review.blockId);
+        const open = review.items.filter(isOpen);
+        if (open.length > 0) {
+            throw new ValidationError(`Answer or dismiss all ${open.length} remaining item(s) before incorporating`);
+        }
+        const { modelProvider, ref } = await this.resolveModel(workspaceId, block);
+        const context = await this.gatherContext(workspaceId, block, opts);
+        // A redo carries the prior document forward (so the rework refines it, not the raw
+        // description) plus the human's freeform correction.
+        const prior = this.readDoc(review);
+        if (prior)
+            this.applyIncorporatedDoc(context, prior);
+        if (opts.feedback?.trim())
+            this.applyFeedback(context, opts.feedback.trim());
+        let revised;
+        let finishReason;
+        try {
+            const model = modelProvider.resolve(ref);
+            const result = await generateText({
+                model,
+                system: this.reworkSystemPrompt,
+                prompt: this.buildReworkPrompt(context, review.items),
+                temperature: 0.2,
+                // The reworked doc is a full standard-format document that becomes the SOLE source of
+                // truth fed to every downstream agent step; a generous budget keeps a real spec from
+                // being cut off mid-document.
+                maxOutputTokens: REWORK_MAX_OUTPUT_TOKENS,
+                providerOptions: catFactoryObservability({ agentKind: this.reworkAgentKind, workspaceId }),
+            });
+            revised = result.text.trim();
+            finishReason = result.finishReason;
+        }
+        catch (e) {
+            throw new ValidationError(this.reviewerFailed(ref, e));
+        }
+        if (!revised) {
+            throw new ValidationError(`The reviewer produced no ${this.revisedNoun}`);
+        }
+        // A length-truncated document would become a silently-incomplete spec that every
+        // downstream agent then treats as authoritative. Reject it loudly instead.
+        if (finishReason === 'length') {
+            throw new ValidationError(this.truncationMessage);
+        }
+        const now = this.deps.clock.now();
+        // `merged`: the document is produced and awaits the human's re-review / redo. It is NOT
+        // yet the final accepted document (that is `incorporated`, set on converge).
+        const updated = { ...this.withDoc(review, revised), status: 'merged', updatedAt: now };
+        await this.repository.upsert(workspaceId, updated);
+        return { review: updated };
+    }
+    /**
+     * Mark the review settled (`incorporated`) — the phase is done and the last incorporated
+     * document (if any) becomes what downstream agents consume.
+     */
+    async markIncorporated(workspaceId, reviewId) {
+        return this.patchReview(workspaceId, reviewId, (review) => ({
+            ...review,
+            status: 'incorporated',
+        }));
+    }
+    /** Grant one more reviewer pass after the cap was hit, reopening the loop (`ready`). */
+    async grantExtraRound(workspaceId, reviewId) {
+        return this.patchReview(workspaceId, reviewId, (review) => ({
+            ...review,
+            status: 'ready',
+            maxIterations: (review.maxIterations ?? DEFAULT_MAX_REQUIREMENT_ITERATIONS) + 1,
+        }));
+    }
+    /** Flag a review as `incorporating` (the durable driver is about to fold + re-review). */
+    async markIncorporating(workspaceId, reviewId) {
+        return this.patchReview(workspaceId, reviewId, (review) => ({
+            ...review,
+            status: 'incorporating',
+        }));
+    }
+    /** Flag a review as `reviewing` (the second async stage — re-reviewing the folded document). */
+    async markReReviewing(workspaceId, reviewId) {
+        return this.patchReview(workspaceId, reviewId, (review) => ({ ...review, status: 'reviewing' }));
+    }
+    // ---- internals ----------------------------------------------------------
+    /** The model provider for a workspace's scope (per-scope DB pool, else the static one). */
+    async providerFor(workspaceId) {
+        if (this.deps.modelProviderResolver) {
+            return this.deps.modelProviderResolver.forScope({ workspaceId });
+        }
+        return this.deps.modelProvider;
+    }
+    /**
+     * The model to run for a block, with the same precedence as a pipeline step: the block's
+     * pinned selection wins, else the workspace's per-kind default, else the routing default.
+     * A pinned subscription model (Claude Code / Codex) is degraded to the routing default
+     * because the reviewer is an INLINE LLM call with no provider key for the container harness
+     * — the same seam the inline agent executor uses, so the two can't drift.
+     */
+    async modelFor(workspaceId, block) {
+        const fallback = this.deps.modelRef;
+        const resolve = (ref) => inlineModelRef(ref, fallback ?? ref);
+        const fromBlock = this.deps.resolveBlockModel?.(block.modelId);
+        if (fromBlock)
+            return resolve(fromBlock);
+        const defaultId = await this.deps.resolveWorkspaceModelDefault?.(workspaceId, this.reviewAgentKind);
+        const fromDefault = this.deps.resolveBlockModel?.(defaultId);
+        if (fromDefault)
+            return resolve(fromDefault);
+        return fallback;
+    }
+    /** Resolve the provider + ref, throwing the kind's "no model configured" error if unavailable. */
+    async resolveModel(workspaceId, block) {
+        const modelProvider = await this.providerFor(workspaceId);
+        const ref = await this.modelFor(workspaceId, block);
+        if (!modelProvider || !ref) {
+            throw new ValidationError(`No model is configured for the ${this.reviewerLabel}`);
+        }
+        return { modelProvider, ref };
+    }
+    reviewerFailed(ref, e) {
+        // Surface the real cause (binding missing, rate limit, provider error) rather than
+        // masking every failure behind one vague message.
+        return `The ${this.reviewerLabel} (${ref.provider}:${ref.model}) failed: ${e instanceof Error ? e.message : String(e)}`;
+    }
+    /** Run the reviewer LLM over the prepared context and coerce the JSON into review items. */
+    async runReviewer(workspaceId, block, context) {
+        const { modelProvider, ref } = await this.resolveModel(workspaceId, block);
+        let text;
+        try {
+            const model = modelProvider.resolve(ref);
+            const result = await generateText({
+                model,
+                system: this.reviewSystemPrompt,
+                prompt: this.buildReviewPrompt(context),
+                temperature: 0.2,
+                maxOutputTokens: 5000,
+                providerOptions: catFactoryObservability({ agentKind: this.reviewAgentKind, workspaceId }),
+            });
+            text = result.text;
+        }
+        catch (e) {
+            throw new ValidationError(this.reviewerFailed(ref, e));
+        }
+        const now = this.deps.clock.now();
+        const items = coerceReviewItems(extractJson(text), () => this.deps.idGenerator.next(this.itemIdPrefix), now);
+        return { ref, items };
+    }
+    /**
+     * Tell people to react to a review's findings. Best-effort and only when there ARE findings
+     * — a clean review pings no one. Never lets a notification failure break the awaited review.
+     */
+    async notifyFindings(workspaceId, block, findingCount) {
+        if (findingCount <= 0 || !this.deps.notificationService)
+            return;
+        try {
+            await this.deps.notificationService.raise(workspaceId, {
+                type: this.notificationType,
+                blockId: block.id,
+                executionId: null,
+                title: this.notificationTitle(block),
+                body: `${this.notificationSubject} raised ${findingCount} finding${findingCount === 1 ? '' : 's'} to react to.`,
+                // Direct it at the task's responsible product person when one is assigned, so the
+                // inbox can highlight it for them (it stays visible to the whole workspace).
+                payload: {
+                    findingCount,
+                    ...(block.responsibleProductUserId
+                        ? { targetUserId: block.responsibleProductUserId }
+                        : {}),
+                },
+            });
+        }
+        catch {
+            // Best-effort: the review is already persisted and returned to the caller.
+        }
+    }
+    async load(workspaceId, reviewId) {
+        return assertFound(await this.repository.get(workspaceId, reviewId), this.entityName, reviewId);
+    }
+    async patchReview(workspaceId, reviewId, patch) {
+        const review = await this.load(workspaceId, reviewId);
+        const updated = { ...patch(review), updatedAt: this.deps.clock.now() };
+        await this.repository.upsert(workspaceId, updated);
+        return updated;
+    }
+    async mutateItem(workspaceId, reviewId, itemId, mutate) {
+        const review = await this.load(workspaceId, reviewId);
+        const item = review.items.find((i) => i.id === itemId);
+        if (!item)
+            throw new ValidationError(`Review item '${itemId}' not found`);
+        const now = this.deps.clock.now();
+        mutate(item, now);
+        review.updatedAt = now;
+        await this.repository.upsert(workspaceId, review);
+        return review;
+    }
+}
+//# sourceMappingURL=IterativeReviewService.js.map

package/dist/modules/review/IterativeReviewService.js.map

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

package/dist/modules/serviceFragmentDefaults/ServiceFragmentDefaultsService.d.ts

@@ -0,0 +1,20 @@
+import type { ServiceFragmentDefaults, ServiceFragmentDefaultsRepository, SetServiceFragmentDefaultsInput, WorkspaceRepository } from '@cat-factory/kernel';
+export interface ServiceFragmentDefaultsServiceDependencies {
+    serviceFragmentDefaultsRepository: ServiceFragmentDefaultsRepository;
+    workspaceRepository: WorkspaceRepository;
+}
+/**
+ * Read/replace a workspace's default service-fragment selection — the best-practice
+ * prompt fragment ids new services inherit (seeded onto a frame's `serviceFragmentIds`
+ * at creation). Sending the full list replaces it wholesale.
+ */
+export declare class ServiceFragmentDefaultsService {
+    private readonly defaults;
+    private readonly workspaceRepository;
+    constructor(deps: ServiceFragmentDefaultsServiceDependencies);
+    /** The workspace's default fragment-id list (empty when none set). */
+    get(workspaceId: string): Promise<ServiceFragmentDefaults>;
+    /** Replace the workspace's default fragment-id list and return the stored result. */
+    set(workspaceId: string, input: SetServiceFragmentDefaultsInput): Promise<ServiceFragmentDefaults>;
+}
+//# sourceMappingURL=ServiceFragmentDefaultsService.d.ts.map

package/dist/modules/serviceFragmentDefaults/ServiceFragmentDefaultsService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceFragmentDefaultsService.d.ts","sourceRoot":"","sources":["../../../src/modules/serviceFragmentDefaults/ServiceFragmentDefaultsService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,iCAAiC,EACjC,+BAA+B,EAC/B,mBAAmB,EACpB,MAAM,qBAAqB,CAAA;AAG5B,MAAM,WAAW,0CAA0C;IACzD,iCAAiC,EAAE,iCAAiC,CAAA;IACpE,mBAAmB,EAAE,mBAAmB,CAAA;CACzC;AAED;;;;GAIG;AACH,qBAAa,8BAA8B;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAC5D,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAqB;IAEzD,YAAY,IAAI,EAAE,0CAA0C,EAG3D;IAED,sEAAsE;IAChE,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAG/D;IAED,qFAAqF;IAC/E,GAAG,CACP,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,+BAA+B,GACrC,OAAO,CAAC,uBAAuB,CAAC,CAIlC;CACF"}

package/dist/modules/serviceFragmentDefaults/ServiceFragmentDefaultsService.js

@@ -0,0 +1,26 @@
+import { requireWorkspace } from '@cat-factory/kernel';
+/**
+ * Read/replace a workspace's default service-fragment selection — the best-practice
+ * prompt fragment ids new services inherit (seeded onto a frame's `serviceFragmentIds`
+ * at creation). Sending the full list replaces it wholesale.
+ */
+export class ServiceFragmentDefaultsService {
+    defaults;
+    workspaceRepository;
+    constructor(deps) {
+        this.defaults = deps.serviceFragmentDefaultsRepository;
+        this.workspaceRepository = deps.workspaceRepository;
+    }
+    /** The workspace's default fragment-id list (empty when none set). */
+    async get(workspaceId) {
+        await requireWorkspace(this.workspaceRepository, workspaceId);
+        return { fragmentIds: await this.defaults.get(workspaceId) };
+    }
+    /** Replace the workspace's default fragment-id list and return the stored result. */
+    async set(workspaceId, input) {
+        await requireWorkspace(this.workspaceRepository, workspaceId);
+        await this.defaults.set(workspaceId, input.fragmentIds);
+        return { fragmentIds: input.fragmentIds };
+    }
+}
+//# sourceMappingURL=ServiceFragmentDefaultsService.js.map

package/dist/modules/serviceFragmentDefaults/ServiceFragmentDefaultsService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceFragmentDefaultsService.js","sourceRoot":"","sources":["../../../src/modules/serviceFragmentDefaults/ServiceFragmentDefaultsService.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAOtD;;;;GAIG;AACH,MAAM,OAAO,8BAA8B;IACxB,QAAQ,CAAmC;IAC3C,mBAAmB,CAAqB;IAEzD,YAAY,IAAgD;QAC1D,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,iCAAiC,CAAA;QACtD,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC,mBAAmB,CAAA;IACrD,CAAC;IAED,sEAAsE;IACtE,KAAK,CAAC,GAAG,CAAC,WAAmB;QAC3B,MAAM,gBAAgB,CAAC,IAAI,CAAC,mBAAmB,EAAE,WAAW,CAAC,CAAA;QAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAA;IAC9D,CAAC;IAED,qFAAqF;IACrF,KAAK,CAAC,GAAG,CACP,WAAmB,EACnB,KAAsC;QAEtC,MAAM,gBAAgB,CAAC,IAAI,CAAC,mBAAmB,EAAE,WAAW,CAAC,CAAA;QAC7D,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC,CAAA;QACvD,OAAO,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAA;IAC3C,CAAC;CACF"}

package/dist/modules/services/ServiceMountService.d.ts

@@ -0,0 +1,48 @@
+import type { MountServiceInput, Service, UpdateMountInput, WorkspaceMount } from '@cat-factory/kernel';
+import { type Clock, type IdGenerator, type ServiceRepository, type WorkspaceMountRepository, type WorkspaceRepository } from '@cat-factory/kernel';
+export interface ServiceMountServiceDependencies {
+    serviceRepository: ServiceRepository;
+    workspaceMountRepository: WorkspaceMountRepository;
+    workspaceRepository: WorkspaceRepository;
+    idGenerator: IdGenerator;
+    clock: Clock;
+}
+/**
+ * In-org service sharing: list an account's services (the catalog a workspace mounts
+ * from) and mount / unmount / re-layout them on a workspace board. A *mount* places a
+ * shared service onto a board with a per-workspace layout override; the service itself —
+ * its subtree, state and sync — stays canonical and account-owned. Unmounting only
+ * removes the service from that board; it never deletes the service.
+ *
+ * Sharing is strictly within one account: a workspace may only mount services owned by
+ * the same account it belongs to (enforced here), so a shared service can never leak
+ * across org boundaries.
+ */
+export declare class ServiceMountService {
+    private readonly serviceRepository;
+    private readonly workspaceMountRepository;
+    private readonly workspaceRepository;
+    private readonly idGenerator;
+    private readonly clock;
+    constructor(deps: ServiceMountServiceDependencies);
+    /**
+     * The org catalog: every service owned by an account (or the legacy/unscoped org when
+     * `accountId` is null) — the set a workspace in that org can mount from. Each service is
+     * annotated with `mountCount` (how many boards mount it) so the UI can badge a shared one.
+     */
+    listForAccount(accountId: string | null): Promise<Service[]>;
+    /** Services currently mounted onto a workspace board (with their layout overrides). */
+    listMounts(workspaceId: string): Promise<WorkspaceMount[]>;
+    /**
+     * Mount an existing org service onto a workspace board. The service must belong to
+     * the same account as the workspace (no cross-org sharing). Idempotent: re-mounting
+     * an already-mounted service just returns the existing mount.
+     */
+    mount(workspaceId: string, serviceId: string, input?: MountServiceInput): Promise<WorkspaceMount>;
+    /** Remove a service from a workspace board (does NOT delete the shared service). */
+    unmount(workspaceId: string, serviceId: string): Promise<void>;
+    /** Update a mount's per-workspace layout override (frame position/size). */
+    updateLayout(workspaceId: string, serviceId: string, patch: UpdateMountInput): Promise<WorkspaceMount>;
+    private defaultPosition;
+}
+//# sourceMappingURL=ServiceMountService.d.ts.map

package/dist/modules/services/ServiceMountService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceMountService.d.ts","sourceRoot":"","sources":["../../../src/modules/services/ServiceMountService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,OAAO,EACP,gBAAgB,EAChB,cAAc,EACf,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACL,KAAK,KAAK,EACV,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EAIzB,MAAM,qBAAqB,CAAA;AAE5B,MAAM,WAAW,+BAA+B;IAC9C,iBAAiB,EAAE,iBAAiB,CAAA;IACpC,wBAAwB,EAAE,wBAAwB,CAAA;IAClD,mBAAmB,EAAE,mBAAmB,CAAA;IACxC,WAAW,EAAE,WAAW,CAAA;IACxB,KAAK,EAAE,KAAK,CAAA;CACb;AAED;;;;;;;;;;GAUG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAmB;IACrD,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAA0B;IACnE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAqB;IACzD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAO;IAE7B,YAAY,IAAI,EAAE,+BAA+B,EAMhD;IAED;;;;OAIG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAKjE;IAED,uFAAuF;IACjF,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAG/D;IAED;;;;OAIG;IACG,KAAK,CACT,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,iBAAsB,GAC5B,OAAO,CAAC,cAAc,CAAC,CAoBzB;IAED,oFAAoF;IAC9E,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGnE;IAED,4EAA4E;IACtE,YAAY,CAChB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,cAAc,CAAC,CAazB;IAED,OAAO,CAAC,eAAe;CAQxB"}

package/dist/modules/services/ServiceMountService.js

@@ -0,0 +1,90 @@
+import { ValidationError, assertFound, requireWorkspace, } from '@cat-factory/kernel';
+/**
+ * In-org service sharing: list an account's services (the catalog a workspace mounts
+ * from) and mount / unmount / re-layout them on a workspace board. A *mount* places a
+ * shared service onto a board with a per-workspace layout override; the service itself —
+ * its subtree, state and sync — stays canonical and account-owned. Unmounting only
+ * removes the service from that board; it never deletes the service.
+ *
+ * Sharing is strictly within one account: a workspace may only mount services owned by
+ * the same account it belongs to (enforced here), so a shared service can never leak
+ * across org boundaries.
+ */
+export class ServiceMountService {
+    serviceRepository;
+    workspaceMountRepository;
+    workspaceRepository;
+    idGenerator;
+    clock;
+    constructor(deps) {
+        this.serviceRepository = deps.serviceRepository;
+        this.workspaceMountRepository = deps.workspaceMountRepository;
+        this.workspaceRepository = deps.workspaceRepository;
+        this.idGenerator = deps.idGenerator;
+        this.clock = deps.clock;
+    }
+    /**
+     * The org catalog: every service owned by an account (or the legacy/unscoped org when
+     * `accountId` is null) — the set a workspace in that org can mount from. Each service is
+     * annotated with `mountCount` (how many boards mount it) so the UI can badge a shared one.
+     */
+    async listForAccount(accountId) {
+        const services = await this.serviceRepository.listByAccount(accountId);
+        // One grouped count for the whole catalog (not an N+1 listByService per service).
+        const counts = await this.workspaceMountRepository.countByServiceIds(services.map((s) => s.id));
+        return services.map((service) => ({ ...service, mountCount: counts[service.id] ?? 0 }));
+    }
+    /** Services currently mounted onto a workspace board (with their layout overrides). */
+    async listMounts(workspaceId) {
+        await requireWorkspace(this.workspaceRepository, workspaceId);
+        return this.workspaceMountRepository.listByWorkspace(workspaceId);
+    }
+    /**
+     * Mount an existing org service onto a workspace board. The service must belong to
+     * the same account as the workspace (no cross-org sharing). Idempotent: re-mounting
+     * an already-mounted service just returns the existing mount.
+     */
+    async mount(workspaceId, serviceId, input = {}) {
+        await requireWorkspace(this.workspaceRepository, workspaceId);
+        const service = assertFound(await this.serviceRepository.get(serviceId), 'Service', serviceId);
+        const account = await this.workspaceRepository.accountOf(workspaceId);
+        // Both account-scoped and both the same account; the legacy/unscoped (NULL) path
+        // only ever sees its own services, which also share the NULL account.
+        if ((account ?? null) !== (service.accountId ?? null)) {
+            throw new ValidationError('A service can only be mounted within its own organization');
+        }
+        const existing = await this.workspaceMountRepository.get(workspaceId, serviceId);
+        if (existing)
+            return existing;
+        const mount = {
+            workspaceId,
+            serviceId,
+            position: input.position ?? this.defaultPosition(await this.listMounts(workspaceId)),
+            size: null,
+            createdAt: this.clock.now(),
+        };
+        await this.workspaceMountRepository.upsert(mount);
+        return mount;
+    }
+    /** Remove a service from a workspace board (does NOT delete the shared service). */
+    async unmount(workspaceId, serviceId) {
+        await requireWorkspace(this.workspaceRepository, workspaceId);
+        await this.workspaceMountRepository.remove(workspaceId, serviceId);
+    }
+    /** Update a mount's per-workspace layout override (frame position/size). */
+    async updateLayout(workspaceId, serviceId, patch) {
+        await requireWorkspace(this.workspaceRepository, workspaceId);
+        assertFound(await this.workspaceMountRepository.get(workspaceId, serviceId), 'WorkspaceMount', serviceId);
+        await this.workspaceMountRepository.update(workspaceId, serviceId, patch);
+        return assertFound(await this.workspaceMountRepository.get(workspaceId, serviceId), 'WorkspaceMount', serviceId);
+    }
+    defaultPosition(existing) {
+        // Lay new mounts out on a 5-wide grid so they don't pile onto the same point: the column
+        // cycles every 5 (x), the row advances every 5 (y). (The old `(n % 5)` on both axes put
+        // every 5th mount back at the origin and kept them all on the diagonal.)
+        const n = existing.length;
+        const columns = 5;
+        return { x: 80 + (n % columns) * 48, y: 80 + Math.floor(n / columns) * 48 };
+    }
+}
+//# sourceMappingURL=ServiceMountService.js.map

package/dist/modules/services/ServiceMountService.js.map

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

package/dist/modules/settings/WorkspaceSettingsService.d.ts

@@ -0,0 +1,22 @@
+import type { UpdateWorkspaceSettingsInput, WorkspaceRepository, WorkspaceSettings, WorkspaceSettingsRepository } from '@cat-factory/kernel';
+export interface WorkspaceSettingsServiceDependencies {
+    workspaceSettingsRepository: WorkspaceSettingsRepository;
+    workspaceRepository: WorkspaceRepository;
+}
+/**
+ * Get/update a workspace's runtime settings (the human-wait escalation threshold +
+ * the per-service running-task limit policy). {@link get} lazily falls back to
+ * {@link DEFAULT_WORKSPACE_SETTINGS} when no row has been persisted yet, so callers
+ * always see a complete settings object. {@link update} patches the supplied fields
+ * and keeps the limit fields internally consistent with the chosen mode.
+ */
+export declare class WorkspaceSettingsService {
+    private readonly settings;
+    private readonly workspaceRepository;
+    constructor(deps: WorkspaceSettingsServiceDependencies);
+    /** A workspace's settings, falling back to the built-in defaults when none are stored. */
+    get(workspaceId: string): Promise<WorkspaceSettings>;
+    /** Patch a workspace's settings, persisting the merged result. */
+    update(workspaceId: string, patch: UpdateWorkspaceSettingsInput): Promise<WorkspaceSettings>;
+}
+//# sourceMappingURL=WorkspaceSettingsService.d.ts.map

package/dist/modules/settings/WorkspaceSettingsService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceSettingsService.d.ts","sourceRoot":"","sources":["../../../src/modules/settings/WorkspaceSettingsService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,4BAA4B,EAC5B,mBAAmB,EACnB,iBAAiB,EACjB,2BAA2B,EAC5B,MAAM,qBAAqB,CAAA;AAG5B,MAAM,WAAW,oCAAoC;IACnD,2BAA2B,EAAE,2BAA2B,CAAA;IACxD,mBAAmB,EAAE,mBAAmB,CAAA;CACzC;AAED;;;;;;GAMG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAqB;IAEzD,YAAY,IAAI,EAAE,oCAAoC,EAGrD;IAED,0FAA0F;IACpF,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAEzD;IAED,kEAAkE;IAC5D,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,iBAAiB,CAAC,CAyB5B;CACF"}