crewly 1.20.194 → 1.20.195

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

@@ -0,0 +1,85 @@
+/**
+ * Durable store of signal digests (#987, specs/2026-10-03-signal-digest.md).
+ *
+ * One JSON file under CREWLY_HOME with a monotonically increasing id counter,
+ * so `SD-3` is never reused. All writes are serialised and atomic. Digests
+ * untouched for {@link SIGNAL_DIGEST_CONSTANTS.KEEP_MS} are pruned.
+ *
+ * @module services/signal-digest/signal-digest-store
+ */
+import type { SignalDigest, SignalSiteSources } from '../../types/signal-digest.types.js';
+/**
+ * Persistent digest store.
+ */
+export declare class SignalDigestStore {
+    private readonly filePath;
+    private readonly now;
+    private data;
+    private chain;
+    /**
+     * @param filePath - JSON file
+     * @param now - Clock (tests)
+     */
+    constructor(filePath: string, now?: () => Date);
+    /**
+     * Store under a CREWLY_HOME.
+     *
+     * @param crewlyHome - CREWLY_HOME
+     * @returns The store
+     */
+    static inHome(crewlyHome: string): SignalDigestStore;
+    /**
+     * Add a digest, assigning its id.
+     *
+     * @param draft - Digest without id/timestamps
+     * @returns The stored digest
+     */
+    create(draft: Omit<SignalDigest, 'id' | 'createdAt' | 'updatedAt'>): Promise<SignalDigest>;
+    /**
+     * Change a digest under the write lock.
+     *
+     * @param id - Digest id
+     * @param fn - Gets a copy; returns the new digest, or null to leave it alone
+     * @returns The updated digest, or null when missing / unchanged
+     */
+    update(id: string, fn: (d: SignalDigest) => SignalDigest | null): Promise<SignalDigest | null>;
+    /**
+     * One digest.
+     *
+     * @param id - Digest id
+     * @returns Copy, or null
+     */
+    get(id: string): Promise<SignalDigest | null>;
+    /**
+     * All digests, newest first, optionally filtered.
+     *
+     * @param filter - Predicate
+     * @returns Copies
+     */
+    list(filter?: (d: SignalDigest) => boolean): Promise<SignalDigest[]>;
+    /**
+     * A site's latest source report.
+     *
+     * @param site - Site
+     * @returns Copy, or null when none was reported
+     */
+    getSiteSources(site: string): Promise<SignalSiteSources | null>;
+    /**
+     * Change a site's source report under the write lock.
+     *
+     * @param site - Site
+     * @param fn - Gets a copy (null when none); returns the new report
+     * @returns The stored report
+     */
+    updateSiteSources(site: string, fn: (cur: SignalSiteSources | null) => SignalSiteSources): Promise<SignalSiteSources>;
+    /**
+     * Drop digests with nothing open that were last changed before the keep window.
+     *
+     * @returns How many were dropped
+     */
+    prune(): Promise<number>;
+    private load;
+    private save;
+    private serial;
+}
+//# sourceMappingURL=signal-digest-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signal-digest-store.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/signal-digest/signal-digest-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AA8B1F;;GAEG;AACH,qBAAa,iBAAiB;IAS1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG;IATtB,OAAO,CAAC,IAAI,CAA2B;IACvC,OAAO,CAAC,KAAK,CAAuC;IAEpD;;;OAGG;gBAEgB,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,MAAM,IAAuB;IAGrD;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB;IAIpD;;;;;OAKG;IACG,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IAYhG;;;;;;OAMG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,YAAY,GAAG,IAAI,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAcpG;;;;;OAKG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAMnD;;;;;OAKG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAQ1E;;;;;OAKG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAMrE;;;;;;OAMG;IACG,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI,KAAK,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAY3H;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;YAYhB,IAAI;YAUJ,IAAI;IAIlB,OAAO,CAAC,MAAM;CAKf"}

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

