@xenon-device-management/xenon 2.9.2 → 2.10.0

package/lib/test/unit/selector-health-actions.spec.js

@@ -0,0 +1,106 @@
+"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());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+require("reflect-metadata");
+const chai_1 = require("chai");
+const supertest_1 = __importDefault(require("supertest"));
+const typedi_1 = require("typedi");
+const scratch_database_1 = require("../helpers/scratch-database");
+const selector_health_fixture_1 = require("../helpers/selector-health-fixture");
+const SelectorStateService_1 = require("../../src/services/SelectorStateService");
+describe('POST /healing/selector/state (real queries)', function () {
+    this.timeout(90000);
+    const scratch = (0, scratch_database_1.useScratchDatabase)();
+    before(() => __awaiter(this, void 0, void 0, function* () {
+        yield (0, selector_health_fixture_1.seedSelectorHealth)(scratch.db);
+        // The service's transactions use the scratch database's own client.
+        typedi_1.Container.set(SelectorStateService_1.SelectorStateService, new SelectorStateService_1.SelectorStateService(scratch.db, { emitToDashboard: () => undefined }));
+    }));
+    after(() => {
+        typedi_1.Container.remove(SelectorStateService_1.SelectorStateService);
+    });
+    const act = (auth, body) => (0, supertest_1.default)((0, selector_health_fixture_1.selectorHealthApp)(auth)).post('/healing/selector/state').send(body);
+    it('lets a member mute a selector they can see, recording them and their reason', () => __awaiter(this, void 0, void 0, function* () {
+        const res = yield act(selector_health_fixture_1.MEMBER_A, {
+            original_strategy: 'id',
+            original_selector: selector_health_fixture_1.SEL.warm,
+            action: 'mute',
+            reason: '  Moving to the new cart  ',
+        });
+        (0, chai_1.expect)(res.status).to.equal(200);
+        const state = yield scratch.db.selectorState.findUnique({
+            where: {
+                original_strategy_original_selector: {
+                    original_strategy: 'id',
+                    original_selector: selector_health_fixture_1.SEL.warm,
+                },
+            },
+        });
+        (0, chai_1.expect)(state === null || state === void 0 ? void 0 : state.status).to.equal('muted');
+        const events = yield scratch.db.selectorEvent.findMany({
+            where: { original_selector: selector_health_fixture_1.SEL.warm },
+        });
+        (0, chai_1.expect)(events.map((e) => [e.action, e.user_id, e.reason])).to.deep.equal([
+            ['muted', selector_health_fixture_1.USER.priya, 'Moving to the new cart'],
+        ]);
+    }));
+    it("refuses a member another team's selector, as if it didn't exist", () => __awaiter(this, void 0, void 0, function* () {
+        const res = yield act(selector_health_fixture_1.MEMBER_A, {
+            original_strategy: 'xpath',
+            original_selector: selector_health_fixture_1.SEL.bOnly,
+            action: 'mark_fixed',
+        });
+        (0, chai_1.expect)(res.status).to.equal(404);
+        (0, chai_1.expect)(res.body).to.deep.equal({ error: 'not_found', message: 'Selector not found' });
+        (0, chai_1.expect)(yield scratch.db.selectorState.count({ where: { original_selector: selector_health_fixture_1.SEL.bOnly } })).to.equal(0);
+    }));
+    it('lets an admin act on any selector', () => __awaiter(this, void 0, void 0, function* () {
+        const res = yield act(selector_health_fixture_1.ADMIN, {
+            original_strategy: 'xpath',
+            original_selector: selector_health_fixture_1.SEL.bOnly,
+            action: 'mark_fixed',
+        });
+        (0, chai_1.expect)(res.status).to.equal(200);
+        (0, chai_1.expect)(res.body.state.status).to.equal('pending');
+    }));
+    it('refuses a caller without the sessions scope', () => __awaiter(this, void 0, void 0, function* () {
+        const res = yield act(selector_health_fixture_1.READ_ONLY_A, {
+            original_strategy: 'xpath',
+            original_selector: selector_health_fixture_1.SEL.hot,
+            action: 'mute',
+        });
+        (0, chai_1.expect)(res.status).to.equal(403);
+    }));
+    it('marks fixed a selector recorded with no strategy', () => __awaiter(this, void 0, void 0, function* () {
+        const res = yield act(selector_health_fixture_1.MEMBER_A, {
+            original_strategy: '',
+            original_selector: selector_health_fixture_1.SEL.legacy,
+            action: 'mark_fixed',
+        });
+        (0, chai_1.expect)(res.status).to.equal(200);
+        const state = yield scratch.db.selectorState.findFirst({
+            where: { original_selector: selector_health_fixture_1.SEL.legacy },
+        });
+        (0, chai_1.expect)(state).to.include({ original_strategy: '', status: 'pending' });
+    }));
+    it('refuses a reason over 500 characters', () => __awaiter(this, void 0, void 0, function* () {
+        const res = yield act(selector_health_fixture_1.MEMBER_A, {
+            original_strategy: 'xpath',
+            original_selector: selector_health_fixture_1.SEL.hot,
+            action: 'mute',
+            reason: 'x'.repeat(501),
+        });
+        (0, chai_1.expect)(res.status).to.equal(400);
+    }));
+});

