crewly 1.20.193 → 1.20.195

package/dist/backend/backend/src/services/signal-digest/signal-digest-card.js

@@ -0,0 +1,187 @@
+/**
+ * The signal digest card (#987, specs/2026-10-03-signal-digest.md §3): one
+ * Slack message, one section per action with its own Do / Skip buttons.
+ * Pure: same digest, same blocks.
+ *
+ * ```
+ * [header]  Daily signals · visa.careerengine.us
+ * [context] Owen · Fri 10/2 · Do opens an experiment ticket · SD-3
+ * [context] Sources: GA4 ✓ · Search Console ✗ HTTP 403 · Inbox — not set up
+ * [section] *1. Rewrite the /h1b-fee title*
+ *           Signal: 'h1b visa fee' ranks #2 with 4% CTR on 900 impressions
+ *           Expected: about +70 clicks a week · Effort: S — 1 h
+ * [actions] [Do] [Skip]                 (or, once answered: ✔ Do → CE-12)
+ * …
+ * ```
+ *
+ * @module services/signal-digest/signal-digest-card
+ */
+import { SIGNAL_DIGEST_CONSTANTS } from '../../constants.js';
+import { isSignalChoice } from '../../types/signal-digest.types.js';
+const WEEKDAY_SHORT = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
+/**
+ * Escape the characters Slack reserves in mrkdwn.
+ *
+ * @param text - Plain text
+ * @returns Safe mrkdwn
+ */
+export function escapeMrkdwn(text) {
+    return text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+/**
+ * Button value JSON.
+ *
+ * @param digestId - Digest id
+ * @param n - Item number
+ * @param choice - do / skip
+ * @param instanceId - This instance (Cloud routes the click by it)
+ * @returns JSON string
+ */
+export function signalButtonValue(digestId, n, choice, instanceId) {
+    const v = { s: digestId, n, o: choice, i: instanceId };
+    return JSON.stringify(v);
+}
+/**
+ * Parse a digest button value.
+ *
+ * @param raw - `value` of the clicked button
+ * @returns The value, or null when it is not a digest button
+ */
+export function parseSignalButtonValue(raw) {
+    if (typeof raw !== 'string' || !raw.startsWith('{'))
+        return null;
+    try {
+        const v = JSON.parse(raw);
+        if (typeof v.s !== 'string' || typeof v.n !== 'number' || !Number.isInteger(v.n) || !isSignalChoice(v.o))
+            return null;
+        return { s: v.s, n: v.n, o: v.o, i: typeof v.i === 'string' ? v.i : '' };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The line an answered (or expired) action shows instead of its buttons.
+ *
+ * @param item - Item
+ * @returns mrkdwn line, or null while open
+ */
+export function itemOutcomeLine(item) {
+    switch (item.status) {
+        case 'do':
+            if (item.ticketId)
+                return `✔ Do → ${escapeMrkdwn(item.ticketId)}${item.experimentId ? ` · ${escapeMrkdwn(item.experimentId)}` : ''}`;
+            return `✔ Do — no ticket: ${escapeMrkdwn(item.ticketError ?? 'not created')}`;
+        case 'skip':
+            return '⤼ Skipped';
+        case 'expired':
+            return 'No answer — replaced by a newer digest';
+        default:
+            return null;
+    }
+}
+/**
+ * The card's source line: what the run could and could not examine.
+ *
+ * @param sources - Statuses
+ * @returns mrkdwn line, or null when there are none
+ */
+export function sourcesLine(sources) {
+    if (!sources || sources.length === 0)
+        return null;
+    const parts = sources.map((s) => {
+        const label = escapeMrkdwn(SIGNAL_DIGEST_CONSTANTS.SOURCE_LABELS[s.name] ?? s.name);
+        if (s.state === 'ok')
+            return `${label} ✓`;
+        if (s.state === 'not_configured')
+            return `${label} — not set up`;
+        return `${label} ✗ ${escapeMrkdwn((s.detail ?? 'failed').slice(0, 80))}`;
+    });
+    return `Sources: ${parts.join(' · ')}`;
+}
+/**
+ * `Fri 10/2` for an instant, in the machine's zone.
+ *
+ * @param iso - Instant
+ * @returns Date label
+ */
+function dateLabel(iso) {
+    const d = new Date(iso);
+    return `${WEEKDAY_SHORT[d.getDay()]} ${d.getMonth() + 1}/${d.getDate()}`;
+}
+/**
+ * The card's blocks.
+ *
+ * @param digest - Digest
+ * @param instanceId - This instance id (button values)
+ * @param askerName - Team lead's display name, when known
+ * @returns Blocks
+ */
+export function renderDigestCard(digest, instanceId, askerName) {
+    const blocks = [
+        { type: 'header', text: { type: 'plain_text', text: `Daily signals · ${digest.site}`.slice(0, 150), emoji: true } },
+        {
+            type: 'context',
+            elements: [
+                {
+                    type: 'mrkdwn',
+                    text: [askerName ? escapeMrkdwn(askerName) : null, dateLabel(digest.createdAt), 'Do opens an experiment ticket · Skip keeps it off the list for 30 days', digest.id]
+                        .filter(Boolean)
+                        .join(' · '),
+                },
+            ],
+        },
+    ];
+    const sources = sourcesLine(digest.sources);
+    if (sources)
+        blocks.push({ type: 'context', elements: [{ type: 'mrkdwn', text: sources }] });
+    for (const item of digest.items) {
+        blocks.push({
+            type: 'section',
+            text: {
+                type: 'mrkdwn',
+                text: [
+                    `*${item.n}. ${escapeMrkdwn(item.proposal)}*`,
+                    `Signal: ${escapeMrkdwn(item.signal)}`,
+                    `Expected: ${escapeMrkdwn(item.expectedEffect)} · Effort: ${escapeMrkdwn(item.effort)}`,
+                ].join('\n'),
+            },
+        });
+        const outcome = itemOutcomeLine(item);
+        if (outcome) {
+            blocks.push({ type: 'context', elements: [{ type: 'mrkdwn', text: outcome }] });
+            continue;
+        }
+        blocks.push({
+            type: 'actions',
+            block_id: `signal:${digest.id}:${item.n}`,
+            elements: [
+                {
+                    type: 'button',
+                    action_id: `${SIGNAL_DIGEST_CONSTANTS.ACTION_PREFIX}${item.n}:do`,
+                    text: { type: 'plain_text', text: 'Do', emoji: true },
+                    style: 'primary',
+                    value: signalButtonValue(digest.id, item.n, 'do', instanceId),
+                },
+                {
+                    type: 'button',
+                    action_id: `${SIGNAL_DIGEST_CONSTANTS.ACTION_PREFIX}${item.n}:skip`,
+                    text: { type: 'plain_text', text: 'Skip', emoji: true },
+                    value: signalButtonValue(digest.id, item.n, 'skip', instanceId),
+                },
+            ],
+        });
+    }
+    return blocks;
+}
+/**
+ * Notification text of the card (shown in the push / when blocks fail).
+ *
+ * @param digest - Digest
+ * @returns Plain text
+ */
+export function digestFallbackText(digest) {
+    const open = digest.items.filter((i) => i.status === 'open').length;
+    return `Daily signals · ${digest.site}: ${digest.items.length} actions${open < digest.items.length ? ` (${open} waiting)` : ''}`;
+}
+//# sourceMappingURL=signal-digest-card.js.map

package/dist/backend/backend/src/services/signal-digest/signal-digest-card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-digest-card.js","sourceRoot":"","sources":["../../../../../../backend/src/services/signal-digest/signal-digest-card.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAG7D,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEpE,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAExE;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACjF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,CAAS,EAAE,MAAoB,EAAE,UAAkB;IACrG,MAAM,CAAC,GAAsB,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC;IAC1E,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAY;IACjD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACjE,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA+B,CAAC;QACxD,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QACtH,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,IAAsB;IACpD,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;QACpB,KAAK,IAAI;YACP,IAAI,IAAI,CAAC,QAAQ;gBAAE,OAAO,UAAU,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YACrI,OAAO,qBAAqB,YAAY,CAAC,IAAI,CAAC,WAAW,IAAI,aAAa,CAAC,EAAE,CAAC;QAChF,KAAK,MAAM;YACT,OAAO,WAAW,CAAC;QACrB,KAAK,SAAS;YACZ,OAAO,wCAAwC,CAAC;QAClD;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,OAAkD;IAC5E,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAClD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC9B,MAAM,KAAK,GAAG,YAAY,CAAC,uBAAuB,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QACpF,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI;YAAE,OAAO,GAAG,KAAK,IAAI,CAAC;QAC1C,IAAI,CAAC,CAAC,KAAK,KAAK,gBAAgB;YAAE,OAAO,GAAG,KAAK,eAAe,CAAC;QACjE,OAAO,GAAG,KAAK,MAAM,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;IAC3E,CAAC,CAAC,CAAC;IACH,OAAO,YAAY,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,SAAS,SAAS,CAAC,GAAW;IAC5B,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,OAAO,GAAG,aAAa,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;AAC3E,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAoB,EAAE,UAAkB,EAAE,SAAkB;IAC3F,MAAM,MAAM,GAAmC;QAC7C,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,mBAAmB,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACnH;YACE,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,wEAAwE,EAAE,MAAM,CAAC,EAAE,CAAC;yBACjK,MAAM,CAAC,OAAO,CAAC;yBACf,IAAI,CAAC,KAAK,CAAC;iBACf;aACF;SACF;KACF,CAAC;IACF,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,OAAO;QAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IAC7F,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,SAAS;YACf,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE;oBACJ,IAAI,IAAI,CAAC,CAAC,KAAK,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG;oBAC7C,WAAW,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;oBACtC,aAAa,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,cAAc,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;iBACxF,CAAC,IAAI,CAAC,IAAI,CAAC;aACb;SACF,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;YAChF,SAAS;QACX,CAAC;QACD,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,UAAU,MAAM,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC,EAAE;YACzC,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,QAAQ;oBACd,SAAS,EAAE,GAAG,uBAAuB,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC,KAAK;oBACjE,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;oBACrD,KAAK,EAAE,SAAS;oBAChB,KAAK,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC;iBAC9D;gBACD;oBACE,IAAI,EAAE,QAAQ;oBACd,SAAS,EAAE,GAAG,uBAAuB,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC,OAAO;oBACnE,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE;oBACvD,KAAK,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC;iBAChE;aACF;SACF,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAiC,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAoB;IACrD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;IACpE,OAAO,mBAAmB,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,MAAM,WAAW,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACnI,CAAC"}

package/dist/backend/backend/src/services/signal-digest/signal-digest-contract.d.ts

@@ -0,0 +1,86 @@
+/**
+ * The signal digest contract (#987, specs/2026-10-03-signal-digest.md §2):
+ * validate a team lead's proposal and work out which actions the site's
+ * history blocks. Pure.
+ *
+ * Every rejection says what to fix, because the reader is an agent that will
+ * retry with whatever the error tells it.
+ *
+ * @module services/signal-digest/signal-digest-contract
+ */
+import type { CreateSignalDigestInput, SignalActionInput, SignalDigest, SignalHistoryEntry, SignalSourceStatus } from '../../types/signal-digest.types.js';
+/** A rejected proposal. */
+export declare class SignalDigestError extends Error {
+    readonly status: number;
+    /**
+     * @param status - HTTP status to answer with
+     * @param message - What to fix
+     */
+    constructor(status: number, message: string);
+}
+/** Appended to contract errors. */
+export declare const SIGNAL_DIGEST_EXAMPLE = "Example item: {\"key\":\"gsc:low-ctr:h1b visa fee\",\"source\":\"gsc\",\"signal\":\"'h1b visa fee' ranks #2 with 4% CTR on 900 impressions (7 d)\",\"proposal\":\"Rewrite the title and description of /h1b-fee to answer the fee question\",\"expectedEffect\":\"CTR 4% \u2192 ~12%: about +70 clicks a week\",\"effort\":\"S \u2014 1 h\",\"metric\":\"GSC clicks for 'h1b visa fee'\"}";
+/** A validated proposal. */
+export interface ValidatedSignalDigest {
+    site: string;
+    project?: string;
+    config?: string;
+    items: SignalActionInput[];
+    /** Source statuses, when the proposal carries them */
+    sources?: SignalSourceStatus[];
+}
+/**
+ * Normalised identity of an action key (case and spacing do not matter).
+ *
+ * @param key - Key as sent
+ * @returns Comparable key
+ */
+export declare function normalizeKey(key: string): string;
+/**
+ * Source statuses as `collect` prints them (`{"ga4":"ok","gsc":"error: HTTP 403"}`)
+ * or as a list of `{name, state, detail?}`.
+ *
+ * @param raw - Body field
+ * @returns Statuses (sorted by name), or undefined when absent
+ * @throws SignalDigestError(400)
+ */
+export declare function parseSourceStatuses(raw: unknown): SignalSourceStatus[] | undefined;
+/**
+ * Validate a proposal: a site, an optional project, and 3–5 distinct actions,
+ * each with key, source, signal, proposal, expected effect and effort.
+ *
+ * @param input - Request body
+ * @returns The proposal
+ * @throws SignalDigestError(400) naming what to fix
+ */
+export declare function validateSignalDigest(input: CreateSignalDigestInput): ValidatedSignalDigest;
+/**
+ * Validate a site name.
+ *
+ * @param raw - Body field
+ * @returns The site
+ * @throws SignalDigestError(400)
+ */
+export declare function validateSite(raw: unknown): string;
+/**
+ * The keys a site's history blocks right now, newest first per key:
+ * - a Do blocks its key for {@link SIGNAL_DIGEST_CONSTANTS.DO_BLOCK_MS} (it was tried);
+ * - a Skip blocks it for {@link SIGNAL_DIGEST_CONSTANTS.SKIP_BLOCK_MS};
+ * - an open item blocks it while it is open.
+ * Expired items (replaced unanswered) block nothing.
+ *
+ * @param digests - All stored digests
+ * @param site - Site
+ * @param now - Clock
+ * @returns Blocked entries, one per key
+ */
+export declare function siteHistory(digests: readonly SignalDigest[], site: string, now: Date): SignalHistoryEntry[];
+/**
+ * Explain which proposed actions the history blocks.
+ *
+ * @param items - Proposed actions
+ * @param history - {@link siteHistory} of the site
+ * @returns One line per blocked action (empty when none)
+ */
+export declare function blockedLines(items: readonly SignalActionInput[], history: readonly SignalHistoryEntry[]): string[];
+//# sourceMappingURL=signal-digest-contract.d.ts.map

package/dist/backend/backend/src/services/signal-digest/signal-digest-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-digest-contract.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/signal-digest/signal-digest-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EACV,uBAAuB,EACvB,iBAAiB,EACjB,YAAY,EAEZ,kBAAkB,EAGlB,kBAAkB,EACnB,MAAM,oCAAoC,CAAC;AAE5C,2BAA2B;AAC3B,qBAAa,iBAAkB,SAAQ,KAAK;IAMxC,QAAQ,CAAC,MAAM,EAAE,MAAM;IALzB;;;OAGG;gBAEQ,MAAM,EAAE,MAAM,EACvB,OAAO,EAAE,MAAM;CAKlB;AAED,mCAAmC;AACnC,eAAO,MAAM,qBAAqB,8XACyT,CAAC;AAE5V,4BAA4B;AAC5B,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,sDAAsD;IACtD,OAAO,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAChC;AAYD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAmFD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,EAAE,GAAG,SAAS,CAelF;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,uBAAuB,GAAG,qBAAqB,CA4C1F;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAKjD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,kBAAkB,EAAE,CA6B3G;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,EAAE,OAAO,EAAE,SAAS,kBAAkB,EAAE,GAAG,MAAM,EAAE,CAYlH"}

package/dist/backend/backend/src/services/signal-digest/signal-digest-contract.js

@@ -0,0 +1,307 @@
+/**
+ * The signal digest contract (#987, specs/2026-10-03-signal-digest.md §2):
+ * validate a team lead's proposal and work out which actions the site's
+ * history blocks. Pure.
+ *
+ * Every rejection says what to fix, because the reader is an agent that will
+ * retry with whatever the error tells it.
+ *
+ * @module services/signal-digest/signal-digest-contract
+ */
+import { SIGNAL_DIGEST_CONSTANTS } from '../../constants.js';
+import * as path from 'path';
+/** A rejected proposal. */
+export class SignalDigestError extends Error {
+    status;
+    /**
+     * @param status - HTTP status to answer with
+     * @param message - What to fix
+     */
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+        this.name = 'SignalDigestError';
+    }
+}
+/** Appended to contract errors. */
+export const SIGNAL_DIGEST_EXAMPLE = 'Example item: {"key":"gsc:low-ctr:h1b visa fee","source":"gsc","signal":"\'h1b visa fee\' ranks #2 with 4% CTR on 900 impressions (7 d)","proposal":"Rewrite the title and description of /h1b-fee to answer the fee question","expectedEffect":"CTR 4% → ~12%: about +70 clicks a week","effort":"S — 1 h","metric":"GSC clicks for \'h1b visa fee\'"}';
+/**
+ * Collapse whitespace.
+ *
+ * @param s - Text
+ * @returns One trimmed line
+ */
+function oneLine(s) {
+    return s.replace(/\s+/g, ' ').trim();
+}
+/**
+ * Normalised identity of an action key (case and spacing do not matter).
+ *
+ * @param key - Key as sent
+ * @returns Comparable key
+ */
+export function normalizeKey(key) {
+    return oneLine(key).toLowerCase();
+}
+/**
+ * A required one-line text field.
+ *
+ * @param item - Raw item
+ * @param field - Field name
+ * @param max - Max characters
+ * @param n - Item number (for the error)
+ * @returns The text
+ * @throws SignalDigestError(400)
+ */
+function textField(item, field, max, n) {
+    const raw = item[field];
+    const text = typeof raw === 'string' ? oneLine(raw) : '';
+    if (!text)
+        throw new SignalDigestError(400, `item ${n}: "${field}" is required. ${SIGNAL_DIGEST_EXAMPLE}`);
+    if (text.length > max)
+        throw new SignalDigestError(400, `item ${n}: "${field}" is too long (max ${max} characters, got ${text.length}). Say it shorter.`);
+    return text;
+}
+/** Experiment spec fields kept (strings). */
+const EXPERIMENT_TEXT_FIELDS = ['page', 'query', 'event', 'channel'];
+/**
+ * An action's optional experiment spec. Only the shape is checked here; the
+ * experiment service validates the measure and filters when a Do creates it.
+ *
+ * @param raw - `experiment` as sent
+ * @param n - Item number (for the error)
+ * @returns Spec, or undefined when absent
+ * @throws SignalDigestError(400)
+ */
+function experimentSpec(raw, n) {
+    if (raw === undefined || raw === null)
+        return undefined;
+    if (typeof raw !== 'object')
+        throw new SignalDigestError(400, `item ${n}: "experiment" must be an object like {"source":"gsc","measure":"clicks","query":"…"}.`);
+    const e = raw;
+    if (e.source !== 'gsc' && e.source !== 'ga4')
+        throw new SignalDigestError(400, `item ${n}: experiment.source must be gsc or ga4.`);
+    const measure = typeof e.measure === 'string' ? e.measure.trim() : '';
+    if (!measure)
+        throw new SignalDigestError(400, `item ${n}: experiment.measure is required (gsc: clicks / impressions / ctr / position; ga4: sessions / events).`);
+    const spec = { source: e.source, measure };
+    for (const f of EXPERIMENT_TEXT_FIELDS) {
+        const v = typeof e[f] === 'string' ? oneLine(e[f]) : '';
+        if (v)
+            spec[f] = v.slice(0, SIGNAL_DIGEST_CONSTANTS.METRIC_MAX_CHARS);
+    }
+    return spec;
+}
+/**
+ * One source status from `collect`'s wording: `ok`, `not configured`, or
+ * `error: <why>`.
+ *
+ * @param name - Source name
+ * @param raw - Status text, or `{state, detail}`
+ * @returns The status
+ * @throws SignalDigestError(400)
+ */
+function sourceStatus(name, raw) {
+    const C = SIGNAL_DIGEST_CONSTANTS;
+    const n = oneLine(name).toLowerCase().slice(0, C.SOURCE_NAME_MAX_CHARS);
+    if (!n)
+        throw new SignalDigestError(400, 'every source needs a name (ga4, gsc, inbox, errors).');
+    let state;
+    let detail = '';
+    if (raw && typeof raw === 'object') {
+        const o = raw;
+        const s = typeof o.state === 'string' ? o.state.trim().toLowerCase().replace(/\s+/g, '_') : '';
+        if (s !== 'ok' && s !== 'not_configured' && s !== 'error')
+            throw new SignalDigestError(400, `source ${n}: "state" must be ok, not_configured or error.`);
+        state = s;
+        detail = typeof o.detail === 'string' ? oneLine(o.detail) : '';
+    }
+    else if (typeof raw === 'string') {
+        const text = oneLine(raw);
+        const lower = text.toLowerCase();
+        if (lower === 'ok')
+            state = 'ok';
+        else if (lower === 'not configured' || lower === 'not_configured')
+            state = 'not_configured';
+        else if (lower.startsWith('error')) {
+            state = 'error';
+            detail = text.replace(/^error:?\s*/i, '');
+        }
+        else
+            throw new SignalDigestError(400, `source ${n}: status must be "ok", "not configured" or "error: why" (got "${text.slice(0, 40)}").`);
+    }
+    else {
+        throw new SignalDigestError(400, `source ${n}: status must be "ok", "not configured" or "error: why".`);
+    }
+    return { name: n, state, ...(state === 'error' ? { detail: (detail || 'failed').slice(0, C.SOURCE_DETAIL_MAX_CHARS) } : {}) };
+}
+/**
+ * Source statuses as `collect` prints them (`{"ga4":"ok","gsc":"error: HTTP 403"}`)
+ * or as a list of `{name, state, detail?}`.
+ *
+ * @param raw - Body field
+ * @returns Statuses (sorted by name), or undefined when absent
+ * @throws SignalDigestError(400)
+ */
+export function parseSourceStatuses(raw) {
+    if (raw === undefined || raw === null)
+        return undefined;
+    const entries = Array.isArray(raw)
+        ? raw.map((x) => [typeof x?.name === 'string' ? x.name : '', x])
+        : typeof raw === 'object'
+            ? Object.entries(raw)
+            : [];
+    if (!Array.isArray(raw) && typeof raw !== 'object')
+        throw new SignalDigestError(400, '"sources" must be an object like {"ga4":"ok","gsc":"error: why"}.');
+    if (entries.length > SIGNAL_DIGEST_CONSTANTS.MAX_SOURCES)
+        throw new SignalDigestError(400, `"sources" lists too many sources (max ${SIGNAL_DIGEST_CONSTANTS.MAX_SOURCES}).`);
+    const out = new Map();
+    for (const [name, value] of entries) {
+        const st = sourceStatus(name, value);
+        out.set(st.name, st);
+    }
+    return [...out.values()].sort((a, b) => a.name.localeCompare(b.name));
+}
+/**
+ * Validate a proposal: a site, an optional project, and 3–5 distinct actions,
+ * each with key, source, signal, proposal, expected effect and effort.
+ *
+ * @param input - Request body
+ * @returns The proposal
+ * @throws SignalDigestError(400) naming what to fix
+ */
+export function validateSignalDigest(input) {
+    const site = typeof input.site === 'string' ? oneLine(input.site) : '';
+    if (!site)
+        throw new SignalDigestError(400, '"site" is required (e.g. "visa.careerengine.us").');
+    if (site.length > SIGNAL_DIGEST_CONSTANTS.SITE_MAX_CHARS)
+        throw new SignalDigestError(400, `"site" is too long (max ${SIGNAL_DIGEST_CONSTANTS.SITE_MAX_CHARS} characters).`);
+    const project = typeof input.project === 'string' && oneLine(input.project) ? oneLine(input.project) : undefined;
+    const config = typeof input.config === 'string' && input.config.trim() ? input.config.trim() : undefined;
+    if (config && !path.isAbsolute(config))
+        throw new SignalDigestError(400, '"config" must be the absolute path of the seo-ops site config.');
+    const raw = input.items;
+    const { MIN_ITEMS, MAX_ITEMS } = SIGNAL_DIGEST_CONSTANTS;
+    if (!Array.isArray(raw) || raw.length < MIN_ITEMS || raw.length > MAX_ITEMS) {
+        const got = Array.isArray(raw) ? raw.length : 0;
+        throw new SignalDigestError(400, `give ${MIN_ITEMS}–${MAX_ITEMS} actions (got ${got}): pick the ones worth the owner's tap, ranked best first. ${SIGNAL_DIGEST_EXAMPLE}`);
+    }
+    const seen = new Set();
+    const items = raw.map((value, i) => {
+        const n = i + 1;
+        if (!value || typeof value !== 'object')
+            throw new SignalDigestError(400, `item ${n} must be an object. ${SIGNAL_DIGEST_EXAMPLE}`);
+        const item = value;
+        const key = textField(item, 'key', SIGNAL_DIGEST_CONSTANTS.KEY_MAX_CHARS, n);
+        const source = typeof item.source === 'string' ? item.source.trim().toLowerCase() : '';
+        if (!SIGNAL_DIGEST_CONSTANTS.SOURCES.includes(source)) {
+            throw new SignalDigestError(400, `item ${n}: "source" must be one of ${SIGNAL_DIGEST_CONSTANTS.SOURCES.join(', ')}.`);
+        }
+        const norm = normalizeKey(key);
+        if (seen.has(norm))
+            throw new SignalDigestError(400, `item ${n}: key "${key}" is used twice; each action needs its own key.`);
+        seen.add(norm);
+        const metricRaw = typeof item.metric === 'string' ? oneLine(item.metric) : '';
+        if (metricRaw.length > SIGNAL_DIGEST_CONSTANTS.METRIC_MAX_CHARS) {
+            throw new SignalDigestError(400, `item ${n}: "metric" is too long (max ${SIGNAL_DIGEST_CONSTANTS.METRIC_MAX_CHARS} characters).`);
+        }
+        const experiment = experimentSpec(item.experiment, n);
+        return {
+            key,
+            source: source,
+            signal: textField(item, 'signal', SIGNAL_DIGEST_CONSTANTS.SIGNAL_MAX_CHARS, n),
+            proposal: textField(item, 'proposal', SIGNAL_DIGEST_CONSTANTS.PROPOSAL_MAX_CHARS, n),
+            expectedEffect: textField(item, 'expectedEffect', SIGNAL_DIGEST_CONSTANTS.EXPECTED_MAX_CHARS, n),
+            effort: textField(item, 'effort', SIGNAL_DIGEST_CONSTANTS.EFFORT_MAX_CHARS, n),
+            ...(metricRaw ? { metric: metricRaw } : {}),
+            ...(experiment ? { experiment } : {}),
+        };
+    });
+    const sources = parseSourceStatuses(input.sources);
+    return { site, ...(project ? { project } : {}), ...(config ? { config } : {}), items, ...(sources ? { sources } : {}) };
+}
+/**
+ * Validate a site name.
+ *
+ * @param raw - Body field
+ * @returns The site
+ * @throws SignalDigestError(400)
+ */
+export function validateSite(raw) {
+    const site = typeof raw === 'string' ? oneLine(raw) : '';
+    if (!site)
+        throw new SignalDigestError(400, '"site" is required (e.g. "visa.careerengine.us").');
+    if (site.length > SIGNAL_DIGEST_CONSTANTS.SITE_MAX_CHARS)
+        throw new SignalDigestError(400, `"site" is too long (max ${SIGNAL_DIGEST_CONSTANTS.SITE_MAX_CHARS} characters).`);
+    return site;
+}
+/**
+ * The keys a site's history blocks right now, newest first per key:
+ * - a Do blocks its key for {@link SIGNAL_DIGEST_CONSTANTS.DO_BLOCK_MS} (it was tried);
+ * - a Skip blocks it for {@link SIGNAL_DIGEST_CONSTANTS.SKIP_BLOCK_MS};
+ * - an open item blocks it while it is open.
+ * Expired items (replaced unanswered) block nothing.
+ *
+ * @param digests - All stored digests
+ * @param site - Site
+ * @param now - Clock
+ * @returns Blocked entries, one per key
+ */
+export function siteHistory(digests, site, now) {
+    const want = site.trim().toLowerCase();
+    const byKey = new Map();
+    const ordered = [...digests].filter((d) => d.site.trim().toLowerCase() === want).sort((a, b) => Date.parse(b.createdAt) - Date.parse(a.createdAt));
+    for (const d of ordered) {
+        for (const item of d.items) {
+            const norm = normalizeKey(item.key);
+            if (byKey.has(norm))
+                continue;
+            if (item.status === 'open') {
+                byKey.set(norm, { key: item.key, status: 'open', at: d.createdAt, proposal: item.proposal, digestId: d.id });
+                continue;
+            }
+            if (item.status !== 'do' && item.status !== 'skip')
+                continue;
+            const at = item.answeredAt ?? d.updatedAt;
+            const span = item.status === 'do' ? SIGNAL_DIGEST_CONSTANTS.DO_BLOCK_MS : SIGNAL_DIGEST_CONSTANTS.SKIP_BLOCK_MS;
+            const until = Date.parse(at) + span;
+            if (until <= now.getTime())
+                continue;
+            byKey.set(norm, {
+                key: item.key,
+                status: item.status,
+                at,
+                proposal: item.proposal,
+                digestId: d.id,
+                ...(item.ticketId ? { ticketId: item.ticketId } : {}),
+                blockedUntil: new Date(until).toISOString(),
+            });
+        }
+    }
+    return [...byKey.values()];
+}
+/**
+ * Explain which proposed actions the history blocks.
+ *
+ * @param items - Proposed actions
+ * @param history - {@link siteHistory} of the site
+ * @returns One line per blocked action (empty when none)
+ */
+export function blockedLines(items, history) {
+    const byKey = new Map(history.map((h) => [normalizeKey(h.key), h]));
+    const lines = [];
+    for (const item of items) {
+        const h = byKey.get(normalizeKey(item.key));
+        if (!h)
+            continue;
+        const when = h.at.slice(0, 10);
+        if (h.status === 'do')
+            lines.push(`"${item.key}": the owner chose Do on ${when} (${h.digestId}${h.ticketId ? `, ${h.ticketId}` : ''}) — it is being tried`);
+        else if (h.status === 'skip')
+            lines.push(`"${item.key}": the owner skipped it on ${when} (${h.digestId}); not before ${h.blockedUntil?.slice(0, 10)}`);
+        else
+            lines.push(`"${item.key}": still waiting on the owner in ${h.digestId}`);
+    }
+    return lines;
+}
+//# sourceMappingURL=signal-digest-contract.js.map

package/dist/backend/backend/src/services/signal-digest/signal-digest-contract.js.map

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