@@ -0,0 +1,185 @@
+/**
+ * Durable store of signal digests (#987, specs/2026-10-03-signal-digest.md).
+ *
+ * One JSON file under CREWLY_HOME with a monotonically increasing id counter,
+ * so `SD-3` is never reused. All writes are serialised and atomic. Digests
+ * untouched for {@link SIGNAL_DIGEST_CONSTANTS.KEEP_MS} are pruned.
+ *
+ * @module services/signal-digest/signal-digest-store
+ */
+import * as path from 'path';
+import { SIGNAL_DIGEST_CONSTANTS } from '../../constants.js';
+import { atomicWriteJson, safeReadJson } from '../../utils/file-io.utils.js';
+/**
+ * Store key of a site.
+ *
+ * @param site - Site
+ * @returns Lower-cased, trimmed
+ */
+function siteKey(site) {
+    return site.trim().toLowerCase();
+}
+/**
+ * Deep copy (digests hold nested item arrays).
+ *
+ * @param d - Digest
+ * @returns Independent copy
+ */
+function copy(d) {
+    return JSON.parse(JSON.stringify(d));
+}
+/**
+ * Persistent digest store.
+ */
+export class SignalDigestStore {
+    filePath;
+    now;
+    data = null;
+    chain = Promise.resolve();
+    /**
+     * @param filePath - JSON file
+     * @param now - Clock (tests)
+     */
+    constructor(filePath, now = () => new Date()) {
+        this.filePath = filePath;
+        this.now = now;
+    }
+    /**
+     * Store under a CREWLY_HOME.
+     *
+     * @param crewlyHome - CREWLY_HOME
+     * @returns The store
+     */
+    static inHome(crewlyHome) {
+        return new SignalDigestStore(path.join(crewlyHome, SIGNAL_DIGEST_CONSTANTS.STORE_FILENAME));
+    }
+    /**
+     * Add a digest, assigning its id.
+     *
+     * @param draft - Digest without id/timestamps
+     * @returns The stored digest
+     */
+    async create(draft) {
+        return this.serial(async () => {
+            const data = await this.load();
+            const at = this.now().toISOString();
+            const digest = { ...copy(draft), id: `${SIGNAL_DIGEST_CONSTANTS.ID_PREFIX}${data.nextId}`, createdAt: at, updatedAt: at };
+            data.nextId += 1;
+            data.digests.push(digest);
+            await this.save();
+            return copy(digest);
+        });
+    }
+    /**
+     * Change a digest under the write lock.
+     *
+     * @param id - Digest id
+     * @param fn - Gets a copy; returns the new digest, or null to leave it alone
+     * @returns The updated digest, or null when missing / unchanged
+     */
+    async update(id, fn) {
+        return this.serial(async () => {
+            const data = await this.load();
+            const idx = data.digests.findIndex((d) => d.id === id);
+            if (idx < 0)
+                return null;
+            const next = fn(copy(data.digests[idx]));
+            if (!next)
+                return null;
+            const stored = { ...next, id, updatedAt: this.now().toISOString() };
+            data.digests[idx] = stored;
+            await this.save();
+            return copy(stored);
+        });
+    }
+    /**
+     * One digest.
+     *
+     * @param id - Digest id
+     * @returns Copy, or null
+     */
+    async get(id) {
+        const data = await this.load();
+        const d = data.digests.find((x) => x.id === id);
+        return d ? copy(d) : null;
+    }
+    /**
+     * All digests, newest first, optionally filtered.
+     *
+     * @param filter - Predicate
+     * @returns Copies
+     */
+    async list(filter) {
+        const data = await this.load();
+        return data.digests
+            .filter((d) => !filter || filter(d))
+            .map(copy)
+            .sort((a, b) => Date.parse(b.createdAt) - Date.parse(a.createdAt) || b.id.localeCompare(a.id, undefined, { numeric: true }));
+    }
+    /**
+     * A site's latest source report.
+     *
+     * @param site - Site
+     * @returns Copy, or null when none was reported
+     */
+    async getSiteSources(site) {
+        const data = await this.load();
+        const s = data.siteSources[siteKey(site)];
+        return s ? JSON.parse(JSON.stringify(s)) : null;
+    }
+    /**
+     * Change a site's source report under the write lock.
+     *
+     * @param site - Site
+     * @param fn - Gets a copy (null when none); returns the new report
+     * @returns The stored report
+     */
+    async updateSiteSources(site, fn) {
+        return this.serial(async () => {
+            const data = await this.load();
+            const key = siteKey(site);
+            const cur = data.siteSources[key];
+            const next = fn(cur ? JSON.parse(JSON.stringify(cur)) : null);
+            data.siteSources[key] = next;
+            await this.save();
+            return JSON.parse(JSON.stringify(next));
+        });
+    }
+    /**
+     * Drop digests with nothing open that were last changed before the keep window.
+     *
+     * @returns How many were dropped
+     */
+    async prune() {
+        return this.serial(async () => {
+            const data = await this.load();
+            const cutoff = this.now().getTime() - SIGNAL_DIGEST_CONSTANTS.KEEP_MS;
+            const before = data.digests.length;
+            data.digests = data.digests.filter((d) => d.items.some((i) => i.status === 'open') || Date.parse(d.updatedAt) >= cutoff);
+            const dropped = before - data.digests.length;
+            if (dropped > 0)
+                await this.save();
+            return dropped;
+        });
+    }
+    async load() {
+        if (this.data)
+            return this.data;
+        const raw = await safeReadJson(this.filePath, {});
+        const digests = Array.isArray(raw.digests) ? raw.digests : [];
+        const maxId = digests.reduce((m, d) => Math.max(m, Number(String(d.id).replace(SIGNAL_DIGEST_CONSTANTS.ID_PREFIX, '')) || 0), 0);
+        const siteSources = raw.siteSources && typeof raw.siteSources === 'object' && !Array.isArray(raw.siteSources) ? raw.siteSources : {};
+        this.data = { nextId: Math.max(Number(raw.nextId) || 1, maxId + 1), digests, siteSources };
+        return this.data;
+    }
+    async save() {
+        if (this.data)
+            await atomicWriteJson(this.filePath, this.data);
+    }
+    serial(fn) {
+        const next = this.chain.then(fn, fn);
+        this.chain = next.catch(() => undefined);
+        return next;
+    }
+}
+//# sourceMappingURL=signal-digest-store.js.map

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

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

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