package/lib/test/unit/selector-health-detail.spec.js

@@ -0,0 +1,131 @@
+"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());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+require("reflect-metadata");
+const chai_1 = require("chai");
+const supertest_1 = __importDefault(require("supertest"));
+const scratch_database_1 = require("../helpers/scratch-database");
+const selector_health_fixture_1 = require("../helpers/selector-health-fixture");
+const selectorDetail_1 = require("../../src/services/selector-health/selectorDetail");
+describe('selector panel: the query', () => {
+    it('needs a selector, and reads the rest with defaults', () => {
+        (0, chai_1.expect)((0, selectorDetail_1.parseSelectorDetailQuery)({})).to.equal(null);
+        (0, chai_1.expect)((0, selectorDetail_1.parseSelectorDetailQuery)({ selector: '//a' })).to.deep.equal({
+            strategy: '',
+            selector: '//a',
+            days: 30,
+            tz: 0,
+        });
+        (0, chai_1.expect)((0, selectorDetail_1.parseSelectorDetailQuery)({ strategy: 'xpath', selector: '//a', days: '7', tz: '330' })).to.deep.equal({ strategy: 'xpath', selector: '//a', days: 7, tz: 330 });
+    });
+});
+describe('GET /healing/selectors/detail (real queries)', function () {
+    this.timeout(90000);
+    const scratch = (0, scratch_database_1.useScratchDatabase)();
+    before(() => __awaiter(this, void 0, void 0, function* () {
+        yield (0, selector_health_fixture_1.seedSelectorHealth)(scratch.db);
+    }));
+    const detail = (auth, query) => (0, supertest_1.default)((0, selector_health_fixture_1.selectorHealthApp)(auth)).get('/healing/selectors/detail').query(query);
+    it('answers everything the panel shows', () => __awaiter(this, void 0, void 0, function* () {
+        const res = yield detail(selector_health_fixture_1.ADMIN, { strategy: 'xpath', selector: selector_health_fixture_1.SEL.hot, days: '30', tz: '0' });
+        (0, chai_1.expect)(res.status).to.equal(200);
+        const b = res.body;
+        (0, chai_1.expect)(b).to.deep.include({
+            strategy: 'xpath',
+            selector: selector_health_fixture_1.SEL.hot,
+            days: 30,
+            heals: 4,
+            sessions: 2,
+            timeSpentMs: 18000,
+            canAct: true,
+        });
+        (0, chai_1.expect)(b.suggestions.map((s) => [
+            s.selector,
+            s.strategy,
+            s.count,
+            s.share,
+            s.methods,
+        ])).to.deep.equal([
+            [selector_health_fixture_1.FIX.hot, 'xpath', 3, 0.75, ['Visual AI']],
+            [selector_health_fixture_1.FIX.hotLlm, 'accessibility id', 1, 0.25, ['LLM']],
+        ]);
+        (0, chai_1.expect)(b.suggestions[0].averageConfidence).to.be.closeTo(0.9, 1e-9);
+        (0, chai_1.expect)(b.platforms).to.deep.equal([{ name: 'android', count: 4 }]);
+        (0, chai_1.expect)(b.builds).to.deep.equal([
+            { id: selector_health_fixture_1.BUILD.id, name: selector_health_fixture_1.BUILD.name, count: 3 },
+            { id: null, name: 'No build', count: 1 },
+        ]);
+        (0, chai_1.expect)(b.devices).to.deep.equal([{ udid: selector_health_fixture_1.PHONE.shared, name: 'Shared Pixel', count: 4 }]);
+        (0, chai_1.expect)(b.recent).to.have.length(4);
+        (0, chai_1.expect)(b.recent[0]).to.include({
+            sessionId: 'sh-s-shared-1',
+            buildId: selector_health_fixture_1.BUILD.id,
+            device: 'Shared Pixel',
+            method: 'Visual AI',
+            healedSelector: selector_health_fixture_1.FIX.hot,
+        });
+        (0, chai_1.expect)(b.recent[3]).to.include({ sessionId: 'sh-s-shared-2', buildId: null, method: 'LLM' });
+        (0, chai_1.expect)(b.daily).to.have.length(31);
+        (0, chai_1.expect)(b.daily.reduce((s, d) => s + d.heals, 0)).to.equal(4);
+        (0, chai_1.expect)(b.state).to.include({ status: 'active', brokeAgain: 2 });
+        (0, chai_1.expect)(b.activity).to.deep.equal([]);
+    }));
+    it('shows who did what, newest first, naming nobody for a user who is gone', () => __awaiter(this, void 0, void 0, function* () {
+        const b = (yield detail(selector_health_fixture_1.ADMIN, { strategy: 'xpath', selector: selector_health_fixture_1.SEL.fixed })).body;
+        (0, chai_1.expect)(b.activity.map((a) => [a.action, a.by])).to.deep.equal([
+            ['verified', null],
+            ['marked_fixed', { id: selector_health_fixture_1.USER.gone, name: null }],
+        ]);
+        (0, chai_1.expect)(b.state).to.deep.include({ status: 'resolved', fixedBy: { id: selector_health_fixture_1.USER.gone, name: null } });
+    }));
+    it("gives a member a muted selector's reason, and who muted it", () => __awaiter(this, void 0, void 0, function* () {
+        const b = (yield detail(selector_health_fixture_1.MEMBER_A, { strategy: 'xpath', selector: selector_health_fixture_1.SEL.muted })).body;
+        (0, chai_1.expect)(b.activity).to.have.length(1);
+        (0, chai_1.expect)(b.activity[0]).to.deep.include({
+            action: 'muted',
+            by: { id: selector_health_fixture_1.USER.priya, name: 'Priya' },
+            reason: 'Screen being redesigned',
+        });
+        (0, chai_1.expect)(b.state).to.deep.include({
+            mutedBy: { id: selector_health_fixture_1.USER.priya, name: 'Priya' },
+            muteReason: 'Screen being redesigned',
+        });
+    }));
+    it("answers another team's selector exactly as one that doesn't exist", () => __awaiter(this, void 0, void 0, function* () {
+        const hidden = yield detail(selector_health_fixture_1.MEMBER_A, { strategy: 'xpath', selector: selector_health_fixture_1.SEL.bOnly });
+        const missing = yield detail(selector_health_fixture_1.MEMBER_A, { strategy: 'xpath', selector: '//nothing/here' });
+        (0, chai_1.expect)(hidden.status).to.equal(404);
+        (0, chai_1.expect)(hidden.body).to.deep.equal({ error: 'not_found', message: 'Selector not found' });
+        (0, chai_1.expect)(missing.status).to.equal(404);
+        (0, chai_1.expect)(missing.body).to.deep.equal(hidden.body);
+    }));
+    it('opens a heal recorded with no strategy, and a selector full of punctuation', () => __awaiter(this, void 0, void 0, function* () {
+        (0, chai_1.expect)((yield detail(selector_health_fixture_1.MEMBER_A, { strategy: '', selector: selector_health_fixture_1.SEL.legacy })).body.heals).to.equal(1);
+        (0, chai_1.expect)((yield detail(selector_health_fixture_1.MEMBER_A, { strategy: 'xpath', selector: selector_health_fixture_1.SEL.odd })).body.heals).to.equal(1);
+    }));
+    it("counts days in the caller's time zone", () => __awaiter(this, void 0, void 0, function* () {
+        const b = (yield detail(selector_health_fixture_1.ADMIN, { strategy: 'xpath', selector: selector_health_fixture_1.SEL.hot, days: '7', tz: '330' }))
+            .body;
+        (0, chai_1.expect)(b.daily).to.have.length(8);
+        for (const d of b.daily)
+            (0, chai_1.expect)((d.t + 330 * 60000) % selector_health_fixture_1.DAY).to.equal(0);
+    }));
+    it('needs a selector', () => __awaiter(this, void 0, void 0, function* () {
+        (0, chai_1.expect)((yield detail(selector_health_fixture_1.ADMIN, {})).status).to.equal(400);
+    }));
+    it('says a read-only caller cannot act', () => __awaiter(this, void 0, void 0, function* () {
+        const b = (yield detail(selector_health_fixture_1.READ_ONLY_A, { strategy: 'xpath', selector: selector_health_fixture_1.SEL.hot })).body;
+        (0, chai_1.expect)(b.canAct).to.equal(false);
+    }));
+});

