@cat-factory/orchestration 0.238.0 → 0.240.0

package/dist/modules/execution/visual-confirm-design-references.js

@@ -0,0 +1,229 @@
+import { isDesignSource } from '@cat-factory/contracts';
+// ---------------------------------------------------------------------------
+// The visual-confirmation gate's DESIGN-ORIGIN reference half: the rendered frames an import
+// retained for the designs a task links, folded into the gate's gallery beside the images a
+// person uploaded by hand.
+//
+// Its own module rather than more methods on `VisualConfirmationController` because the fold is
+// pure and the interesting part: which frame wins a view, what a name collision across two
+// designs means, and which of five ways a design can contribute nothing the reviewer is looking
+// at. The controller keeps the one impure step (two reads) and hands the rest here.
+// ---------------------------------------------------------------------------
+/**
+ * How many design-rendered views one gallery may carry, across every design a task links.
+ *
+ * A per-document render cap already bounds each design (Figma rasterises the first frames of a
+ * file, not all of them), and this bounds their SUM: a task linking four designs would otherwise
+ * push a couple of captured screenshots off the bottom of a page of mocks nobody asked to review
+ * here. Whatever it excludes is COUNTED and stated, never quietly trimmed.
+ */
+export const MAX_DESIGN_REFERENCE_VIEWS = 12;
+/**
+ * Why a linked design contributed less than its whole set of frames, or null when it contributed
+ * everything it has.
+ *
+ * Reads the stored `renderStatus` AND what the artifact store actually holds, because the two can
+ * disagree in the one direction that matters: a row CLAIMING retention over an empty shelf (an
+ * account that re-pointed its blob backend, a reclaim that outran its re-import) would otherwise
+ * describe a gallery that is not there. `partial` is such a claim just as `stored` is, and left to
+ * speak for itself it tells the reviewer "only part of its frames were retained" above nothing at
+ * all, which reads as a design that is merely short rather than one that is absent, and sends them
+ * looking for the frames that did survive.
+ *
+ * So the two claiming statuses are checked against what is held, and the three that already say
+ * nothing was kept (`failed` / `none` / `storage_unavailable`) stand as they are: each names a
+ * DIFFERENT cause of the same empty shelf, and collapsing them would throw the cause away.
+ */
+export function designGapReason(renderStatus, heldImages) {
+    switch (renderStatus) {
+        case 'stored':
+            return heldImages > 0 ? null : 'not_retained';
+        case 'partial':
+            return heldImages > 0 ? 'partial' : 'not_retained';
+        case 'failed':
+            return 'failed';
+        case 'none':
+            return 'none';
+        case 'storage_unavailable':
+            return 'storage_unavailable';
+        case null:
+            // No render outcome was ever recorded for this document. Two causes the gate cannot tell
+            // apart (a source that rasterises nothing, a document imported before renders were kept),
+            // and one answer covers both honestly; a re-import is what distinguishes them.
+            return heldImages > 0 ? null : 'not_retained';
+        default:
+            return exhaustiveRenderStatus(renderStatus);
+    }
+}
+/**
+ * The compile-time totality guard: a new {@link DocumentRenderStatus} member fails the build here
+ * rather than silently becoming "this design is complete".
+ */
+function exhaustiveRenderStatus(status) {
+    void status;
+    return 'not_retained';
+}
+/** The stable key both sides of the join use: a document's own source identity. */
+function documentKey(ref) {
+    return `${ref.source}::${ref.externalId}`;
+}
+/**
+ * A per-document display label that is UNIQUE within this fold, used to qualify a view name two
+ * designs both claim. Titles alone are not unique (two boards can import files named "Checkout
+ * flow"), so a shared title falls back to carrying the source id.
+ */
+function documentLabels(documents) {
+    const byTitle = new Map();
+    for (const document of documents) {
+        byTitle.set(document.title, (byTitle.get(document.title) ?? 0) + 1);
+    }
+    const labels = new Map();
+    for (const document of documents) {
+        const shared = (byTitle.get(document.title) ?? 0) > 1;
+        labels.set(documentKey(document), shared ? `${document.title} ${document.externalId}` : document.title);
+    }
+    return labels;
+}
+/**
+ * Share a bounded budget of gallery slots across the designs competing for it, one slot at a time
+ * in turn, and answer how many each may take.
+ *
+ * The budget is shared, so how it is SPLIT is a decision, and taking the first `cap` views in read
+ * order is the one shape that answers it worst: reads come back oldest-first, so the design linked
+ * longest ago fills the gallery and a design linked this morning contributes nothing, its absence
+ * indistinguishable to the reviewer from a design with no frames. Round-robin instead: every
+ * design is represented before any design gets a second slot, a design with fewer frames than its
+ * share leaves the rest to the others, and the split does not move when the links are re-ordered.
+ */
+function allocate(counts, cap) {
+    const taken = counts.map(() => 0);
+    let remaining = Math.max(0, cap);
+    for (let round = 0; remaining > 0; round += 1) {
+        let servedThisRound = false;
+        for (let i = 0; i < counts.length && remaining > 0; i += 1) {
+            if (round >= counts[i])
+                continue;
+            taken[i] += 1;
+            remaining -= 1;
+            servedThisRound = true;
+        }
+        // Nobody had a frame left at this depth, so nobody will at any greater one.
+        if (!servedThisRound)
+            break;
+    }
+    return taken;
+}
+/**
+ * Fold a task's design documents and their retained renders into the gate's reference set.
+ *
+ * Four rules, each of which the obvious shape gets wrong:
+ *
+ * A view name claimed by TWO designs is qualified with its design's label on BOTH sides, never
+ * just the second. This is the same rule slice 1 applied to a frame name repeated across pages
+ * within one file: leaving the first occurrence bare hands the plain name to whichever document
+ * happened to be read first, so re-ordering the links would silently re-point a reviewed view at
+ * a different screen. The cost is that neither qualified name matches a screenshot captured as
+ * plain "Checkout", which is correct: nothing knows which of two designs that capture is of.
+ *
+ * Within ONE design, the NEWEST render for a view wins. The artifact reads are ordered oldest
+ * first, so a later assignment overriding an earlier one is the rule, not an accident.
+ *
+ * The cap counts VIEWS, not artifacts, and is applied after the per-view reduction: capping the
+ * raw rows first would spend the budget on frames a later revision had already replaced. It is
+ * SHARED across the linked designs rather than consumed in read order (see {@link allocate}), and
+ * what it cuts is named per design, not just totalled.
+ *
+ * Emission stays in document order with each design's own frames contiguous: the allocation
+ * decides how many slots each design gets, never how the gallery reads.
+ */
+export function foldDesignReferences(documents, artifacts, cap = MAX_DESIGN_REFERENCE_VIEWS) {
+    // One entry per document IDENTITY, in first-linked order. A repeated link is one design: counted
+    // twice it would take two shares of the budget, state its gap twice, and make its own title look
+    // shared to the qualifier below, which would then qualify every one of its views against itself.
+    const known = new Map(documents.map((document) => [documentKey(document), document]));
+    const unique = [...known.values()];
+    const renders = artifacts.filter((record) => record.kind === 'reference' && record.document && known.has(documentKey(record.document)));
+    // Which documents claim each raw view name: the collision test the qualification below runs on.
+    const claimants = new Map();
+    for (const record of renders) {
+        const view = record.view;
+        if (!view)
+            continue;
+        const key = documentKey(record.document);
+        const held = claimants.get(view);
+        if (held)
+            held.add(key);
+        else
+            claimants.set(view, new Set([key]));
+    }
+    const labels = documentLabels(unique);
+    const byDocument = new Map(unique.map((document) => [documentKey(document), new Map()]));
+    const heldPerDocument = new Map();
+    for (const record of renders) {
+        // A render with no view has no pairing key, so it can only ever be shown against nothing.
+        // Counted for its document (it IS retained) but not rendered as a pair.
+        const key = documentKey(record.document);
+        heldPerDocument.set(key, (heldPerDocument.get(key) ?? 0) + 1);
+        if (!record.view)
+            continue;
+        const contested = (claimants.get(record.view)?.size ?? 0) > 1;
+        const view = contested ? `${record.view} (${labels.get(key) ?? key})` : record.view;
+        byDocument.get(key).set(view, record.id);
+    }
+    const offered = unique.map((document) => [...byDocument.get(documentKey(document)).entries()]);
+    const taken = allocate(offered.map((views) => views.length), cap);
+    const references = offered.flatMap((views, index) => views.slice(0, taken[index]).map(([view, artifactId]) => ({ view, artifactId })));
+    const gaps = [];
+    let dropped = 0;
+    unique.forEach((document, index) => {
+        const cut = offered[index].length - taken[index];
+        dropped += cut;
+        const reason = designGapReason(document.renderStatus, heldPerDocument.get(documentKey(document)) ?? 0);
+        // The two ways a design falls short are independent, so one entry carries both: a design can
+        // be short at its source, short at the gallery ceiling, or both at once.
+        if (reason || cut > 0) {
+            gaps.push({ title: document.title, reason, ...(cut > 0 ? { dropped: cut } : {}) });
+        }
+    });
+    return {
+        references,
+        summary: {
+            documents: unique.length,
+            images: references.length,
+            ...(dropped > 0 ? { dropped } : {}),
+            ...(gaps.length ? { gaps } : {}),
+        },
+    };
+}
+/**
+ * Read the task's linked DESIGN documents and their retained renders, then fold them.
+ *
+ * Returns null when the task links no design at all, which is a different fact from a design that
+ * gave nothing: the first has nothing to state and the second is exactly what the summary exists
+ * to say. Two reads regardless of how many designs are attached (the batched
+ * {@link BinaryArtifactStore.listByDocuments}), because this runs on the driver path of every run
+ * whose pipeline carries the gate.
+ *
+ * The documents are read LIVE at gather time rather than off the run's recorded context, for the
+ * same reason the hand-uploaded references are: `recapture` exists so a person can attach a
+ * missing reference mid-review and see it, and a design linked while the gate is parked is that
+ * same act.
+ */
+export async function resolveDesignReferences(documentRepository, store, workspaceId, blockId) {
+    if (!documentRepository || !store)
+        return null;
+    const linked = await documentRepository.listByBlock(workspaceId, blockId);
+    const designs = linked
+        .filter((document) => isDesignSource(document.source))
+        .map((document) => ({
+        source: document.source,
+        externalId: document.externalId,
+        title: document.title,
+        renderStatus: document.renderStatus,
+    }));
+    if (!designs.length)
+        return null;
+    const artifacts = await store.listByDocuments(workspaceId, designs.map((document) => ({ source: document.source, externalId: document.externalId })));
+    return foldDesignReferences(designs, artifacts);
+}
+//# sourceMappingURL=visual-confirm-design-references.js.map

