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

package/src/lib/design/commit-hunks.js

@@ -0,0 +1,173 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.designCommitHunks = exports.withPartHunks = exports.COMMIT_HUNKS_USAGE = void 0;
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const url_1 = require("url");
+const json_layout_1 = require("./json-layout");
+const resolve_product_1 = require("./system/resolve-product");
+const cli_args_1 = require("./system/sketch/cli-args");
+const sketch_1 = require("./system/sketch/sketch");
+exports.COMMIT_HUNKS_USAGE = 'commit-hunks <file> --part <layer>/<name> [--part <layer>/<name>]… [--id <capability>]… [--message <text>]';
+const same = (a, b) => JSON.stringify(a) === JSON.stringify(b);
+const isEntry = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const sortedByKey = (value) => Object.fromEntries(Object.entries(value).sort(([a], [b]) => a.localeCompare(b)));
+const canonical = (value) => JSON.stringify(value, (_, item) => (isEntry(item) ? sortedByKey(item) : item));
+const PART_KEY = /^[^/]+\/[^/]+$/u;
+const REFUSAL = 'is not split per part: it is neither an object keyed by <layer>/<name>, a list of entries with a part field, nor a capabilities list (--id); commit the whole file with `yarn commit` when no other session edits it';
+const idOf = (entry) => (isEntry(entry) && typeof entry['id'] === 'string' ? entry['id'] : null);
+const mergeById = (lists, ids) => {
+    const { head, work } = lists;
+    const owned = (entry) => { var _a; return ids.includes((_a = idOf(entry)) !== null && _a !== void 0 ? _a : ''); };
+    const taken = work.filter(owned);
+    const merged = head.map((entry) => { var _a; return (owned(entry) ? ((_a = taken.find((t) => idOf(t) === idOf(entry))) !== null && _a !== void 0 ? _a : null) : entry); });
+    return [...merged.filter((entry) => entry !== null), ...taken.filter((t) => !head.some((h) => idOf(h) === idOf(t)))];
+};
+/**
+ * HEAD's content of a shared design JSON file with only the entries of `parts` (or, for `capabilities.json`, of
+ * `ids`) taken from the working tree: an object keyed by part, a list of entries with a `part` field, or an object
+ * whose `capabilities` list holds entries with an `id`. A string is the refusal for any other shape.
+ */
+const withPartHunks = (options) => {
+    const { head, work, parts, ids = [] } = options;
+    if (isEntry(head) && isEntry(work) && Array.isArray(head['capabilities']) && Array.isArray(work['capabilities'])) {
+        if (ids.length === 0)
+            return 'holds capabilities, which are split per id: pass --id <capability>';
+        return Object.assign(Object.assign({}, head), { capabilities: mergeById({ head: head['capabilities'], work: work['capabilities'] }, ids) });
+    }
+    if (ids.length > 0)
+        return 'has no capabilities list, so --id does not apply';
+    if (Array.isArray(head) && Array.isArray(work)) {
+        const owned = (entry) => isEntry(entry) && typeof entry['part'] === 'string' && parts.includes(entry['part']);
+        if ([...head, ...work].some((entry) => !isEntry(entry) || typeof entry['part'] !== 'string'))
+            return REFUSAL;
+        return [
+            ...head.filter((entry) => !owned(entry) || work.some((candidate) => same(candidate, entry))),
+            ...work.filter((entry) => owned(entry) && !head.some((candidate) => same(candidate, entry))),
+        ];
+    }
+    if (isEntry(head) && isEntry(work)) {
+        if ([...Object.keys(head), ...Object.keys(work)].some((key) => !PART_KEY.test(key)))
+            return REFUSAL;
+        const composed = Object.assign({}, head);
+        for (const part of parts) {
+            if (part in work)
+                composed[part] = work[part];
+            else
+                delete composed[part];
+        }
+        return sortedByKey(composed);
+    }
+    return REFUSAL;
+};
+exports.withPartHunks = withPartHunks;
+const git = (cwd, args) => (0, child_process_1.execFileSync)('git', args, { cwd, encoding: 'utf8', stdio: 'pipe' });
+const LOCK_TRIES = 10;
+const gitLocked = (error) => { var _a; return /index\.lock/u.test(String((_a = error.stderr) !== null && _a !== void 0 ? _a : '')); };
+const wait = (ms) => Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+const gitRetrying = (cwd, args) => {
+    for (let attempt = 1;; attempt++) {
+        try {
+            return git(cwd, args);
+        }
+        catch (error) {
+            if (attempt >= LOCK_TRIES || !gitLocked(error))
+                throw error;
+            wait(attempt * 100);
+        }
+    }
+};
+const waitForIndexLock = (target) => __awaiter(void 0, void 0, void 0, function* () {
+    const module = (0, path_1.join)(target, 'tools/scripts/commit-wait.mjs');
+    if (!(0, fs_1.existsSync)(module))
+        return;
+    const { waitForLock } = (yield import((0, url_1.pathToFileURL)(module).href));
+    yield waitForLock((0, path_1.join)(git(target, ['rev-parse', '--absolute-git-dir']).trim(), 'index.lock'));
+});
+const fail = (message, code = 1) => {
+    console.error(message);
+    return code;
+};
+/**
+ * `et design commit-hunks <file> --part <p>` commits only the entries of part `p` of a shared JSON file (`merged.json`,
+ * `ready.json`, ...): HEAD plus those entries is committed for that path, and the working file keeps
+ * every other session's uncommitted entries.
+ */
+const designCommitHunks = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b, _c, _d, _e;
+    const { target, argv, invocation } = options;
+    const args = (0, cli_args_1.argsOf)(argv, { values: ['--part', '--id', '--message'], switches: [] });
+    const [asked, ...extra] = typeof args === 'string' ? [] : args.positional;
+    const asParts = (typeof args === 'string' ? [] : ((_a = args.repeated['--part']) !== null && _a !== void 0 ? _a : [])).map(sketch_1.parseTarget);
+    const ids = typeof args === 'string' ? [] : ((_b = args.repeated['--id']) !== null && _b !== void 0 ? _b : []);
+    const bad = asParts.find((part) => typeof part === 'string');
+    if (typeof args === 'string' || !asked || extra.length > 0 || asParts.length + ids.length === 0) {
+        return fail(`${typeof args === 'string' ? `${args}\n` : ''}usage: ${invocation} ${exports.COMMIT_HUNKS_USAGE}`, 2);
+    }
+    if (typeof bad === 'string')
+        return fail(bad, 2);
+    const parts = asParts.flatMap((part) => (typeof part === 'string' ? [] : [(0, resolve_product_1.partKeyOf)(part)]));
+    const absolute = (0, path_1.isAbsolute)(asked) ? asked : (0, path_1.resolve)(target, asked);
+    const file = (0, path_1.relative)(target, absolute);
+    let original;
+    let work;
+    let head;
+    let headText = '';
+    try {
+        original = (0, fs_1.readFileSync)(absolute, 'utf8');
+        work = JSON.parse(original);
+    }
+    catch (error) {
+        return fail(`${file} is not readable JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    try {
+        headText = git(target, ['show', `HEAD:./${file}`]);
+        head = JSON.parse(headText);
+    }
+    catch (_f) {
+        head = Array.isArray(work) ? [] : {};
+    }
+    const composed = (0, exports.withPartHunks)({ head, work, parts, ids });
+    const names = [...parts, ...ids];
+    if (typeof composed === 'string')
+        return fail(`${file} ${composed}`);
+    if (canonical(composed) === canonical(head)) {
+        const order = canonical(work) === canonical(head) && !same(work, head) ? ' (the rest differs in key order only)' : '';
+        console.log(`${file} holds no uncommitted entry of ${names.join(', ')}${order}`);
+        return 0;
+    }
+    const message = (_c = args.values['--message']) !== null && _c !== void 0 ? _c : `chore(repo): Record ${names.join(', ')} in ${(0, path_1.basename)(file)}`;
+    yield waitForIndexLock(target);
+    (0, fs_1.writeFileSync)(absolute, headText === `${JSON.stringify(head, null, 2)}\n`
+        ? `${JSON.stringify(composed, null, 2)}\n`
+        : (0, json_layout_1.jsonLayoutOf)(composed));
+    try {
+        gitRetrying(target, ['commit', '-m', message, '--', file]);
+    }
+    catch (error) {
+        const output = error;
+        return fail(`${(_d = output.stdout) !== null && _d !== void 0 ? _d : ''}${(_e = output.stderr) !== null && _e !== void 0 ? _e : ''}${file} was not committed`.trim());
+    }
+    finally {
+        (0, fs_1.writeFileSync)(absolute, original);
+    }
+    const rest = canonical(work) !== canonical(composed)
+        ? 'the other entries stay in the working tree'
+        : same(work, composed)
+            ? 'nothing else differs from HEAD'
+            : 'the rest differs from HEAD in key order only (order only)';
+    console.log(`committed ${names.join(', ')} of ${file}; ${rest}`);
+    return 0;
+});
+exports.designCommitHunks = designCommitHunks;
+//# sourceMappingURL=commit-hunks.js.map

package/src/lib/design/commit-hunks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-hunks.js","sourceRoot":"","sources":["../../../../../libs/cli/src/lib/design/commit-hunks.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,iDAA6C;AAC7C,2BAA6D;AAC7D,+BAAqE;AACrE,6BAAoC;AACpC,+CAA6C;AAC7C,8DAAqD;AACrD,uDAAkD;AAClD,mDAAqD;AAExC,QAAA,kBAAkB,GAC7B,4GAA4G,CAAC;AAI/G,MAAM,IAAI,GAAG,CAAC,CAAU,EAAE,CAAU,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAEjF,MAAM,OAAO,GAAG,CAAC,KAAc,EAAkB,EAAE,CACjD,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAEvE,MAAM,WAAW,GAAG,CAAC,KAAY,EAAS,EAAE,CAC1C,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEnF,MAAM,SAAS,GAAG,CAAC,KAAc,EAAU,EAAE,CAC3C,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,IAAa,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAE1F,MAAM,QAAQ,GAAG,iBAAiB,CAAC;AAEnC,MAAM,OAAO,GACX,sNAAsN,CAAC;AAEzN,MAAM,IAAI,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAE1G,MAAM,SAAS,GAAG,CAAC,KAA2C,EAAE,GAAa,EAAE,EAAE;IAC/E,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IAC7B,MAAM,KAAK,GAAG,CAAC,KAAc,EAAE,EAAE,WAAC,OAAA,GAAG,CAAC,QAAQ,CAAC,MAAA,IAAI,CAAC,KAAK,CAAC,mCAAI,EAAE,CAAC,CAAA,EAAA,CAAC;IAClE,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,WAAC,OAAA,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAA,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,mCAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA,EAAA,CAAC,CAAC;IAElH,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACvH,CAAC,CAAC;AAEF;;;;GAIG;AACI,MAAM,aAAa,GAAG,CAAC,OAK7B,EAAoB,EAAE;IACrB,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAEhD,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC;QACjH,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,oEAAoE,CAAC;QAElG,uCAAY,IAAI,KAAE,YAAY,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,cAAc,CAAC,EAAE,EAAE,GAAG,CAAC,IAAG;IAC/G,CAAC;IAED,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,kDAAkD,CAAC;IAE9E,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,CAAC,KAAc,EAAE,EAAE,CAC/B,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QAEvF,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC;YAAE,OAAO,OAAO,CAAC;QAE7G,OAAO;YACL,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;YAC5F,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;SAC7F,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAAE,OAAO,OAAO,CAAC;QAEpG,MAAM,QAAQ,qBAAe,IAAI,CAAE,CAAC;QAEpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,IAAI,IAAI;gBAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;;gBACzC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QAED,OAAO,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AA1CW,QAAA,aAAa,iBA0CxB;AAEF,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,IAAc,EAAE,EAAE,CAAC,IAAA,4BAAY,EAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;AAEjH,MAAM,UAAU,GAAG,EAAE,CAAC;AAEtB,MAAM,SAAS,GAAG,CAAC,KAAc,EAAE,EAAE,WAAC,OAAA,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,MAAC,KAA8B,CAAC,MAAM,mCAAI,EAAE,CAAC,CAAC,CAAA,EAAA,CAAC;AAEhH,MAAM,IAAI,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;AAE9F,MAAM,WAAW,GAAG,CAAC,GAAW,EAAE,IAAc,EAAE,EAAE;IAClD,KAAK,IAAI,OAAO,GAAG,CAAC,GAAI,OAAO,EAAE,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,OAAO,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,OAAO,IAAI,UAAU,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;gBAAE,MAAM,KAAK,CAAC;YAE5D,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAO,MAAc,EAAE,EAAE;IAChD,MAAM,MAAM,GAAG,IAAA,WAAI,EAAC,MAAM,EAAE,+BAA+B,CAAC,CAAC;IAE7D,IAAI,CAAC,IAAA,eAAU,EAAC,MAAM,CAAC;QAAE,OAAO;IAEhC,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,IAAA,mBAAa,EAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAEhE,CAAC;IAEF,MAAM,WAAW,CAAC,IAAA,WAAI,EAAC,GAAG,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,oBAAoB,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;AACjG,CAAC,CAAA,CAAC;AAEF,MAAM,IAAI,GAAG,CAAC,OAAe,EAAE,IAAI,GAAG,CAAC,EAAE,EAAE;IACzC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEvB,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF;;;;GAIG;AACI,MAAM,iBAAiB,GAAG,CAAO,OAA+D,EAAE,EAAE;;IACzG,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAC7C,MAAM,IAAI,GAAG,IAAA,iBAAM,EAAC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;IACrF,MAAM,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;IAC1E,MAAM,OAAO,GAAG,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAA,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,mCAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,oBAAW,CAAC,CAAC;IACnG,MAAM,GAAG,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAA,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,mCAAI,EAAE,CAAC,CAAC;IAC1E,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC;IAE7D,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChG,OAAO,IAAI,CAAC,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,UAAU,IAAI,0BAAkB,EAAE,EAAE,CAAC,CAAC,CAAC;IAC7G,CAAC;IAED,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAEjD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAA,2BAAS,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7F,MAAM,QAAQ,GAAG,IAAA,iBAAU,EAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAA,cAAO,EAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,IAAA,eAAQ,EAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAExC,IAAI,QAAgB,CAAC;IACrB,IAAI,IAAa,CAAC;IAClB,IAAI,IAAa,CAAC;IAClB,IAAI,QAAQ,GAAG,EAAE,CAAC;IAElB,IAAI,CAAC;QACH,QAAQ,GAAG,IAAA,iBAAY,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC1C,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,IAAI,CAAC,GAAG,IAAI,0BAA0B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACzG,CAAC;IAED,IAAI,CAAC;QACH,QAAQ,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC;QACnD,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAAC,WAAM,CAAC;QACP,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACvC,CAAC;IAED,MAAM,QAAQ,GAAG,IAAA,qBAAa,EAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IAE3D,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC;IAEjC,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,GAAG,IAAI,IAAI,QAAQ,EAAE,CAAC,CAAC;IACrE,IAAI,SAAS,CAAC,QAAQ,CAAC,KAAK,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5C,MAAM,KAAK,GACT,SAAS,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,uCAAuC,CAAC,CAAC,CAAC,EAAE,CAAC;QAE1G,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,kCAAkC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC;QAEjF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,OAAO,GAAG,MAAA,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,mCAAI,uBAAuB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAA,eAAQ,EAAC,IAAI,CAAC,EAAE,CAAC;IAE3G,MAAM,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAA,kBAAa,EACX,QAAQ,EACR,QAAQ,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI;QAC/C,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI;QAC1C,CAAC,CAAC,IAAA,0BAAY,EAAC,QAAQ,CAAC,CAC3B,CAAC;IAEF,IAAI,CAAC;QACH,WAAW,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAC7D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,KAA6C,CAAC;QAE7D,OAAO,IAAI,CAAC,GAAG,MAAA,MAAM,CAAC,MAAM,mCAAI,EAAE,GAAG,MAAA,MAAM,CAAC,MAAM,mCAAI,EAAE,GAAG,IAAI,oBAAoB,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9F,CAAC;YAAS,CAAC;QACT,IAAA,kBAAa,EAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,IAAI,GACR,SAAS,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,QAAQ,CAAC;QACrC,CAAC,CAAC,4CAA4C;QAC9C,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC;YACpB,CAAC,CAAC,gCAAgC;YAClC,CAAC,CAAC,2DAA2D,CAAC;IAEpE,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,KAAK,IAAI,EAAE,CAAC,CAAC;IAEjE,OAAO,CAAC,CAAC;AACX,CAAC,CAAA,CAAC;AAjFW,QAAA,iBAAiB,qBAiF5B"}

package/src/lib/design/design-command.d.ts

@@ -1,3 +1,5 @@
+/** Whether `et design <argv>` draws with the SDK libs, so it must not run on a stale build of them. */
+export declare const drawsWithSdkLibs: (argv: string[]) => boolean;
 /**
  * `et design [checkout]` serves the variant frames of a checkout, and `et design check …` says why
  * a call does not render. Both work on any checkout that keeps a `.ethlete/design` folder, so a

package/src/lib/design/design-command.js

@@ -9,13 +9,15 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.designCommand = void 0;
+exports.designCommand = exports.drawsWithSdkLibs = void 0;
 const fs_1 = require("fs");
+const system_tsconfig_1 = require("./system/system-tsconfig");
 const path_1 = require("path");
-const accept_command_1 = require("./system/accept-command");
 const check_1 = require("./check");
 const complete_command_1 = require("./system/complete-command");
-const paths_1 = require("./paths");
+const design_config_1 = require("./design-config");
+const serve_state_1 = require("./serve-state");
+const run_deadline_1 = require("./run-deadline");
 const inbox_command_1 = require("./inbox-command");
 const legacy_1 = require("./legacy");
 const new_call_1 = require("./new-call");
@@ -23,21 +25,39 @@ const product_command_1 = require("./product-command");
 const serve_1 = require("./serve");
 const asset_shot_1 = require("./asset-shot");
 const shot_command_1 = require("./shot-command");
+const commit_hunks_1 = require("./commit-hunks");
 const mcp_command_1 = require("./mcp-command");
 const motion_command_1 = require("./motion-command");
 const sketch_command_1 = require("./sketch-command");
 const stamp_1 = require("./stamp");
+const started_by_studio_1 = require("./started-by-studio");
+const stale_cli_dist_1 = require("./stale-cli-dist");
 const status_1 = require("./status");
 const part_command_1 = require("./system/part-command");
+const actions_command_1 = require("./system/actions-command");
+const compare_command_1 = require("./system/compare-command");
+const dom_command_1 = require("./system/dom-command");
+const task_command_1 = require("./system/task-command");
+const harness_command_1 = require("./system/harness-command");
 const ready_command_1 = require("./system/ready-command");
 const system_command_1 = require("./system/system-command");
+const stale_dist_1 = require("./system/stale-dist");
+const stale_design_mocks_1 = require("./system/stale-design-mocks");
+const client_1 = require("./resident/client");
+const resident_process_1 = require("./resident/resident-process");
+const timings_1 = require("./timings");
+const timings_command_1 = require("./timings-command");
+const realOf = (path) => ((0, fs_1.existsSync)(path) ? (0, fs_1.realpathSync)(path) : path);
 /** Reads `--checkout <path>` out of an argument list, and answers with the path and the rest. */
 const splitCheckout = (argv, root) => {
     var _a;
     const index = argv.indexOf('--checkout');
     if (index === -1)
-        return { target: (0, paths_1.findCheckoutRoot)(root), rest: argv };
-    return { target: (0, path_1.resolve)(root, (_a = argv[index + 1]) !== null && _a !== void 0 ? _a : '.'), rest: [...argv.slice(0, index), ...argv.slice(index + 2)] };
+        return { target: realOf((0, design_config_1.findCheckoutRoot)(root)), rest: argv };
+    return {
+        target: realOf((0, path_1.resolve)(root, (_a = argv[index + 1]) !== null && _a !== void 0 ? _a : '.')),
+        rest: [...argv.slice(0, index), ...argv.slice(index + 2)],
+    };
 };
 const helpOf = (invocation) => [
     `${invocation} [checkout] [--host <address>]`,
@@ -48,12 +68,45 @@ const helpOf = (invocation) => [
     '  Find out why a call does not render: eslint, then tsc, then the live frames. --tsconfig also types each variant',
     '  of an open sketch. --receipt writes the call, the variant, ok, the time and the output to a JSON file.',
     '',
-    `${invocation} check --product <name> [--complete]`,
+    `${invocation} check [<layer>/<name> | --part <layer>/<name>] [--product <name>]`,
     "  Check a product's design system: layer dependencies, hard-coded colours, var() tokens nothing defines,",
     '  copied components, scripted motion, then tsc. Without any flag, check checks every product in config.json.',
-    '  Then it prints the open points of each part: open comments, unmerged sketches, no implements, no controls',
-    '  declared, and the contrasts the render check found under the rule. --complete also draws every component part',
-    '  as complete does and lists each control that lacks a drawn state or surface; it is slow. Open points never fail.',
+    '  Then it prints the open points of each part: open comments, unmerged sketches, no controls',
+    '  declared, the contrasts the render check found under the rule, and each control of a component part that lacks',
+    '  a drawn state or surface as complete draws it - what ready refuses on. Open points never fail.',
+    '  It also lists each view of the harness app (*-view.component.ts) that no part implements and the parts',
+    '  without an implements link (UNLINKED, not an open point), and ends with one',
+    '  line per part with findings and a count of the clean ones. --part (or a leading <layer>/<name>) keeps only that',
+    '  part. A flag no form of check reads, or one the chosen form ignores, fails with exit code 2.',
+    '',
+    `${invocation} check --product <name>… --app-classes [--fix]`,
+    "  Only report the Tailwind classes in the product's harness app source (templates and class strings) that have a",
+    '  canonical form under the stylesheet the app builds with. Exits 1 on a finding. --fix rewrites them in the app source',
+    "  and in the product's parts instead.",
+    '',
+    `${invocation} check --product <name>… --rules [--base <rev|range>]`,
+    "  Only run the static rules on the product's design files and harness app source - no draw, no tsc, no open",
+    '  points. Seconds instead of minutes; CI runs it. Exits 1 on a problem. --base also fails with',
+    '  IMPLEMENTATION-UNCOMPARED on each file git diff <base> names that an implemented part reaches and that moved since',
+    '  its implemented.json record and names the parts; compare --affected compares and records them again.',
+    '',
+    `${invocation} check --product <name>… --live`,
+    "  Open every live state of the product's harness.live spec on the real app and report each visible region",
+    '  (UNCOVERED) that no part component covers and no "partless" { selector, reason } of the spec exempts.',
+    '  Exits 1 on a finding.',
+    '',
+    `${invocation} check --product <name>… --visible-change [--base <rev>] [--part <layer>/<name>…]`,
+    "  Draw each harness part's states in the app at the base (default: the merge base of HEAD and harness.baseBranch,",
+    '  else the branch origin/HEAD names) and',
+    "  at HEAD, against HEAD's design. A part that looks different fails unless a picked or merged sketch of it is in",
+    '  base..HEAD or every changed state is closer to the design than before. --part keeps only those parts.',
+    '  Exits 1 on a failing part.',
+    '',
+    `${invocation} check --product <name>… --slow [--part <layer>/<name>…] [--base <rev>]`,
+    '  Run the slow rules - APP-SPEC, UNCOVERED-REGION, IMPLEMENTS-UNRENDERED, VISIBLE-CHANGE, compare and the SDK-error',
+    "  watch - and store each part's problems in node_modules/.cache/ethlete-design, where the build-ready state reads",
+    '  them.',
+    '  Exits 1 on a problem.',
     '',
     `${invocation} system --json [--product <name>]`,
     "  Print each product's parts as JSON: origin, note, states, widths, presets and the problems of each part.",
@@ -73,6 +126,8 @@ const helpOf = (invocation) => [
     '',
     `${invocation} status <slug> <${status_1.CALL_STATES.join('|')}>`,
     '  Record the state of a call for Ethlete Studio. new and check --call record theirs on their own.',
+    `${invocation} status [--json]`,
+    '  Without a call: the unpushed commits, the age of the oldest and the CI state of this head.',
     '',
     `${invocation} sketch new <layer>/<name> [<layer>/<name>…] --variants a,b --by <model id> [--like <layer>/<name>[:<variant>]] [--round <title>] [--note <text>] [--product <name>]`,
     '  Open a sketch on a part, new or existing, in progress. Each variant starts as a copy of the part, or of the part',
@@ -87,38 +142,75 @@ const helpOf = (invocation) => [
     '',
     `${invocation} sketch report <layer>/<name> --variant <key> --by <model id> <text> [--product <name>] | sketch ready <layer>/<name> --by <model id>`,
     '  Tell Studio what you build on a variant now ("phone, outline state"), which also records you as one of its',
-    '  authors, then mark the sketch ready for the user to pick.',
+    '  authors, then mark the sketch ready for the user to pick. Ready refuses (SHOT-NOT-VIEWED) while a variant draws',
+    `  a pixel diff and no shot of it was handed out since its last edit: run \`${invocation} shot <layer>/<name> --states --variants\``,
+    '  or GET /__design/shot with sketch= and variant=, and look at it.',
     '',
     `${invocation} sketch round <layer>/<name> <round> [--title <text>] [--note <text>] [--drops <state,state>] --by <model id> | sketch list [--json] | sketch check [<layer>/<name>] | sketch preview <layer>/<name> <variant> [--json]`,
     '  List open sketches, check each variant laid over the product, and list the elements and pages a merge changes.',
     '',
-    `${invocation} sketch note <layer>/<name> <variant> <text> --by <model id>`,
+    `${invocation} sketch note <layer>/<name> [<variant>] <text> [--round <round>] --by <model id>`,
     '  Set the note of one variant in sketch.json, the one sketch new sets with --variant-note.',
     '',
-    `${invocation} sketch merge <layer>/<name> [--note <reason>] --by <model id> | sketch discard <layer>/<name> --by <model id>`,
-    '  Merge the variant the user picked, set the note and madeBy (its authors) on the target, then check and',
-    '  restore the old files on failure. Or drop the sketch. Both resolve the addressed comments on its variants and mark the open ones addressed. Studio runs',
+    `${invocation} sketch covers <layer>/<name> [[<layer>/<name>:]<state>[@<x>,<y>,<w>,<h>]…] --by <model id>`,
+    '  Set the compare DIFFs an open sketch covers (ADR 0222): compare lists them with the sketch name and passes.',
+    "  A bare state covers its whole DIFF; @x,y,w,h covers only DIFF pixels inside that box of the state's picture.",
+    '  A sketch with several targets needs <layer>/<name>:<state> (a bare state exits 2); one target takes both.',
+    '  No state clears them; a pick ends the cover.',
+    '',
+    `${invocation} sketch merge <layer>/<name> [--note <reason> [--replace-note]] --by <model id> | sketch discard <layer>/<name> --by <model id>`,
+    '  Merge the variant the user picked, note --note in merged.json (the part note stays; --replace-note writes it',
+    '  over), set madeBy (its authors) on the target, then check and',
+    '  restore the old files on failure. Or drop the sketch. Both resolve the addressed comments on its variants and mark the open ones addressed;',
+    '  a merge keeps a thread open that has no reply yet or whose last entry asks a question. Studio runs',
     "  both on the user's click, so an agent runs neither after a pick. Merge refuses without a pick,",
     '  and when a part the variant replaces changed in the product since the sketch was created.',
     '',
     `${invocation} sketch rebase <layer>/<name> --by <model id>`,
-    '  After bringing each variant up to date with the product, record the product as it is now for the merge.',
-    '',
-    `${invocation} ${accept_command_1.ACCEPT_USAGE}`,
-    "  Record a direct edit of a merged part that the user approved without a sketch: writes the part's hash to",
-    '  merged.json, so check stops warning of it, and logs who accepted it and why in accepted.json. Refuses an unknown',
-    '  part, a part with an open sketch, and a part with no change outside a sketch.',
+    '  Port what changed in the product since the sketch was cut into each variant (a 3-way merge per file), then record',
+    '  the product as it is now for the merge. Any conflict lists the files and writes nothing.',
     '',
     `${invocation} ${ready_command_1.READY_USAGE}`,
     '  Mark a part ready in .ethlete/design/<product>/ready.json. It draws the part and refuses with its open points',
     '  while it has any. The mark drops when the part changes.',
     '',
+    `${invocation} ${task_command_1.TASK_USAGE}`,
+    '  Print what implementing a build-ready part takes: its implements link, each state with its props, the',
+    '  states new or changed since implemented.json, and the files it may change. --verify checks the files of a',
+    '  commit or range (default HEAD) against them, then runs compare and records implemented.json when both pass.',
+    '',
+    `${invocation} ${compare_command_1.COMPARE_USAGE}`,
+    '  Draw each state of a linked build-ready part, or the one --state names, and shoot the',
+    '  [data-design-harness-host] element of <url>/__design-harness?part=&state=&props= in the same Chromium. Prints ok,',
+    '  DIFF <n> px or SIZE per state at tolerance 0 and keeps the pictures of a failing state in a temp folder.',
+    '  A component or element is fitted to its content; a page draws at --preset (default: the first preset of the',
+    '  product) and its harness url adds layout=page, so the host fills that viewport.',
+    '  Without --url it makes a development build of the harness app in a temp folder, serves it on a free port and',
+    '  stops it afterwards, also next to a running dev server of the same app; exits 1 unless every state is ok.',
+    '  --affected compares, on one harness, every implemented part whose app files changed since its implemented.json',
+    '  record, runs its actions check there and records each part that passes both.',
+    '',
+    `${invocation} ${dom_command_1.DOM_USAGE}`,
+    '  Print the pretty-printed HTML of one state of a part (default: its first): the rendered design, or with --app the',
+    '  [data-design-harness-host] element of the app harness page that compare shoots. --app needs a current harness map.',
+    '',
+    `${invocation} ${actions_command_1.ACTIONS_USAGE}`,
+    "  Click and press Enter and Space on each interactive element of the part in the app's harness page, from each",
+    '  state that forces no interaction. Each must reach the state or fire the output its design element declares in',
+    '  data-et-action ("<state>" or "emit:<output>"); a key reaches the "<state>-focus-visible" row where the part draws',
+    '  one. Fails on an element without a declared action and on a design element the app does not draw.',
+    '',
+    `${invocation} ${harness_command_1.HARNESS_USAGE}`,
+    '  Write the harness map named in config.json products.<name>.harness.map: a lazy import of the component each',
+    "  part implements, keyed by <layer>/<name>, for the app's /__design-harness route. --check exits 1 when it is",
+    '  stale; compare and task --verify refuse a stale map.',
+    '',
     `${invocation} ${complete_command_1.COMPLETE_USAGE}`,
     '  Exit 1 while a control the part declares in definePart({ controls }) lacks a drawn state or surface: hover and',
     '  active for pointer input, focus-visible for keyboard, and per kind: active for a button; a collapsed state and',
     '  its visible body for a disclosure; the open surface with hovered, focused and selected options for a select or',
     '  menu; a selected look and selected hover for a row; the visible tooltip for a tooltip; a disabled look when the',
-    '  control declares disabled. A part that changed since its last merge or accept fails too, and so does a drawn',
+    '  control declares disabled. A part that changed since its last merge fails too, and so does a drawn',
     '  control without a data-et-control marker, or an element with a pointer cursor or :hover rule but no control',
     '  role. A control',
     '  inside an embedded part (its data-et-part root) belongs to that part, which must be complete itself; a rule',
@@ -183,13 +275,78 @@ const helpOf = (invocation) => [
     '  working directory and returns its output, its images and its JSON. check on a call writes its receipt to',
     '  --receipt.',
     '',
+    `${invocation} ${commit_hunks_1.COMMIT_HUNKS_USAGE}`,
+    '  Commit only the entries of the part from a shared JSON file (merged.json, ready.json, ...): HEAD plus',
+    '  those entries is committed for that path, and entries of other parts stay uncommitted in the working tree.',
+    '',
+    `${invocation} serve-state`,
+    '  Print who serves the design port (the Studio app or a terminal, with its pid), which cli build it runs against this',
+    '  checkout and how to restart it.',
+    '',
     `${invocation} stamp`,
     '  Print the version and build of this cli as JSON, which a running server answers with too.',
     '',
+    `${invocation} ${timings_command_1.TIMINGS_USAGE}`,
+    '  Every design run appends its timings to .ethlete/design/.timings.jsonl. timings reports the median of each command',
+    '  against its target (compare 5 s, sketch check and ready 10 s, full check 60 s), each miss with its most expensive',
+    '  phase, and the slowest phases and runs. --since defaults to 1d.',
+    '',
+    `${invocation} stop`,
+    '  End the resident design process of the checkout. compare, check --product/--part, sketch check and sketch ready',
+    '  run in it, one at a time (a waiting compare runs between two parts of a check): the first one starts it detached',
+    '  (printed as a cold start), later ones reuse its design server, Chromium and harness app, and it exits after',
+    '  30 min without a request. CI and ETHLETE_DESIGN_RESIDENT=0 run them in their own process.',
+    '',
     'Every command takes --checkout <path>. DE_PORT overrules the port in .ethlete/design/config.json.',
     '',
 ].join('\n');
 const HELP_FLAGS = new Set(['--help', '-h']);
+const TIMED_COMMANDS = new Set([
+    'actions',
+    'check',
+    'comment',
+    'commit-hunks',
+    'compare',
+    'complete',
+    'dom',
+    'harness',
+    'inbox',
+    'legacy',
+    'motion',
+    'new',
+    'part',
+    'product',
+    'ready',
+    'shot',
+    'sketch',
+    'status',
+    'stop',
+    'system',
+    'task',
+    'token',
+]);
+const DRAWING_COMMANDS = new Set([
+    'check',
+    'shot',
+    'compare',
+    'ready',
+    'harness',
+    'motion',
+    'dom',
+    'actions',
+    'complete',
+]);
+const DRAWING_SKETCH_COMMANDS = new Set(['check', 'ready', 'preview']);
+/** Whether `et design <argv>` draws with the SDK libs, so it must not run on a stale build of them. */
+const drawsWithSdkLibs = (argv) => {
+    const [command = '', subcommand = ''] = argv;
+    if (command === 'sketch')
+        return DRAWING_SKETCH_COMMANDS.has(subcommand);
+    if (command === 'task')
+        return argv.includes('--verify');
+    return DRAWING_COMMANDS.has(command);
+};
+exports.drawsWithSdkLibs = drawsWithSdkLibs;
 const alternativesOf = (block, invocation) => { var _a; return ((_a = block[0]) !== null && _a !== void 0 ? _a : '').split(' | ').map((usage) => usage.replace(`${invocation} `, '')); };
 const matchingBlocksOf = (invocation, words) => {
     const blocks = helpOf(invocation)
@@ -217,6 +374,7 @@ const subcommandHelpOf = (invocation, argv) => {
  * repository needs no design tooling of its own.
  */
 const designCommand = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b;
     const { root, argv, invocation } = options;
     if (argv[0] === '--help' || argv[0] === '-h' || argv[0] === 'help') {
         console.log(helpOf(invocation));
@@ -226,10 +384,61 @@ const designCommand = (options) => __awaiter(void 0, void 0, void 0, function* (
         console.log(subcommandHelpOf(invocation, argv));
         return 0;
     }
+    const deadline = { argv, ms: (0, run_deadline_1.deadlineMsOf)((_a = argv[0]) !== null && _a !== void 0 ? _a : '') };
+    if (!TIMED_COMMANDS.has((_b = argv[0]) !== null && _b !== void 0 ? _b : ''))
+        return (0, run_deadline_1.withRunDeadline)(deadline, () => runDesign(options));
+    const { target, rest } = splitCheckout(argv.slice(1), root);
+    return (0, run_deadline_1.withRunDeadline)(deadline, () => { var _a; return (0, timings_1.recordRun)({ file: (0, timings_1.timingsFileOf)(target), argv: [(_a = argv[0]) !== null && _a !== void 0 ? _a : '', ...rest] }, () => runDesign(options)); });
+});
+exports.designCommand = designCommand;
+const runDesign = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    const { root, argv, invocation } = options;
+    const staleWarning = argv[0] === 'stamp' ? null : (0, stale_cli_dist_1.runningCliStaleWarning)();
+    if (staleWarning)
+        console.error(staleWarning);
     if (argv[0] === 'stamp') {
         console.log(JSON.stringify((0, stamp_1.buildStampOf)()));
         return 0;
     }
+    (0, system_tsconfig_1.repairEditorTsconfigs)(splitCheckout(argv.slice(1), root).target);
+    if (argv[0] === client_1.RESIDENT_SERVE || argv[0] === 'stop' || (0, client_1.runsInResident)(argv)) {
+        const { target, rest } = splitCheckout(argv.slice(1), root);
+        if (argv[0] === client_1.RESIDENT_SERVE)
+            return (0, resident_process_1.serveResident)({ target });
+        const client = (0, client_1.realResidentClient)((0, stamp_1.buildStampOf)().build);
+        if (argv[0] === 'stop')
+            return (0, client_1.stopResident)(target, client);
+        if ((0, stale_design_mocks_1.guardsDesignMocks)(argv) && !(0, stale_design_mocks_1.designMocksFresh)({ target }))
+            return 1;
+        const answered = yield (0, client_1.runThroughResident)({ target, argv: [(_a = argv[0]) !== null && _a !== void 0 ? _a : '', ...rest], invocation, client });
+        if (answered !== null) {
+            (0, timings_1.skipRunTimings)();
+            return answered;
+        }
+    }
+    let release = () => undefined;
+    if ((0, exports.drawsWithSdkLibs)(argv)) {
+        const { target } = splitCheckout(argv.slice(1), root);
+        const read = yield (0, stale_dist_1.readFreshDist)({ target, config: (0, design_config_1.readConfig)(target) });
+        if (!read.ok)
+            return 1;
+        release = read.release;
+    }
+    try {
+        return yield dispatchDesign({ root, argv, invocation });
+    }
+    finally {
+        release();
+    }
+});
+const dispatchDesign = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    const { root, argv, invocation } = options;
+    if ((0, stale_design_mocks_1.guardsDesignMocks)(argv)) {
+        const { target } = splitCheckout(argv.slice(1), root);
+        if (!(0, stale_design_mocks_1.designMocksFresh)({ target }))
+            return 1;
+    }
     if (argv[0] === 'check') {
         const { target, rest } = splitCheckout(argv.slice(1), root);
         return (0, check_1.checkDesign)({ target, argv: rest, invocation });
@@ -254,14 +463,30 @@ const designCommand = (options) => __awaiter(void 0, void 0, void 0, function* (
         const { target, rest } = splitCheckout(argv.slice(1), root);
         return (0, sketch_command_1.designSketch)({ target, argv: rest, invocation });
     }
-    if (argv[0] === 'accept') {
-        const { target, rest } = splitCheckout(argv.slice(1), root);
-        return (0, accept_command_1.designAccept)({ target, argv: rest, invocation });
-    }
     if (argv[0] === 'complete') {
         const { target, rest } = splitCheckout(argv.slice(1), root);
         return (0, complete_command_1.designComplete)({ target, argv: rest, invocation });
     }
+    if (argv[0] === 'task') {
+        const { target, rest } = splitCheckout(argv.slice(1), root);
+        return (0, task_command_1.designTask)({ target, argv: rest, invocation });
+    }
+    if (argv[0] === 'harness') {
+        const { target, rest } = splitCheckout(argv.slice(1), root);
+        return (0, harness_command_1.designHarness)({ target, argv: rest, invocation });
+    }
+    if (argv[0] === 'compare') {
+        const { target, rest } = splitCheckout(argv.slice(1), root);
+        return (0, compare_command_1.designCompare)({ target, argv: rest, invocation });
+    }
+    if (argv[0] === 'dom') {
+        const { target, rest } = splitCheckout(argv.slice(1), root);
+        return (0, dom_command_1.designDom)({ target, argv: rest, invocation });
+    }
+    if (argv[0] === 'actions') {
+        const { target, rest } = splitCheckout(argv.slice(1), root);
+        return (0, actions_command_1.designActions)({ target, argv: rest, invocation });
+    }
     if (argv[0] === 'ready') {
         const { target, rest } = splitCheckout(argv.slice(1), root);
         return (0, ready_command_1.designReady)({ target, argv: rest, invocation });
@@ -289,6 +514,10 @@ const designCommand = (options) => __awaiter(void 0, void 0, void 0, function* (
         const { target, rest } = splitCheckout(argv.slice(1), root);
         return (0, asset_shot_1.designToken)({ target, argv: rest, invocation });
     }
+    if (argv[0] === 'commit-hunks') {
+        const { target, rest } = splitCheckout(argv.slice(1), root);
+        return (0, commit_hunks_1.designCommitHunks)({ target, argv: rest, invocation });
+    }
     if (argv[0] === 'inbox') {
         const { target, rest } = splitCheckout(argv.slice(1), root);
         return (0, inbox_command_1.designInbox)({ target, argv: rest, invocation });
@@ -297,6 +526,18 @@ const designCommand = (options) => __awaiter(void 0, void 0, void 0, function* (
         const { target, rest } = splitCheckout(argv.slice(1), root);
         return (0, inbox_command_1.designComment)({ target, argv: rest, invocation });
     }
+    if (argv[0] === 'timings') {
+        const { target, rest } = splitCheckout(argv.slice(1), root);
+        return (0, timings_command_1.designTimings)({ target, argv: rest, invocation });
+    }
+    if (argv[0] === 'serve-state') {
+        const { target } = splitCheckout(argv.slice(1), root);
+        const config = (0, design_config_1.readConfig)(target);
+        return (0, serve_state_1.designServeState)({
+            base: `http://localhost:${config ? (0, design_config_1.portOf)(config) : design_config_1.DEFAULT_PORT}`,
+            own: (0, stamp_1.buildStampOf)(),
+        });
+    }
     if (argv[0] === 'status') {
         const { target, rest } = splitCheckout(argv.slice(1), root);
         return (0, status_1.designStatus)({ target, argv: rest, invocation });
@@ -311,7 +552,10 @@ const designCommand = (options) => __awaiter(void 0, void 0, void 0, function* (
         console.error(helpOf(invocation));
         return 2;
     }
-    return (0, serve_1.serveDesign)({ target: positional ? (0, path_1.resolve)(root, positional) : target, host });
+    return (0, serve_1.serveDesign)({
+        target: positional ? realOf((0, path_1.resolve)(root, positional)) : target,
+        host,
+        reloadOnRebuild: !(0, started_by_studio_1.startedByStudio)(),
+    });
 });
-exports.designCommand = designCommand;
 //# sourceMappingURL=design-command.js.map