package/lib/test/unit/selector-health-list.spec.js

@@ -0,0 +1,185 @@
+"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());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+require("reflect-metadata");
+const chai_1 = require("chai");
+const supertest_1 = __importDefault(require("supertest"));
+const scratch_database_1 = require("../helpers/scratch-database");
+const selector_health_fixture_1 = require("../helpers/selector-health-fixture");
+const selectorList_1 = require("../../src/services/selector-health/selectorList");
+describe('selector list: the query', () => {
+    it('reads every field, and falls back for anything it does not know', () => {
+        (0, chai_1.expect)((0, selectorList_1.parseSelectorListQuery)({})).to.deep.equal({
+            tab: 'fix',
+            days: 30,
+            q: '',
+            platform: null,
+            method: null,
+            sort: 'heals',
+            page: 1,
+            pageSize: 50,
+        });
+        (0, chai_1.expect)((0, selectorList_1.parseSelectorListQuery)({
+            tab: 'muted',
+            days: '7',
+            q: '  confirm ',
+            platform: 'ios',
+            method: 'LLM',
+            sort: 'time',
+            page: '3',
+            pageSize: '20',
+        })).to.deep.equal({
+            tab: 'muted',
+            days: 7,
+            q: 'confirm',
+            platform: 'ios',
+            method: 'LLM',
+            sort: 'time',
+            page: 3,
+            pageSize: 20,
+        });
+        (0, chai_1.expect)((0, selectorList_1.parseSelectorListQuery)({
+            tab: 'active',
+            days: '9999',
+            sort: 'random',
+            page: '-2',
+            pageSize: '1000',
+        })).to.include({ tab: 'fix', days: 365, sort: 'heals', page: 1, pageSize: 100 });
+    });
+});
+describe('GET /healing/selectors (real queries)', function () {
+    this.timeout(90000);
+    const scratch = (0, scratch_database_1.useScratchDatabase)();
+    before(() => __awaiter(this, void 0, void 0, function* () {
+        yield (0, selector_health_fixture_1.seedSelectorHealth)(scratch.db);
+    }));
+    const list = (auth, qs = '') => (0, supertest_1.default)((0, selector_health_fixture_1.selectorHealthApp)(auth)).get(`/healing/selectors${qs}`);
+    const names = (res) => res.body.items.map((i) => i.selector);
+    it('lists what to fix, most heals first, with every tab counted', () => __awaiter(this, void 0, void 0, function* () {
+        const res = yield list(selector_health_fixture_1.ADMIN);
+        (0, chai_1.expect)(res.status).to.equal(200);
+        (0, chai_1.expect)(names(res)).to.deep.equal([selector_health_fixture_1.SEL.hot, selector_health_fixture_1.SEL.bOnly, selector_health_fixture_1.SEL.warm, selector_health_fixture_1.SEL.legacy, selector_health_fixture_1.SEL.odd]);
+        (0, chai_1.expect)(res.body.counts).to.deep.equal({ fix: 5, verifying: 1, fixed: 1, muted: 2 });
+        (0, chai_1.expect)(res.body).to.include({
+            tab: 'fix',
+            days: 30,
+            page: 1,
+            pageSize: 50,
+            total: 5,
+            canAct: true,
+        });
+    }));
+    it('describes each selector: heals, sessions, time, method, suggestion and status', () => __awaiter(this, void 0, void 0, function* () {
+        const hot = (yield list(selector_health_fixture_1.ADMIN)).body.items[0];
+        (0, chai_1.expect)(hot).to.deep.include({
+            strategy: 'xpath',
+            selector: selector_health_fixture_1.SEL.hot,
+            heals: 4,
+            sessions: 2,
+            timeSpentMs: 18000,
+            topMethod: 'Visual AI',
+        });
+        (0, chai_1.expect)(hot.suggestion).to.deep.equal({ selector: selector_health_fixture_1.FIX.hot, strategy: 'xpath', share: 0.75 });
+        (0, chai_1.expect)(hot.state).to.include({ status: 'active', brokeAgain: 2 });
+        (0, chai_1.expect)(Date.now() - Date.parse(hot.lastHealedAt)).to.be.within(0.9 * selector_health_fixture_1.HOUR, 1.5 * selector_health_fixture_1.HOUR);
+    }));
+    it('lists a heal with no strategy under an empty one', () => __awaiter(this, void 0, void 0, function* () {
+        const legacy = (yield list(selector_health_fixture_1.ADMIN)).body.items.find((i) => i.selector === selector_health_fixture_1.SEL.legacy);
+        (0, chai_1.expect)(legacy).to.deep.include({ strategy: '', heals: 1 });
+    }));
+    it('shows a member only selectors healed in sessions they can see, and counts only those', () => __awaiter(this, void 0, void 0, function* () {
+        const res = yield list(selector_health_fixture_1.MEMBER_A);
+        (0, chai_1.expect)(names(res)).to.deep.equal([selector_health_fixture_1.SEL.hot, selector_health_fixture_1.SEL.warm, selector_health_fixture_1.SEL.legacy, selector_health_fixture_1.SEL.odd]);
+        (0, chai_1.expect)(res.body.counts).to.deep.equal({ fix: 4, verifying: 1, fixed: 1, muted: 1 });
+    }));
+    it('sorts by most recent and by most time spent healing', () => __awaiter(this, void 0, void 0, function* () {
+        (0, chai_1.expect)(names(yield list(selector_health_fixture_1.ADMIN, '?sort=recent'))).to.deep.equal([
+            selector_health_fixture_1.SEL.hot,
+            selector_health_fixture_1.SEL.legacy,
+            selector_health_fixture_1.SEL.odd,
+            selector_health_fixture_1.SEL.bOnly,
+            selector_health_fixture_1.SEL.warm,
+        ]);
+        (0, chai_1.expect)(names(yield list(selector_health_fixture_1.ADMIN, '?sort=time'))).to.deep.equal([
+            selector_health_fixture_1.SEL.warm,
+            selector_health_fixture_1.SEL.hot,
+            selector_health_fixture_1.SEL.bOnly,
+            selector_health_fixture_1.SEL.legacy,
+            selector_health_fixture_1.SEL.odd,
+        ]);
+    }));
+    it('searches the selector and its suggested fix, taking the text literally', () => __awaiter(this, void 0, void 0, function* () {
+        (0, chai_1.expect)(names(yield list(selector_health_fixture_1.ADMIN, '?q=CONFIRM'))).to.deep.equal([selector_health_fixture_1.SEL.hot]);
+        (0, chai_1.expect)(names(yield list(selector_health_fixture_1.ADMIN, `?q=${encodeURIComponent('cart_total_v2')}`))).to.deep.equal([
+            selector_health_fixture_1.SEL.warm,
+        ]);
+        (0, chai_1.expect)(names(yield list(selector_health_fixture_1.ADMIN, `?q=${encodeURIComponent('%')}`))).to.deep.equal([selector_health_fixture_1.SEL.odd]);
+    }));
+    it('filters what to fix by platform and by healing method, keeping the counts whole', () => __awaiter(this, void 0, void 0, function* () {
+        (0, chai_1.expect)(names(yield list(selector_health_fixture_1.ADMIN, '?platform=ios'))).to.deep.equal([selector_health_fixture_1.SEL.bOnly]);
+        const llm = yield list(selector_health_fixture_1.ADMIN, '?method=LLM');
+        (0, chai_1.expect)(names(llm)).to.deep.equal([selector_health_fixture_1.SEL.hot]);
+        (0, chai_1.expect)(llm.body.items[0]).to.deep.include({ heals: 1, topMethod: 'LLM' });
+        (0, chai_1.expect)(llm.body.counts.fix).to.equal(5);
+    }));
+    it('pages, and shows the last page for a page past the end', () => __awaiter(this, void 0, void 0, function* () {
+        (0, chai_1.expect)(names(yield list(selector_health_fixture_1.ADMIN, '?pageSize=2&page=2'))).to.deep.equal([selector_health_fixture_1.SEL.warm, selector_health_fixture_1.SEL.legacy]);
+        const past = yield list(selector_health_fixture_1.ADMIN, '?pageSize=2&page=99');
+        (0, chai_1.expect)(past.body.page).to.equal(3);
+        (0, chai_1.expect)(past.body.total).to.equal(5);
+        (0, chai_1.expect)(names(past)).to.deep.equal([selector_health_fixture_1.SEL.odd]);
+    }));
+    it('lists selectors being verified, with their progress and who marked them fixed', () => __awaiter(this, void 0, void 0, function* () {
+        const res = yield list(selector_health_fixture_1.MEMBER_A, '?tab=verifying');
+        (0, chai_1.expect)(names(res)).to.deep.equal([selector_health_fixture_1.SEL.pending]);
+        (0, chai_1.expect)(res.body.items[0].heals).to.equal(1);
+        (0, chai_1.expect)(res.body.items[0].state).to.deep.include({
+            status: 'pending',
+            cleanBuilds: 2,
+            fixedBy: { id: selector_health_fixture_1.USER.priya, name: 'Priya' },
+        });
+    }));
+    it('lists selectors fixed in the period, with or without a heal in it', () => __awaiter(this, void 0, void 0, function* () {
+        (0, chai_1.expect)(names(yield list(selector_health_fixture_1.ADMIN, '?tab=fixed'))).to.deep.equal([selector_health_fixture_1.SEL.fixed]);
+        (0, chai_1.expect)(names(yield list(selector_health_fixture_1.ADMIN, '?tab=fixed&days=90'))).to.deep.equal([selector_health_fixture_1.SEL.fixed, selector_health_fixture_1.SEL.fixedOld]);
+        const week = yield list(selector_health_fixture_1.ADMIN, '?tab=fixed&days=7');
+        (0, chai_1.expect)(names(week)).to.deep.equal([selector_health_fixture_1.SEL.fixed]);
+        (0, chai_1.expect)(week.body.items[0]).to.deep.include({
+            heals: 0,
+            sessions: 0,
+            lastHealedAt: null,
+            suggestion: null,
+        });
+    }));
+    it('names nobody for an action by a user who is gone', () => __awaiter(this, void 0, void 0, function* () {
+        const fixed = (yield list(selector_health_fixture_1.ADMIN, '?tab=fixed')).body.items[0];
+        (0, chai_1.expect)(fixed.state.fixedBy).to.deep.equal({ id: selector_health_fixture_1.USER.gone, name: null });
+    }));
+    it('lists muted selectors with who muted them and why, only those a member can see', () => __awaiter(this, void 0, void 0, function* () {
+        const res = yield list(selector_health_fixture_1.MEMBER_A, '?tab=muted');
+        (0, chai_1.expect)(names(res)).to.deep.equal([selector_health_fixture_1.SEL.muted]);
+        (0, chai_1.expect)(res.body.items[0].state).to.deep.include({
+            status: 'muted',
+            mutedBy: { id: selector_health_fixture_1.USER.priya, name: 'Priya' },
+            muteReason: 'Screen being redesigned',
+        });
+        (0, chai_1.expect)(names(yield list(selector_health_fixture_1.ADMIN, '?tab=muted'))).to.deep.equal([selector_health_fixture_1.SEL.muted, selector_health_fixture_1.SEL.mutedB]);
+    }));
+    it('searches a status tab by selector', () => __awaiter(this, void 0, void 0, function* () {
+        (0, chai_1.expect)(names(yield list(selector_health_fixture_1.ADMIN, '?tab=muted&q=team-b'))).to.deep.equal([selector_health_fixture_1.SEL.mutedB]);
+    }));
+    it('tells a caller without the sessions scope that they cannot act', () => __awaiter(this, void 0, void 0, function* () {
+        (0, chai_1.expect)((yield list(selector_health_fixture_1.READ_ONLY_A)).body.canAct).to.equal(false);
+    }));
+});