@@ -0,0 +1,272 @@
+/**
+ * Daily signal digest (#987, specs/2026-10-03-signal-digest.md).
+ *
+ * A team lead proposes 3–5 actions for a site (the `signal-digest` skill
+ * collects the signals and drafts them). This service:
+ * 1. refuses actions the site's history blocks (tried with Do, or skipped
+ *    recently), and replaces the site's earlier unanswered actions;
+ * 2. posts ONE Slack card with Do / Skip per action, from the lead's bot, in
+ *    the lead's team channel (else the owner's DM);
+ * 3. on Do, opens an experiment ticket in the site's project and tells the
+ *    lead; on Skip, records it so the action stays off the list for a while;
+ * 4. keeps each site's signal-source status and tells the owner once when a
+ *    source starts or stops failing (nothing on the days it does not change).
+ *
+ * @module services/signal-digest/signal-digest.service
+ */
+import type { ComponentLogger } from '../core/logger.service.js';
+import type { DecisionPostIdentity, DecisionSlackApi, BlockActionsPayload } from '../decisions/decision.service.js';
+import type { CreateSignalDigestInput, SignalChoice, SignalDigest, SignalDigestItem, SignalHistoryEntry, SignalSourceReport } from '../../types/signal-digest.types.js';
+import type { SignalDigestStore } from './signal-digest-store.js';
+/** A ticket a Do asks for. */
+export interface SignalTicketInput {
+    /** Project reference (name, id or path) */
+    project: string;
+    /** The lead's team, when known (dropped when it is not on the project) */
+    team?: string;
+    title: string;
+    description: string;
+    acceptance: string[];
+    labels: string[];
+    source: string;
+}
+/** The experiment card a Do asks for (#986): the experiment service's create input. */
+export interface SignalExperimentInput {
+    title: string;
+    hypothesis: string;
+    metric: Record<string, string>;
+    ticket: {
+        kind: 'project';
+        project: string;
+        id: string;
+    };
+}
+/** Collaborators. */
+export interface SignalDigestServiceDeps {
+    store: SignalDigestStore;
+    slack: () => DecisionSlackApi | null;
+    instanceId: () => string;
+    /** Whether a Slack user may answer (the owner) */
+    isOwner: (userId: string) => boolean;
+    identityOf: (session: string) => Promise<DecisionPostIdentity>;
+    teamOf: (session: string) => Promise<string | undefined>;
+    teamChannelOf: (teamId: string) => Promise<string | null>;
+    /** The owner's DM, opened with that identity (fallback place) */
+    ownerDmOf?: (identity: DecisionPostIdentity) => Promise<string | null>;
+    displayName?: (session: string) => Promise<string | undefined>;
+    /** Open a ticket; returns its id */
+    createTicket: (input: SignalTicketInput) => Promise<{
+        id: string;
+    }>;
+    /** Create an experiment card as that session (#986); absent = experiment cards are off */
+    createExperiment?: (input: SignalExperimentInput, caller: string) => Promise<{
+        id: string;
+    }>;
+    /** Tell an agent something (wakes it when needed) */
+    deliverToAgent: (session: string, text: string) => Promise<boolean>;
+    /** Tell the owner (false = not delivered); absent = no source-change notices */
+    notifyOwner?: (notice: {
+        title: string;
+        message: string;
+        urgent: boolean;
+    }) => Promise<boolean>;
+    logger: ComponentLogger;
+    now?: () => Date;
+}
+/** What a Slack click did. */
+export interface SignalInteractionOutcome {
+    handled: boolean;
+    reason: string;
+    digest?: SignalDigest;
+}
+/**
+ * The description of the ticket a Do opens: the digest item plus the
+ * experiment card fields #986 measures (hypothesis, metric, baseline, window).
+ *
+ * @param digest - Digest
+ * @param item - The action
+ * @returns Markdown
+ */
+export declare function experimentTicketDescription(digest: SignalDigest, item: SignalDigestItem): string;
+/**
+ * How a source is named to the owner.
+ *
+ * @param name - Source name
+ * @returns Label
+ */
+export declare function sourceLabel(name: string): string;
+/**
+ * Signal digests: proposals, the Slack card, the owner's answers.
+ */
+export declare class SignalDigestService {
+    private readonly deps;
+    private static instance;
+    private readonly now;
+    /** Source reports are handled one at a time (one change notice per change) */
+    private sourceChain;
+    /**
+     * @param deps - Collaborators
+     */
+    constructor(deps: SignalDigestServiceDeps);
+    /** The running service, when started. */
+    static getInstance(): SignalDigestService | null;
+    /**
+     * Set (or clear) the running service.
+     *
+     * @param service - Service or null
+     */
+    static setInstance(service: SignalDigestService | null): void;
+    /**
+     * Propose a digest. The site's earlier unanswered actions are replaced
+     * (expired) first; then any action the history still blocks is refused.
+     *
+     * @param callerSession - Team lead session (X-Agent-Session)
+     * @param input - `{ site, project?, config?, items }`
+     * @returns The stored digest (with `card`, or `postError` when Slack refused)
+     * @throws SignalDigestError(400) for a contract violation, (409) for blocked actions
+     */
+    propose(callerSession: string | undefined, input: CreateSignalDigestInput): Promise<SignalDigest>;
+    /**
+     * A site's digest proposed within DUPLICATE_WINDOW_MS that still has open actions.
+     *
+     * @param site - Site
+     * @returns The newest such digest, or null
+     */
+    private recentOpenDigest;
+    /**
+     * The site's latest source report, when it is recent enough to describe today's run.
+     *
+     * @param site - Site
+     * @returns Statuses, or undefined
+     */
+    private latestSources;
+    /**
+     * A collect run's source statuses (`POST /api/signal-digests/sources`).
+     * Stored per site; the owner is told once when a source starts or stops
+     * failing — not every day it stays broken.
+     *
+     * @param callerSession - Team lead session (X-Agent-Session)
+     * @param input - `{ site, sources }`
+     * @returns What changed and whether the owner was told
+     * @throws SignalDigestError(400)
+     */
+    reportSources(callerSession: string | undefined, input: {
+        site?: unknown;
+        sources?: unknown;
+    }): Promise<SignalSourceReport>;
+    /**
+     * Store a source report and send the change notice (see {@link reportSources}).
+     *
+     * @param caller - Reporting session
+     * @param site - Site
+     * @param sources - Statuses
+     * @returns The report outcome
+     */
+    private recordSources;
+    /**
+     * The site's blocked keys (Do within 90 days, Skip within 30) and its open ones.
+     *
+     * @param site - Site
+     * @returns History entries
+     */
+    history(site: string): Promise<SignalHistoryEntry[]>;
+    /**
+     * Digests, newest first.
+     *
+     * @param site - Only this site, when given
+     * @returns Digests
+     */
+    list(site?: string): Promise<SignalDigest[]>;
+    /**
+     * One digest.
+     *
+     * @param id - Digest id
+     * @returns Digest or null
+     */
+    get(id: string): Promise<SignalDigest | null>;
+    /**
+     * Answer one action from the dashboard / API (owner only; the caller checks).
+     *
+     * @param id - Digest id
+     * @param n - Item number
+     * @param choice - do / skip
+     * @returns The updated digest
+     * @throws SignalDigestError(404) unknown digest / item, (409) already answered
+     */
+    choose(id: string, n: number, choice: SignalChoice): Promise<SignalDigest>;
+    /**
+     * A Slack `block_actions` payload. Ignores anything that is not a click on
+     * one of this instance's digest cards by the owner.
+     *
+     * @param payload - Slack payload
+     * @returns What happened
+     */
+    handleInteraction(payload: BlockActionsPayload): Promise<SignalInteractionOutcome>;
+    /**
+     * Record the answer; on Do open the ticket and tell the lead; redraw the card.
+     *
+     * @param id - Digest id
+     * @param n - Item number
+     * @param choice - do / skip
+     * @param by - Slack user id, or `dashboard`
+     * @returns The updated digest, or null when the item was not open
+     */
+    private apply;
+    /**
+     * Open the experiment ticket of a Do.
+     *
+     * @param digest - Digest
+     * @param item - The action
+     * @returns The ticket id, or why there is none
+     */
+    private openTicket;
+    /**
+     * Create the experiment card of a Do (#986), linked to its ticket, as the
+     * lead (its prediction is recorded under the lead). Only when the action
+     * names a metric and the digest has the seo-ops config.
+     *
+     * @param digest - Digest
+     * @param item - The action
+     * @param ticketId - The ticket the Do opened
+     * @returns The card id, why there is none, or null when none was asked for
+     */
+    private openExperiment;
+    /**
+     * What the lead is told after a Do.
+     *
+     * @param digest - Digest
+     * @param item - The answered action
+     * @returns Message text
+     */
+    private doNote;
+    /**
+     * Replace the site's earlier unanswered actions: they become `expired` and
+     * their cards say so.
+     *
+     * @param site - Site
+     */
+    private expireOpen;
+    /**
+     * Post the card: the lead's team channel from the lead's bot, else the
+     * owner's DM.
+     *
+     * @param digest - Digest without a card
+     * @returns The digest with `card`, or `postError`
+     */
+    private postCard;
+    /**
+     * Redraw a posted card.
+     *
+     * @param digest - Digest
+     * @returns True when Slack accepted the update
+     */
+    private refreshCard;
+    /**
+     * Tell the lead (best effort).
+     *
+     * @param digest - Digest
+     * @param text - Message
+     */
+    private tellAsker;
+}
+//# sourceMappingURL=signal-digest.service.d.ts.map

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

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