package/dist/modules/execution/visual-confirm-design-references.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/orchestration",
-  "version": "0.238.0",
+  "version": "0.240.0",
   "description": "Delivery-workflow engine for the Agent Architecture Board (execution, bootstrap, pipelines, board, boardScan, requirements, and composition root).",
   "repository": {
     "type": "git",
@@ -25,20 +25,20 @@
   },
   "dependencies": {
     "ai": "^7.0.51",
-    "@cat-factory/agents": "0.117.10",
-    "@cat-factory/caching": "0.18.11",
-    "@cat-factory/contracts": "0.272.0",
-    "@cat-factory/integrations": "0.148.0",
-    "@cat-factory/kernel": "0.270.0",
-    "@cat-factory/prompt-fragments": "1.0.20",
-    "@cat-factory/sandbox": "0.11.97",
-    "@cat-factory/spend": "0.15.38",
-    "@cat-factory/workspaces": "0.26.10"
+    "@cat-factory/agents": "0.117.12",
+    "@cat-factory/caching": "0.18.13",
+    "@cat-factory/contracts": "0.274.0",
+    "@cat-factory/integrations": "0.150.0",
+    "@cat-factory/kernel": "0.272.0",
+    "@cat-factory/prompt-fragments": "1.0.22",
+    "@cat-factory/sandbox": "0.11.99",
+    "@cat-factory/spend": "0.15.40",
+    "@cat-factory/workspaces": "0.26.12"
   },
   "devDependencies": {
     "typescript": "7.0.2",
     "vitest": "^4.1.10",
-    "@cat-factory/sandbox-fixtures": "0.7.307"
+    "@cat-factory/sandbox-fixtures": "0.7.309"
   },
   "scripts": {
     "build": "tsc -b tsconfig.build.json",