package/lib/test/unit/selector-state-service.spec.js

@@ -23,14 +23,18 @@ const SocketEvents_1 = require("../../src/enums/SocketEvents");
  * the resolved value explicitly.
  */
 function buildPrismaStub() {
-    return {
+    const stub = {
         selectorState: {
             findUnique: sinon_1.default.stub(),
             upsert: sinon_1.default.stub(),
             update: sinon_1.default.stub(),
             delete: sinon_1.default.stub(),
         },
+        selectorEvent: { create: sinon_1.default.stub().resolves({}) },
     };
+    // A transaction runs its callback against the same tables, as Prisma's does.
+    stub.$transaction = sinon_1.default.stub().callsFake((fn) => fn(stub));
+    return stub;
 }
 function buildSocketStub() {
     return {
@@ -410,4 +414,73 @@ describe('SelectorStateService', () => {
             (0, chai_1.expect)(result).to.equal(null);
         }));
     });
+    describe('what each change records', () => {
+        const ctx = { strategy: STRATEGY, selector: SELECTOR, apiKeyId: API_KEY_ID, userId: 'user-1' };
+        const recorded = () => prismaStub.selectorEvent.create.firstCall.args[0].data;
+        it('records who marked it fixed, in the same transaction as the status', () => __awaiter(void 0, void 0, void 0, function* () {
+            prismaStub.selectorState.findUnique.resolves(null);
+            prismaStub.selectorState.upsert.resolves(makeRow({ status: 'pending', fixed_at: new Date() }));
+            yield svc.markFixed(ctx);
+            (0, chai_1.expect)(prismaStub.$transaction.calledOnce).to.equal(true);
+            (0, chai_1.expect)(recorded()).to.deep.equal({
+                original_strategy: STRATEGY,
+                original_selector: SELECTOR,
+                action: 'marked_fixed',
+                user_id: 'user-1',
+                reason: null,
+            });
+            (0, chai_1.expect)(prismaStub.selectorEvent.create.calledAfter(prismaStub.selectorState.upsert)).to.equal(true);
+        }));
+        it('fails the change, and tells nobody, when its record cannot be written', () => __awaiter(void 0, void 0, void 0, function* () {
+            prismaStub.selectorState.findUnique.resolves(null);
+            prismaStub.selectorState.upsert.resolves(makeRow({ status: 'pending' }));
+            prismaStub.selectorEvent.create.rejects(new Error('disk full'));
+            let thrown;
+            try {
+                yield svc.markFixed(ctx);
+            }
+            catch (e) {
+                thrown = e;
+            }
+            (0, chai_1.expect)(thrown.message).to.equal('disk full');
+            (0, chai_1.expect)(socketStub.emitToDashboard.called).to.equal(false);
+        }));
+        it('records the mute with its reason', () => __awaiter(void 0, void 0, void 0, function* () {
+            prismaStub.selectorState.upsert.resolves(makeRow({ status: 'muted', muted_at: new Date() }));
+            yield svc.mute(Object.assign(Object.assign({}, ctx), { reason: 'Screen being redesigned' }));
+            (0, chai_1.expect)(recorded()).to.include({
+                action: 'muted',
+                user_id: 'user-1',
+                reason: 'Screen being redesigned',
+            });
+        }));
+        it('records an unmute, and nothing for a selector that is not muted', () => __awaiter(void 0, void 0, void 0, function* () {
+            prismaStub.selectorState.findUnique.resolves(makeRow({ status: 'muted', muted_at: new Date() }));
+            prismaStub.selectorState.delete.resolves(makeRow());
+            yield svc.unmute(ctx);
+            (0, chai_1.expect)(recorded()).to.include({ action: 'unmuted', user_id: 'user-1' });
+            prismaStub.selectorEvent.create.resetHistory();
+            prismaStub.selectorState.findUnique.resolves(makeRow({ status: 'active' }));
+            yield svc.unmute(ctx);
+            (0, chai_1.expect)(prismaStub.selectorEvent.create.called).to.equal(false);
+        }));
+        it('records a cancelled verification', () => __awaiter(void 0, void 0, void 0, function* () {
+            prismaStub.selectorState.findUnique.resolves(makeRow({ status: 'pending', fixed_at: new Date() }));
+            prismaStub.selectorState.delete.resolves(makeRow());
+            yield svc.cancelVerification(ctx);
+            (0, chai_1.expect)(recorded()).to.include({ action: 'verification_cancelled', user_id: 'user-1' });
+        }));
+        it('records a selector breaking again, with nobody as its person', () => __awaiter(void 0, void 0, void 0, function* () {
+            prismaStub.selectorState.findUnique.resolves(makeRow({ status: 'resolved', resolved_at: new Date() }));
+            prismaStub.selectorState.update.resolves(makeRow({ status: 'active', regression_count: 1 }));
+            yield svc.onHealRecorded({ strategy: STRATEGY, selector: SELECTOR, sessionId: SESSION_ID });
+            (0, chai_1.expect)(recorded()).to.include({ action: 'broke_again', user_id: null, reason: null });
+        }));
+        it('records nothing for a heal on a selector with no status', () => __awaiter(void 0, void 0, void 0, function* () {
+            prismaStub.selectorState.findUnique.resolves(null);
+            yield svc.onHealRecorded({ strategy: STRATEGY, selector: SELECTOR, sessionId: SESSION_ID });
+            (0, chai_1.expect)(prismaStub.$transaction.called).to.equal(false);
+            (0, chai_1.expect)(prismaStub.selectorEvent.create.called).to.equal(false);
+        }));
+    });
 });

