@ethlete/cli 3.0.0-next.26 → 3.0.0-next.27

package/src/lib/design/studio-api.js

@@ -27,9 +27,12 @@ var __rest = (this && this.__rest) || function (s, e) {
     return t;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.flowNoteDeleteAnswer = exports.flowNoteChangeAnswer = exports.flowNoteAnswer = exports.noteDeleteAnswer = exports.noteChangeAnswer = exports.noteAnswer = exports.notesAnswer = exports.flowsAnswer = exports.commentReplyAnswer = exports.commentWithdrawAnswer = exports.commentDoneAnswer = exports.commentAnswer = exports.commentsAnswer = exports.sketchDiscardAnswer = exports.sketchMergeAnswer = exports.sketchDecisionAnswer = exports.sketchCropAnswer = exports.sketchDiffAnswer = exports.sketchCompareAnswer = exports.sketchPreviewAnswer = exports.sketchesAnswer = exports.PART_READY_PATH = exports.OPEN_POINTS_PATH = exports.MOTION_PATH = exports.EXCEPTION_APPROVE_PATH = exports.EXCEPTIONS_PATH = exports.INVENTORY_APPROVE_PATH = exports.INVENTORY_PATH = exports.FLOW_NOTE_DELETE_PATH = exports.FLOW_NOTE_CHANGE_PATH = exports.FLOW_NOTE_PATH = exports.NOTE_DELETE_PATH = exports.NOTE_CHANGE_PATH = exports.NOTE_PATH = exports.NOTES_PATH = exports.FLOWS_PATH = exports.COMMENT_EVENTS_PATH = exports.COMMENT_REPLY_PATH = exports.COMMENT_WITHDRAW_PATH = exports.COMMENT_DONE_PATH = exports.COMMENT_PATH = exports.COMMENTS_PATH = exports.SKETCH_DISCARD_PATH = exports.SKETCH_MERGE_PATH = exports.SKETCH_DECISION_PATH = exports.SKETCH_CROP_PATH = exports.SKETCH_DIFF_PATH = exports.SKETCH_COMPARE_PATH = exports.SKETCH_PREVIEW_PATH = exports.SKETCHES_PATH = void 0;
-exports.partReadyAnswer = exports.openPointsAnswer = exports.exceptionApproveAnswer = exports.exceptionsAnswer = exports.inventoryApproveAnswer = exports.inventoryAnswer = void 0;
+exports.flowNoteChangeAnswer = exports.flowNoteAnswer = exports.noteDeleteAnswer = exports.noteChangeAnswer = exports.noteAnswer = exports.notesAnswer = exports.flowsAnswer = exports.commentReplyAnswer = exports.commentWithdrawAnswer = exports.commentDoneAnswer = exports.commentAnswer = exports.commentsAnswer = exports.sketchDiscardAnswer = exports.sketchMergeAnswer = exports.sketchDecisionAnswer = exports.sketchCropAnswer = exports.sketchDiffAnswer = exports.sketchCompareAnswer = exports.sketchPreviewAnswer = exports.sketchesAnswer = exports.PART_ACCEPT_PATH = exports.PART_GO_PATH = exports.OPEN_POINTS_PATH = exports.MOTION_PATH = exports.EXCEPTION_APPROVE_PATH = exports.EXCEPTIONS_PATH = exports.INVENTORY_APPROVE_PATH = exports.INVENTORY_PATH = exports.FLOW_NOTE_DELETE_PATH = exports.FLOW_NOTE_CHANGE_PATH = exports.FLOW_NOTE_PATH = exports.NOTE_DELETE_PATH = exports.NOTE_CHANGE_PATH = exports.NOTE_PATH = exports.NOTES_PATH = exports.FLOWS_PATH = exports.COMMENT_EVENTS_PATH = exports.COMMENT_REPLY_PATH = exports.COMMENT_WITHDRAW_PATH = exports.COMMENT_DONE_PATH = exports.COMMENT_PATH = exports.COMMENTS_PATH = exports.SKETCH_DISCARD_PATH = exports.SKETCH_MERGE_PATH = exports.SKETCH_DECISION_PATH = exports.SKETCH_CROP_PATH = exports.SKETCH_DIFF_PATH = exports.SKETCH_COMPARE_PATH = exports.SKETCH_PREVIEW_PATH = exports.SKETCHES_PATH = void 0;
+exports.partAcceptAnswer = exports.partGoAnswer = exports.openPointsAnswer = exports.exceptionApproveAnswer = exports.exceptionsAnswer = exports.inventoryApproveAnswer = exports.inventoryAnswer = exports.flowNoteDeleteAnswer = void 0;
+const child_process_1 = require("child_process");
 const path_1 = require("path");
+const rxjs_1 = require("rxjs");
+const promises_1 = require("timers/promises");
 const invocation_1 = require("../invocation");
 const paths_1 = require("./paths");
 const comment_1 = require("./system/comments/comment");
@@ -37,12 +40,20 @@ const flow_1 = require("./system/flows/flow");
 const note_1 = require("./system/notes/note");
 const exceptions_1 = require("./system/exceptions");
 const inventory_1 = require("./system/inventory");
+const check_system_1 = require("./system/check-system");
+const part_build_ready_1 = require("./system/part-build-ready");
 const part_ready_1 = require("./system/part-ready");
+const harness_map_1 = require("./system/harness-map");
+const part_go_1 = require("./system/part-go");
+const action_lost_1 = require("./system/action-lost");
 const read_open_points_1 = require("./system/read-open-points");
 const flow_2 = require("./system/rules/flow");
 const check_sketches_1 = require("./system/sketch/check-sketches");
 const cli_args_1 = require("./system/sketch/cli-args");
 const merge_1 = require("./system/sketch/merge");
+const merged_parts_1 = require("./system/sketch/merged-parts");
+const accept_command_1 = require("./system/accept-command");
+const accepted_pictures_1 = require("./system/accepted-pictures");
 const list_system_1 = require("./system/list-system");
 const merge_compare_1 = require("./merge-compare");
 const variant_diff_1 = require("./variant-diff");
@@ -80,8 +91,13 @@ exports.EXCEPTIONS_PATH = '/__design/exceptions';
 exports.EXCEPTION_APPROVE_PATH = '/__design/exception-approve';
 exports.MOTION_PATH = '/__design/motion';
 exports.OPEN_POINTS_PATH = '/__design/open-points';
-exports.PART_READY_PATH = '/__design/part-ready';
+exports.PART_GO_PATH = '/__design/part-go';
+exports.PART_ACCEPT_PATH = '/__design/part-accept';
 const failure = (status, message) => ({ status, body: { error: message } });
+const refusal = (options) => ({
+    status: options.status,
+    body: Object.assign({ error: options.message, reason: options.reason }, options.extra),
+});
 const productOf = ({ target, url }) => {
     const asked = url.searchParams.get('product');
     const config = (0, paths_1.readConfig)(target);
@@ -130,6 +146,17 @@ const withProduct = (method, run) => (asked) => {
     const found = productOf(asked);
     return isAnswer(found) ? found : run(Object.assign(Object.assign({}, found), { asked }));
 };
+const stopping = (signal, run) => (...args) => __awaiter(void 0, void 0, void 0, function* () {
+    signal.throwIfAborted();
+    return run(...args);
+});
+/** `asked` with its loaders refusing to start a module load or a picture once `signal` aborts. */
+const stoppingOn = (asked, signal) => {
+    if (!signal)
+        return asked;
+    const { load, pictureOf, boxOf } = asked;
+    return Object.assign(Object.assign(Object.assign(Object.assign({}, asked), (load ? { load: stopping(signal, load) } : {})), (pictureOf ? { pictureOf: stopping(signal, pictureOf) } : {})), (boxOf ? { boxOf: stopping(signal, boxOf) } : {}));
+};
 const withSketch = (method, run) => withProduct(method, (found) => {
     var _a;
     const parsed = (0, sketch_1.parseTarget)((_a = found.asked.url.searchParams.get('sketch')) !== null && _a !== void 0 ? _a : undefined);
@@ -140,7 +167,7 @@ const withSketch = (method, run) => withProduct(method, (found) => {
         return failure(404, `no sketch on ${parsed.layer}/${parsed.name} in ${found.product.name}`);
     if (typeof sketch === 'string')
         return failure(422, sketch);
-    return run(Object.assign(Object.assign({}, found), { sketch }));
+    return run(Object.assign(Object.assign({}, found), { asked: stoppingOn(found.asked, found.asked.signal), sketch }));
 });
 const problemOf = ({ target, problem }) => ({
     rule: problem.rule,
@@ -160,7 +187,21 @@ const variantChangesOf = ({ current, drawn }) => ({
     dropped: current.states.filter((state) => !drawn.states.includes(state)),
     note: drawn.note === current.note ? null : { before: current.note, after: drawn.note },
 });
-const partTargetsOf = (_a) => __awaiter(void 0, [_a], void 0, function* ({ product, sketch, part, load, pictureOf, skipUnchanged, }) {
+/** Maps `items` one after another, letting the server answer other requests before each, and stops once `signal` aborts. */
+const inTurns = (_a, run_1) => __awaiter(void 0, [_a, run_1], void 0, function* ({ items, signal }, run) {
+    const results = [];
+    for (const item of items) {
+        yield (0, promises_1.setImmediate)();
+        signal === null || signal === void 0 ? void 0 : signal.throwIfAborted();
+        results.push(yield run(item));
+    }
+    return results;
+});
+const keptOf = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    const unchanged = options.problem ? null : yield (0, unchanged_states_1.keptUnchangedStatesOf)(options);
+    return unchanged ? { unchanged } : {};
+});
+const partTargetsOf = (_a) => __awaiter(void 0, [_a], void 0, function* ({ product, sketch, part, load, pictureOf, signal, compare, }) {
     var _b;
     const currentFile = (_b = product.parts.find((entry) => (0, resolve_product_1.partKeyOf)(entry) === part)) === null || _b === void 0 ? void 0 : _b.file;
     const current = currentFile && load
@@ -170,7 +211,7 @@ const partTargetsOf = (_a) => __awaiter(void 0, [_a], void 0, function* ({ produ
             load: () => load({ file: currentFile, product: product.name, sketch: null }),
         })
         : null;
-    return Promise.all(sketch.variants.map((variant) => __awaiter(void 0, void 0, void 0, function* () {
+    return inTurns({ items: sketch.variants, signal }, (variant) => __awaiter(void 0, void 0, void 0, function* () {
         var _a;
         const file = (_a = (0, overlay_1.overlaySketch)({ product, sketch, variant }).parts.find((entry) => (0, resolve_product_1.partKeyOf)(entry) === part)) === null || _a === void 0 ? void 0 : _a.file;
         if (!file || !load)
@@ -181,50 +222,108 @@ const partTargetsOf = (_a) => __awaiter(void 0, [_a], void 0, function* ({ produ
             product: product.name,
             load: () => load({ file, product: product.name, sketch: { target: sketch.target, variant } }),
         }), { states, interactions, problem, note } = _b, widths = __rest(_b, ["states", "interactions", "problem", "note"]);
-        return Object.assign(Object.assign(Object.assign(Object.assign({ part,
+        return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ part,
             variant,
-            states }, ('widths' in widths ? { widths: widths.widths } : {})), { interactions, unchanged: problem || skipUnchanged
-                ? []
-                : yield (0, unchanged_states_1.unchangedStatesOf)({ product, sketch, variant, load, pictureOf, keepPictures: true, part }) }), (problem || !current || current.problem
+            states }, ('widths' in widths ? { widths: widths.widths } : {})), { interactions }), (compare
+            ? {
+                unchanged: problem
+                    ? []
+                    : yield (0, unchanged_states_1.unchangedStatesOf)({ product, sketch, variant, load, pictureOf, keepPictures: true, part }),
+            }
+            : yield keptOf({ product, sketch, variant, part, pictured: !!pictureOf, problem }))), (problem || !current || current.problem
             ? {}
             : { changes: variantChangesOf({ current, drawn: { states, note } }) })), (problem ? { error: problem } : {}));
-    })));
+    }));
+});
+const targetsOf = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    return (yield inTurns({ items: options.sketch.targets, signal: options.signal }, (part) => partTargetsOf(Object.assign(Object.assign({}, options), { part })))).flat();
+});
+const listingOf = (_a) => __awaiter(void 0, [_a], void 0, function* ({ asked, product, light, signal, }) {
+    var _b;
+    const { target } = asked;
+    const listOnly = light && asked.url.searchParams.get('targets') === 'no';
+    const listed = yield (0, sketch_1.listSketchesInTurns)({ productDir: product.dir, product: product.name });
+    const sketches = listed.filter((sketch) => typeof sketch !== 'string');
+    const checked = light
+        ? null
+        : asked.checkSketches
+            ? yield asked.checkSketches({ target, product: product.name })
+            : (0, check_sketches_1.openSketchListingOf)(product);
+    const unreadable = (_b = checked === null || checked === void 0 ? void 0 : checked.unreadable) !== null && _b !== void 0 ? _b : listed.flatMap((sketch) => typeof sketch === 'string' ? [{ rule: 'SKETCH', file: product.dir, message: sketch }] : []);
+    return {
+        status: 200,
+        body: {
+            sketches: yield inTurns({ items: sketches, signal }, (sketch) => __awaiter(void 0, void 0, void 0, function* () {
+                return (Object.assign(Object.assign(Object.assign(Object.assign({}, sketchOf({ sketch, target })), (checked
+                    ? {
+                        problems: checked.variants
+                            .filter((entry) => entry.target === sketch.target)
+                            .map((entry) => ({
+                            variant: entry.variant,
+                            problems: entry.problems.map((p) => problemOf({ target, problem: p })),
+                        })),
+                    }
+                    : {})), (listOnly
+                    ? {}
+                    : {
+                        targets: yield targetsOf({
+                            product,
+                            sketch,
+                            load: asked.load,
+                            pictureOf: asked.pictureOf,
+                            signal,
+                            compare: !light,
+                        }),
+                    })), { report: (0, sketch_1.readSketchReport)({ checkout: target, sketch }) }));
+            })),
+            unreadable: unreadable.map((problem) => problemOf({ target, problem })),
+        },
+    };
 });
-const targetsOf = (options) => __awaiter(void 0, void 0, void 0, function* () { return (yield Promise.all(options.sketch.targets.map((part) => partTargetsOf(Object.assign(Object.assign({}, options), { part }))))).flat(); });
+const runningListings = new Map();
+const startedListing = ({ key, asked, product, light, }) => {
+    const stop = new AbortController();
+    const listing = {
+        askers: 0,
+        stop,
+        answer: listingOf({ asked: stoppingOn(asked, stop.signal), product, light, signal: stop.signal }).finally(() => {
+            if (runningListings.get(key) === listing)
+                runningListings.delete(key);
+        }),
+    };
+    runningListings.set(key, listing);
+    return listing;
+};
 /**
  * The open sketches of `?product=`, each with its target parts (`targetParts`, the first one first), variants, status,
  * decision, the rule problems of every variant, the states, widths and interactions of each target part as each variant
  * draws it (`targets`, one entry per part and variant, tagged with `part`, the first part's entries first), with the states it
  * draws the same as the product now (`unchanged`), the states it adds and drops and its part note when that differs
  * from the product's (`changes`), and the live report
- * of the agent (`report`, `null` when none runs). `?unchanged=no` leaves `unchanged` empty and skips the pixel comparison, which
- * is the slow part of a cold call.
+ * of the agent (`report`, `null` when none runs). `?unchanged=no` answers without `problems`, and with the `unchanged` of a target only
+ * while a full listing's comparison of the same sources is kept: no rule check, no pictures. `&targets=no` also leaves out `targets`: no part module loads.
+ * A listing asked while the same one runs gets that one's answer; it stops when every client that asked for it has closed its request.
  */
-exports.sketchesAnswer = withProduct('GET', (_a) => __awaiter(void 0, [_a], void 0, function* ({ asked, product }) {
-    const { target } = asked;
-    const { unreadable, variants } = (0, check_sketches_1.openSketchProblemsOf)(product);
-    const sketches = (0, sketch_1.listSketches)({ productDir: product.dir, product: product.name }).filter((sketch) => typeof sketch !== 'string');
-    return {
-        status: 200,
-        body: {
-            sketches: yield Promise.all(sketches.map((sketch) => __awaiter(void 0, void 0, void 0, function* () {
-                return (Object.assign(Object.assign({}, sketchOf({ sketch, target })), { problems: variants
-                        .filter((entry) => entry.sketch.target === sketch.target)
-                        .map((entry) => ({
-                        variant: entry.variant,
-                        problems: entry.problems.map((p) => problemOf({ target, problem: p })),
-                    })), targets: yield targetsOf({
-                        product,
-                        sketch,
-                        load: asked.load,
-                        pictureOf: asked.pictureOf,
-                        skipUnchanged: asked.url.searchParams.get('unchanged') === 'no',
-                    }), report: (0, sketch_1.readSketchReport)({ checkout: target, sketch }) }));
-            }))),
-            unreadable: unreadable.map((problem) => problemOf({ target, problem })),
-        },
+exports.sketchesAnswer = withProduct('GET', ({ asked, product }) => {
+    var _a, _b;
+    const light = asked.url.searchParams.get('unchanged') === 'no';
+    const key = JSON.stringify([asked.target, product.name, light, asked.url.searchParams.get('targets') === 'no']);
+    const listing = (_a = runningListings.get(key)) !== null && _a !== void 0 ? _a : startedListing({ key, asked, product, light });
+    const leave = () => {
+        listing.askers -= 1;
+        if (listing.askers > 0)
+            return;
+        listing.stop.abort();
+        if (runningListings.get(key) === listing)
+            runningListings.delete(key);
     };
-}));
+    listing.askers += 1;
+    if ((_b = asked.signal) === null || _b === void 0 ? void 0 : _b.aborted)
+        leave();
+    else if (asked.signal)
+        (0, rxjs_1.fromEvent)(asked.signal, 'abort').pipe((0, rxjs_1.take)(1)).subscribe(leave);
+    return listing.answer;
+});
 /** `?product=&sketch=<layer>/<name>&variant=`: the parts a merge of that variant changes and the elements and pages that show them. */
 exports.sketchPreviewAnswer = withSketch('GET', ({ asked, product, sketch }) => {
     var _a;
@@ -255,7 +354,7 @@ exports.sketchCompareAnswer = withSketch('GET', (_a) => __awaiter(void 0, [_a],
             size: asked.url.searchParams.get('size'),
             params: asked.url.searchParams,
             pictureOf,
-            load: ({ file, product: name }) => load({ file, product: name, sketch: null }),
+            load,
         }),
     };
 }));
@@ -266,7 +365,7 @@ exports.sketchCompareAnswer = withSketch('GET', (_a) => __awaiter(void 0, [_a],
 exports.sketchDiffAnswer = withSketch('GET', (_a) => __awaiter(void 0, [_a], void 0, function* ({ asked, product, sketch }) {
     var _b, _c;
     const variant = (_b = asked.url.searchParams.get('variant')) !== null && _b !== void 0 ? _b : '';
-    const part = (_c = asked.url.searchParams.get('part')) !== null && _c !== void 0 ? _c : sketch.target;
+    const part = (_c = asked.url.searchParams.get('part')) !== null && _c !== void 0 ? _c : sketch.targets[0];
     const { load, pictureOf, boxOf } = asked;
     if (!sketch.variants.includes(variant))
         return failure(404, `${sketch.target} has no variant "${variant}"`);
@@ -344,14 +443,27 @@ exports.sketchDecisionAnswer = withSketch('POST', (_a) => __awaiter(void 0, [_a]
 }));
 /**
  * POST `?product=&sketch=`, body `{ note? }`: merges the picked variant into the product, as `et design sketch merge` does.
- * A merge refused for a stale baseline answers 422 with `changed` (the parts, `[]` without a baseline) and the `rebase` command.
+ * A merge refused for a stale baseline answers 422 with `changed` (the parts, `[]` without a baseline) and the `rebase` command;
+ * one the check fails after answers 422 with reason `check-failed` and the check's `findings` lines.
  */
 exports.sketchMergeAnswer = withSketch('POST', (_a) => __awaiter(void 0, [_a], void 0, function* ({ asked, config, product, sketch }) {
     const body = yield bodyOf(asked.request);
     const note = textOf(body === null || body === void 0 ? void 0 : body['note']);
     const merged = (0, merge_1.mergeSketch)({ target: asked.target, config, product, sketch, note });
+    if (Array.isArray(merged))
+        (0, harness_map_1.refreshHarnessMap)({ target: asked.target, product });
+    if (Array.isArray(merged) && (note === null || note === void 0 ? void 0 : note.trim()))
+        for (const part of sketch.targets)
+            (0, merged_parts_1.recordMergeReason)({ product, part, reason: note.trim() });
     if (Array.isArray(merged))
         return { status: 200, body: { merged } };
+    if (merged.findings)
+        return refusal({
+            status: 422,
+            reason: 'check-failed',
+            message: merged.reason,
+            extra: { findings: merged.findings },
+        });
     if (!merged.changed)
         return failure(422, merged.reason);
     return {
@@ -368,9 +480,22 @@ exports.sketchDiscardAnswer = withSketch('POST', ({ asked, sketch }) => {
     const problem = (0, merge_1.discardSketch)({ target: asked.target, sketch });
     return problem ? failure(422, problem) : { status: 200, body: { discarded: sketch.target } };
 });
+const userNameOf = (dir) => {
+    try {
+        return ((0, child_process_1.execFileSync)('git', ['config', 'user.name'], {
+            cwd: dir,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim() || null);
+    }
+    catch (_a) {
+        return null;
+    }
+};
 /**
  * `?product=[&part=<layer>/<name>]`: every comment with its `replies`, oldest first, each with the reason it
- * is stale or `null`, its `threadState` (`agent`, `question` or `answered`) and, once closed, its `resolved`.
+ * is stale or `null`, its `threadState` (`agent`, `question` or `answered`) and, once closed, its `resolved`; `userName` is
+ * the `git config user.name` of the checkout, or `null`.
  */
 exports.commentsAnswer = withProduct('GET', ({ asked, product }) => {
     const part = asked.url.searchParams.get('part');
@@ -382,6 +507,7 @@ exports.commentsAnswer = withProduct('GET', ({ asked, product }) => {
                 .filter((comment) => !part || comment.part === part)
                 .map((comment) => commentOf({ comment, target: asked.target, product })),
             unreadable: unreadable.map(({ file, problem }) => ({ file: (0, path_1.relative)(asked.target, file), problem })),
+            userName: userNameOf(product.dir),
         },
     };
 });
@@ -577,10 +703,10 @@ exports.exceptionApproveAnswer = withProduct('POST', (_a) => __awaiter(void 0, [
 }));
 const knownPartOf = (product, part) => {
     if (typeof part !== 'string' || part === '')
-        return failure(400, 'part is required');
+        return refusal({ status: 400, reason: 'part-missing', message: 'part is required' });
     return product.parts.some((candidate) => (0, resolve_product_1.partKeyOf)(candidate) === part)
         ? part
-        : failure(404, `product "${product.name}" has no part "${part}"`);
+        : refusal({ status: 404, reason: 'unknown-part', message: `product "${product.name}" has no part "${part}"` });
 };
 const drawnPointsOf = (_a, part_1) => __awaiter(void 0, [_a, part_1], void 0, function* ({ asked, config, product }, part) {
     const points = yield (0, part_ready_1.drawnPartPointsOf)({ target: asked.target, config, product, part });
@@ -589,6 +715,8 @@ const drawnPointsOf = (_a, part_1) => __awaiter(void 0, [_a, part_1], void 0, fu
 /**
  * GET `?product=&part=&draw=`: the open points of one part, or of every part without `part`. Contrasts and missing
  * control states need a draw: only `draw=true` with a `part` lists them, and `drawn` says whether they are in.
+ * `directEdit` says whether the merged part changed outside a sketch and waits for an accept; `buildReady` whether the
+ * part may be built now, or its blockers.
  */
 exports.openPointsAnswer = withProduct('GET', (found) => __awaiter(void 0, void 0, void 0, function* () {
     const { url } = found.asked;
@@ -610,31 +738,108 @@ exports.openPointsAnswer = withProduct('GET', (found) => __awaiter(void 0, void
     const located = (0, part_ready_1.readyPartOf)({ product: found.product, part });
     const hash = typeof located === 'string' ? null : located.hash;
     const ready = (0, part_ready_1.readyMarkOf)({ product: found.product, part });
-    return { status: 200, body: { part, hash, ready, drawn: draw === 'true', points } };
+    const directEdit = (0, merged_parts_1.changedOutsideSketchOf)(found.product).includes(part);
+    const inputs = (0, check_system_1.buildReadyInputsOf)(found.product);
+    const buildReady = (0, part_build_ready_1.buildReadyOf)({
+        product: found.product,
+        part,
+        inputs: Object.assign(Object.assign({}, inputs), { pointsOf: (key) => (key === part ? points : inputs.pointsOf(key)) }),
+    });
+    return { status: 200, body: { part, hash, ready, directEdit, buildReady, drawn: draw === 'true', points } };
 }));
+const STUDIO_CLICK = 'user';
+const shownHashRefusalOf = (options) => {
+    const { product, part, shown } = options;
+    if (typeof shown !== 'string' || shown === '')
+        return refusal({ status: 400, reason: 'hash-missing', message: 'hash is required' });
+    const located = (0, part_ready_1.readyPartOf)({ product, part });
+    return typeof located !== 'string' && located.hash !== shown
+        ? refusal({
+            status: 409,
+            reason: 'changed',
+            message: `${part} changed since it was shown - reload and check it again`,
+        })
+        : null;
+};
 /**
- * POST `?product=`, body `{ part, hash, by }`: marks a part ready at the hash Studio showed. It draws the part and
- * refuses with 422 and the `points` while its open-point list is not empty.
+ * POST `?product=`, body `{ part, hash }`: stores the Studio user's go for a part at the hash Studio showed, with the action keys it declares, regenerates a
+ * stale harness map (`harness` says why it could not; the go stands), then its go pictures (`unstored` says why not). A refusal answers `reason`: `hash-missing` (400), `unknown-part` (404) or
+ * `changed` (409). A go needs no empty open-point list.
  */
-exports.partReadyAnswer = withProduct('POST', (found) => __awaiter(void 0, void 0, void 0, function* () {
+exports.partGoAnswer = withProduct('POST', (found) => __awaiter(void 0, void 0, void 0, function* () {
     const body = yield bodyOf(found.asked.request);
     if (!body)
         return failure(400, 'the body must be a JSON object');
     const part = knownPartOf(found.product, body['part']);
     if (typeof part !== 'string')
         return part;
-    const marked = yield (0, part_ready_1.markPartReady)({
+    const shown = shownHashRefusalOf({ product: found.product, part, shown: body['hash'] });
+    if (shown)
+        return shown;
+    const load = found.asked.load;
+    const actions = load
+        ? yield (0, action_lost_1.partActionsOf)({
+            load: ({ file, product }) => load({ file, product, sketch: null }),
+            product: found.product,
+            part,
+        })
+        : undefined;
+    const marked = (0, part_go_1.markPartGo)(Object.assign({ product: found.product, part, by: STUDIO_CLICK, via: 'studio click', hash: body['hash'], note: 'studio click' }, (Array.isArray(actions) ? { actions } : {})));
+    if ('status' in marked)
+        return refusal({
+            status: marked.status,
+            reason: marked.status === 409 ? 'changed' : 'unknown-part',
+            message: marked.error,
+        });
+    const refreshed = (0, harness_map_1.refreshHarnessMap)({ target: found.asked.target, product: found.product });
+    const harness = typeof refreshed === 'string' ? refreshed : undefined;
+    const unstored = yield (0, accepted_pictures_1.storePictures)({
+        target: found.asked.target,
+        config: found.config,
         product: found.product,
         part,
-        hash: body['hash'],
-        by: body['by'],
-        pointsOf: () => drawnPointsOf(found, part),
+        kind: 'go',
+        hash: marked.hash,
+        draw: found.asked.drawStates,
     });
-    if ('status' in marked)
-        return {
-            status: marked.status,
-            body: Object.assign({ error: marked.error }, (marked.points ? { points: marked.points } : {})),
-        };
-    return { status: 200, body: { part, hash: marked.hash, ready: marked, points: [] } };
+    return { status: 200, body: Object.assign({ part, hash: marked.hash, go: marked, unstored }, (harness ? { harness } : {})) };
+}));
+/**
+ * POST `?product=`, body `{ part, hash, note? }`: accepts the Studio user's approval of a direct edit of a merged part,
+ * as `et design accept` does. Checks everything before it writes; a refusal answers `reason`: `hash-missing`,
+ * `unknown-part`, `changed`, `findings` (with the `findings` lines), `open-sketch` or `nothing-to-accept`.
+ */
+exports.partAcceptAnswer = withProduct('POST', (found) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    const body = yield bodyOf(found.asked.request);
+    if (!body)
+        return failure(400, 'the body must be a JSON object');
+    const part = knownPartOf(found.product, body['part']);
+    if (typeof part !== 'string')
+        return part;
+    const shown = shownHashRefusalOf({ product: found.product, part, shown: body['hash'] });
+    if (shown)
+        return shown;
+    const refused = (0, accept_command_1.partAcceptRefusalOf)({ target: found.asked.target, product: found.product, part });
+    if (refused)
+        return refusal({
+            status: refused.reason === 'unknown-part' ? 404 : 422,
+            reason: refused.reason,
+            message: refused.error,
+            extra: 'findings' in refused ? { findings: refused.findings } : {},
+        });
+    const note = ((_a = textOf(body['note'])) === null || _a === void 0 ? void 0 : _a.trim()) || 'approved by a click in Studio';
+    const step = (0, accept_command_1.acceptRunOf)({
+        target: found.asked.target,
+        config: found.config,
+        product: found.product,
+        part,
+        by: STUDIO_CLICK,
+        note,
+        draw: found.asked.drawStates,
+    });
+    if ((yield step.run()) !== 0)
+        return refusal({ status: 409, reason: 'changed', message: `${part} changed while it was accepted - reload it` });
+    return { status: 200, body: { part, accepted: { by: STUDIO_CLICK, note } } };
 }));
 //# sourceMappingURL=studio-api.js.map