package/lib/test/unit/selector-verification-job.spec.js

@@ -40,8 +40,12 @@ describe('SelectorVerificationJob.run', () => {
                 findMany: sinon_1.default.stub(),
                 update: sinon_1.default.stub().resolves({}),
             },
+            selectorEvent: { create: sinon_1.default.stub().resolves({}) },
             $queryRaw: sinon_1.default.stub(),
         };
+        prismaStub.$transaction = sinon_1.default
+            .stub()
+            .callsFake((fn) => fn(prismaStub));
         socketStub = { emitToDashboard: sinon_1.default.stub() };
         job = new SelectorVerificationJob_1.SelectorVerificationJob(prismaStub, socketStub);
     });
@@ -203,4 +207,38 @@ describe('SelectorVerificationJob.run', () => {
         yield job.run();
         (0, chai_1.expect)(prismaStub.$queryRaw.called).to.be.false;
     }));
+    it('records the verification, with nobody as its person', () => __awaiter(void 0, void 0, void 0, function* () {
+        prismaStub.selectorState.findMany.resolves([
+            {
+                id: 'r-1',
+                original_strategy: 'xpath',
+                original_selector: '//x',
+                status: 'pending',
+                fixed_at: new Date('2026-04-20T00:00:00Z'),
+                clean_builds_count: 2,
+            },
+        ]);
+        prismaStub.$queryRaw.resolves([
+            { build_id: 'b-1', healed: 0 },
+            { build_id: 'b-2', healed: 0 },
+            { build_id: 'b-3', healed: 0 },
+        ]);
+        prismaStub.selectorState.update.resolves({
+            id: 'r-1',
+            original_strategy: 'xpath',
+            original_selector: '//x',
+            status: 'resolved',
+            clean_builds_count: 3,
+            resolved_at: new Date(),
+        });
+        yield job.run();
+        (0, chai_1.expect)(prismaStub.selectorEvent.create.calledOnce).to.equal(true);
+        (0, chai_1.expect)(prismaStub.selectorEvent.create.firstCall.args[0].data).to.deep.equal({
+            original_strategy: 'xpath',
+            original_selector: '//x',
+            action: 'verified',
+            user_id: null,
+            reason: null,
+        });
+    }));
 });