crewly 1.20.376 → 1.20.379

package/dist/backend/backend/src/services/project-tickets/ticket-routine-nudge.js

@@ -0,0 +1,123 @@
+/**
+ * Routine nudge for done tickets (crewly#1034).
+ *
+ * A ticket whose verified result says "at least one card per day" or "check
+ * this every Monday" is a recurring plan, but nothing turns it into a
+ * schedule. These pure helpers detect the cadence, decide whether the lead
+ * still needs telling, and build the one nudge. They never schedule anything.
+ *
+ * @module services/project-tickets/ticket-routine-nudge
+ */
+import { TICKET_ROUTINE_NUDGE_CONSTANTS as C } from '../../constants.js';
+/**
+ * A recurring cadence in English or Chinese. Deliberately narrow: "updated"
+ * or "dailymotion" do not match (word boundaries).
+ */
+const CADENCE_PATTERNS = [
+    /\b(?:daily|weekly|monthly|hourly|nightly|biweekly|fortnightly)\b/i,
+    /\bevery\s+(?:other\s+)?(?:day|weekday|week|month|morning|evening|night|hour|monday|tuesday|wednesday|thursday|friday|saturday|sunday)s?\b/i,
+    /\b(?:once|twice|\d+\s*(?:x|times?))\s+(?:a|per|each)\s+(?:day|week|month)\b/i,
+    /\b(?:per|each)\s+(?:day|week|month)\b/i,
+    /\bon\s+(?:mondays|tuesdays|wednesdays|thursdays|fridays|saturdays|sundays|weekdays)\b/i,
+    /每(?:个)?\s*(?:天|日|周|星期|礼拜|月|工作日)/,
+    /每\s*\d+\s*(?:天|周|个月|小时)/,
+];
+/**
+ * Collect the text of a WorkItem result / output: string leaves only, in
+ * order, capped. Numbers and booleans are not prose and are skipped.
+ *
+ * @param values - Result and output objects
+ * @returns One string to scan
+ */
+export function collectResultText(...values) {
+    const parts = [];
+    let size = 0;
+    const walk = (v, depth) => {
+        if (size >= C.MAX_SCAN_CHARS || depth > 4)
+            return;
+        if (typeof v === 'string') {
+            parts.push(v);
+            size += v.length;
+        }
+        else if (Array.isArray(v)) {
+            for (const x of v)
+                walk(x, depth + 1);
+        }
+        else if (v && typeof v === 'object') {
+            for (const x of Object.values(v))
+                walk(x, depth + 1);
+        }
+    };
+    for (const v of values)
+        walk(v, 0);
+    return parts.join('\n').slice(0, C.MAX_SCAN_CHARS);
+}
+/**
+ * Find a recurring cadence in a result text.
+ *
+ * @param text - Result / summary text
+ * @returns The sentence that names the cadence (trimmed, capped), or null
+ */
+export function detectRecurringCadence(text) {
+    if (!text)
+        return null;
+    const sentences = text.split(/(?<=[.!?。！？])\s*|\n+/);
+    for (const raw of sentences) {
+        const sentence = raw.trim();
+        if (sentence && CADENCE_PATTERNS.some((re) => re.test(sentence))) {
+            return sentence.length > C.MAX_QUOTE_CHARS ? `${sentence.slice(0, C.MAX_QUOTE_CHARS)}…` : sentence;
+        }
+    }
+    return null;
+}
+/**
+ * Whether the nudge was already sent for a ticket (its Log carries the marker).
+ *
+ * @param log - Ticket Log lines
+ * @returns True when it was sent
+ */
+export function routineNudgeAlreadySent(log) {
+    return log.some((line) => line.includes(C.LOG_MARKER));
+}
+/**
+ * Whether a live trigger already references the ticket (its id appears in the
+ * trigger's name or action), so a routine is already set.
+ *
+ * @param triggers - All triggers
+ * @param ticketId - Ticket id (e.g. `CE-101`)
+ * @returns True when an active or paused trigger names the ticket
+ */
+export function triggerReferencesTicket(triggers, ticketId) {
+    const escaped = ticketId.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const re = new RegExp(`(?<![A-Za-z0-9-])${escaped}(?![A-Za-z0-9])`, 'i');
+    return triggers.some((t) => {
+        if (t.status !== 'active' && t.status !== 'paused')
+            return false;
+        return re.test(`${t.name ?? ''}\n${JSON.stringify(t.action ?? {})}`);
+    });
+}
+/**
+ * The nudge text for the lead (internal; the owner never sees it).
+ *
+ * @param input - Ticket and cadence
+ * @returns Markdown brief
+ */
+export function buildRoutineNudgeBrief(input) {
+    const title = input.title.length > C.TITLE_MAX_CHARS ? `${input.title.slice(0, C.TITLE_MAX_CHARS)}…` : input.title;
+    return [
+        `Ticket ${input.ticketId} ("${title}") is done, and its result describes recurring work:`,
+        '',
+        `> ${input.quote}`,
+        '',
+        'Nothing runs this on a schedule yet. Either set a routine, or say why not (one line in the ticket log is enough).',
+        '',
+        'Command shape (keep the ticket id in --name or --title so this check sees it):',
+        '',
+        '```',
+        `schedule-followup --cron "<cron>" --max-fires <N> --target ${input.lead} --name "${input.ticketId}-routine" --title "${input.ticketId}: <what to do each time>"`,
+        '```',
+        '',
+        'This is the only reminder for this ticket.',
+    ].join('\n');
+}
+//# sourceMappingURL=ticket-routine-nudge.js.map

package/dist/backend/backend/src/services/project-tickets/ticket-routine-nudge.js.map

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

package/dist/backend/backend/src/services/v3/owner-receipt/owner-pulls-weekly.d.ts

@@ -0,0 +1,173 @@
+/**
+ * Owner pulls, weekly (#1387, first slice) — how often agents put something in
+ * front of the owner, by kind and by team, and what became of it.
+ *
+ * Measures only; it never changes when agents ping the owner. Pure functions:
+ * the caller reads decisions / Request open items / traces and passes them in.
+ * Spec: specs/owner-pulls-weekly.md.
+ *
+ * ## The rule for "FYI that did not need an answer"
+ *
+ * An agent post to the owner (a plain chat message, not a card) is an FYI when
+ * ALL of these hold ({@link classifyAgentPost}):
+ *  1. it did not end with a question,
+ *  2. it did not open a decision card, and
+ *  3. no WorkItem stayed blocked on the owner afterwards.
+ * Any one of them failing makes it a "needed an answer" pull (a decision),
+ * unless it reports a failure / stuck work (then it is `stuck`). This is the
+ * issue's first guess; it is a rule on facts the harness already has, so the
+ * owner is never asked per post. Decision cards always ask, so they are never
+ * FYIs.
+ *
+ * @module services/v3/owner-receipt/owner-pulls-weekly
+ */
+import type { OwnerDecision } from '../../../types/decision.types.js';
+import type { RequestOpenItem } from '../../../types/v2/open-item.types.js';
+/** What the agent wanted from the owner. */
+export type PullKind = 'decision' | 'review' | 'fyi' | 'stuck';
+/** Every kind, in the order the line names them. */
+export declare const PULL_KINDS: readonly PullKind[];
+/**
+ * What became of a pull.
+ * - `answered`: the owner chose / replied
+ * - `aged_out`: the deadline passed and the default was applied, or it expired / parked unanswered
+ * - `ignored`: the owner skipped it ("no need")
+ * - `open`: still waiting
+ */
+export type PullOutcome = 'answered' | 'aged_out' | 'ignored' | 'open';
+/** Every outcome, in the order the line names them. */
+export declare const PULL_OUTCOMES: readonly PullOutcome[];
+/** One agent pull on the owner. */
+export interface PullRecord {
+    /** When the agent pulled (ISO) */
+    at: string;
+    kind: PullKind;
+    /** Team name, or the unknown-team label */
+    team: string;
+    outcome: PullOutcome;
+}
+/** Facts about one agent post to the owner that is not a card. */
+export interface AgentPostFacts {
+    /** The post's last sentence is a question */
+    endsWithQuestion: boolean;
+    /** The agent opened a decision card for it */
+    openedDecisionCard: boolean;
+    /** A WorkItem stayed blocked on the owner after the post */
+    workItemBlockedOnOwner: boolean;
+    /** It reports an error, a failure or work that is stuck */
+    reportsFailure: boolean;
+}
+/**
+ * Classify a plain agent post by the FYI rule (see the module doc).
+ *
+ * @param facts - What the harness knows about the post
+ * @returns `stuck` for a failure report, `decision` when it needed an answer, else `fyi`
+ */
+export declare function classifyAgentPost(facts: AgentPostFacts): PullKind;
+/**
+ * Kind of a decision card: a held action / merge / sensitive ask is a review
+ * or approval, a spend cap is the agent being stopped, the rest are decisions.
+ *
+ * @param d - The card
+ * @returns Its pull kind
+ */
+export declare function decisionPullKind(d: OwnerDecision): PullKind;
+/**
+ * Outcome of a decision card, or null when the card does not count as a pull
+ * (withdrawn by the agent before the owner dealt with it).
+ *
+ * @param d - The card
+ * @returns Outcome or null
+ */
+export declare function decisionPullOutcome(d: OwnerDecision): PullOutcome | null;
+/**
+ * Turn decision cards into pull records. Cards the harness asks itself (runtime
+ * terms, receipt format) are not agent pulls and are left out; a spend cap is
+ * kept (an agent was stopped).
+ *
+ * @param decisions - Every card
+ * @param teamOf - Team name for a card, or null
+ * @returns Records
+ */
+export declare function pullsFromDecisions(decisions: readonly OwnerDecision[], teamOf: (d: OwnerDecision) => string | null): PullRecord[];
+/**
+ * Turn the questions agents left in their replies (Request open items) into
+ * pull records. A question already carded (a `reply_question` decision tracks
+ * it) is counted once, by its card; superseded / cancelled items are not pulls.
+ *
+ * @param items - Open items with their Request id
+ * @param cardedKeys - `requestId:itemId` of items that have a decision card
+ * @param teamOfAgent - Team name for an agent session, or null
+ * @returns Records
+ */
+export declare function pullsFromOpenItems(items: ReadonlyArray<{
+    requestId: string;
+    item: RequestOpenItem;
+}>, cardedKeys: ReadonlySet<string>, teamOfAgent: (session: string) => string | null): PullRecord[];
+/** Counts for one week. */
+export interface PullsWeek {
+    total: number;
+    byKind: Record<PullKind, number>;
+    byOutcome: Record<PullOutcome, number>;
+    /** Most pulls first, then by name */
+    byTeam: Array<{
+        team: string;
+        count: number;
+    }>;
+}
+/** The weekly rollup. */
+export interface PullsWeekly {
+    /** Window of the counted week (ISO) */
+    window: {
+        from: string;
+        to: string;
+    };
+    thisWeek: PullsWeek;
+    lastWeek: PullsWeek;
+    /** `thisWeek.total - lastWeek.total` */
+    change: number;
+    /**
+     * The owner's own touches in runs (trace owner-touch metrics: replies,
+     * approvals, send-backs, corrections), when the caller supplied them.
+     */
+    ownerTouches?: {
+        thisWeek: number;
+        lastWeek: number;
+    };
+}
+/**
+ * Roll pulls up into this week and last week.
+ *
+ * @param records - All pull records (any age)
+ * @param now - End of the counted week
+ * @param ownerTouches - Optional owner-touch counts from traces
+ * @returns The rollup
+ */
+export declare function rollupPulls(records: readonly PullRecord[], now: Date, ownerTouches?: {
+    thisWeek: number;
+    lastWeek: number;
+}): PullsWeekly;
+/**
+ * Sum the owner touches of traces whose root falls in each week.
+ *
+ * @param traces - Trace rows: root time and the owner-touch total from metrics
+ * @param now - End of the counted week
+ * @returns Counts for this and last week
+ */
+export declare function countOwnerTouches(traces: ReadonlyArray<{
+    createdAt: string;
+    ownerTouches: number;
+}>, now: Date): {
+    thisWeek: number;
+    lastWeek: number;
+};
+/**
+ * Render the weekly line for the owner (Slack mrkdwn, at most four lines, no
+ * ticket or card numbers). Empty string when there were no pulls this week
+ * and last week: nothing to say.
+ *
+ * @param w - The rollup
+ * @returns Text or ''
+ */
+export declare function renderPullsWeekly(w: PullsWeekly): string;
+//# sourceMappingURL=owner-pulls-weekly.d.ts.map

package/dist/backend/backend/src/services/v3/owner-receipt/owner-pulls-weekly.d.ts.map

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

package/dist/backend/backend/src/services/v3/owner-receipt/owner-pulls-weekly.js

@@ -0,0 +1,263 @@
+/**
+ * Owner pulls, weekly (#1387, first slice) — how often agents put something in
+ * front of the owner, by kind and by team, and what became of it.
+ *
+ * Measures only; it never changes when agents ping the owner. Pure functions:
+ * the caller reads decisions / Request open items / traces and passes them in.
+ * Spec: specs/owner-pulls-weekly.md.
+ *
+ * ## The rule for "FYI that did not need an answer"
+ *
+ * An agent post to the owner (a plain chat message, not a card) is an FYI when
+ * ALL of these hold ({@link classifyAgentPost}):
+ *  1. it did not end with a question,
+ *  2. it did not open a decision card, and
+ *  3. no WorkItem stayed blocked on the owner afterwards.
+ * Any one of them failing makes it a "needed an answer" pull (a decision),
+ * unless it reports a failure / stuck work (then it is `stuck`). This is the
+ * issue's first guess; it is a rule on facts the harness already has, so the
+ * owner is never asked per post. Decision cards always ask, so they are never
+ * FYIs.
+ *
+ * @module services/v3/owner-receipt/owner-pulls-weekly
+ */
+import { OWNER_RECEIPT_CONSTANTS, PULLS_WEEKLY_KIND_LABELS } from '../../../constants.js';
+/** Every kind, in the order the line names them. */
+export const PULL_KINDS = ['decision', 'review', 'fyi', 'stuck'];
+/** Every outcome, in the order the line names them. */
+export const PULL_OUTCOMES = ['answered', 'aged_out', 'ignored', 'open'];
+/**
+ * Classify a plain agent post by the FYI rule (see the module doc).
+ *
+ * @param facts - What the harness knows about the post
+ * @returns `stuck` for a failure report, `decision` when it needed an answer, else `fyi`
+ */
+export function classifyAgentPost(facts) {
+    if (facts.reportsFailure)
+        return 'stuck';
+    if (facts.endsWithQuestion || facts.openedDecisionCard || facts.workItemBlockedOnOwner)
+        return 'decision';
+    return 'fyi';
+}
+/** Decision kinds that ask the owner to approve something an agent holds. */
+const REVIEW_DECISION_KINDS = new Set([
+    'browser_action',
+    'gmail_send',
+    'app_collaborator',
+    'app_template',
+    'model_tier_change',
+]);
+/**
+ * Kind of a decision card: a held action / merge / sensitive ask is a review
+ * or approval, a spend cap is the agent being stopped, the rest are decisions.
+ *
+ * @param d - The card
+ * @returns Its pull kind
+ */
+export function decisionPullKind(d) {
+    if (d.kind === 'spend_cap')
+        return 'stuck';
+    if ((d.kind && REVIEW_DECISION_KINDS.has(d.kind)) || d.merge === true || d.sensitive !== undefined)
+        return 'review';
+    return 'decision';
+}
+/**
+ * Outcome of a decision card, or null when the card does not count as a pull
+ * (withdrawn by the agent before the owner dealt with it).
+ *
+ * @param d - The card
+ * @returns Outcome or null
+ */
+export function decisionPullOutcome(d) {
+    switch (d.status) {
+        case 'resolved':
+            // A default applied at the deadline is resolved with `answeredVia: 'deadline'`.
+            return d.answeredVia === 'deadline' ? 'aged_out' : 'answered';
+        case 'defaulted':
+        case 'expired':
+        case 'parked':
+            return 'aged_out';
+        case 'skipped':
+            return 'ignored';
+        case 'open':
+            return 'open';
+        case 'cancelled':
+            return null;
+        default:
+            return null;
+    }
+}
+/**
+ * Turn decision cards into pull records. Cards the harness asks itself (runtime
+ * terms, receipt format) are not agent pulls and are left out; a spend cap is
+ * kept (an agent was stopped).
+ *
+ * @param decisions - Every card
+ * @param teamOf - Team name for a card, or null
+ * @returns Records
+ */
+export function pullsFromDecisions(decisions, teamOf) {
+    const out = [];
+    for (const d of decisions) {
+        if (d.system && d.kind !== 'spend_cap')
+            continue;
+        const outcome = decisionPullOutcome(d);
+        if (!outcome)
+            continue;
+        out.push({
+            at: d.askedAt ?? d.createdAt,
+            kind: decisionPullKind(d),
+            team: teamOf(d) ?? OWNER_RECEIPT_CONSTANTS.UNASSIGNED_TEAM,
+            outcome,
+        });
+    }
+    return out;
+}
+/**
+ * Turn the questions agents left in their replies (Request open items) into
+ * pull records. A question already carded (a `reply_question` decision tracks
+ * it) is counted once, by its card; superseded / cancelled items are not pulls.
+ *
+ * @param items - Open items with their Request id
+ * @param cardedKeys - `requestId:itemId` of items that have a decision card
+ * @param teamOfAgent - Team name for an agent session, or null
+ * @returns Records
+ */
+export function pullsFromOpenItems(items, cardedKeys, teamOfAgent) {
+    const out = [];
+    for (const { requestId, item } of items) {
+        if (item.type !== 'question' || cardedKeys.has(`${requestId}:${item.id}`))
+            continue;
+        let outcome;
+        switch (item.status) {
+            case 'resolved':
+                outcome = 'answered';
+                break;
+            case 'skipped':
+                outcome = 'ignored';
+                break;
+            case 'expired':
+                outcome = 'aged_out';
+                break;
+            case 'open':
+            case 'waiting_owner':
+            case 'overdue':
+            case 'ready':
+                outcome = 'open';
+                break;
+            default:
+                continue; // superseded / cancelled / delivered
+        }
+        out.push({
+            at: item.createdAt,
+            // A question left in a reply ends with a question by construction.
+            kind: classifyAgentPost({ endsWithQuestion: true, openedDecisionCard: false, workItemBlockedOnOwner: false, reportsFailure: false }),
+            team: teamOfAgent(item.agent) ?? OWNER_RECEIPT_CONSTANTS.UNASSIGNED_TEAM,
+            outcome,
+        });
+    }
+    return out;
+}
+function emptyWeek() {
+    return {
+        total: 0,
+        byKind: { decision: 0, review: 0, fyi: 0, stuck: 0 },
+        byOutcome: { answered: 0, aged_out: 0, ignored: 0, open: 0 },
+        byTeam: [],
+    };
+}
+function countWeek(records, fromMs, toMs) {
+    const week = emptyWeek();
+    const teams = new Map();
+    for (const r of records) {
+        const t = Date.parse(r.at);
+        if (!Number.isFinite(t) || t < fromMs || t >= toMs)
+            continue;
+        week.total += 1;
+        week.byKind[r.kind] += 1;
+        week.byOutcome[r.outcome] += 1;
+        teams.set(r.team, (teams.get(r.team) ?? 0) + 1);
+    }
+    week.byTeam = [...teams.entries()].map(([team, count]) => ({ team, count })).sort((a, b) => b.count - a.count || a.team.localeCompare(b.team));
+    return week;
+}
+/**
+ * Roll pulls up into this week and last week.
+ *
+ * @param records - All pull records (any age)
+ * @param now - End of the counted week
+ * @param ownerTouches - Optional owner-touch counts from traces
+ * @returns The rollup
+ */
+export function rollupPulls(records, now, ownerTouches) {
+    const span = OWNER_RECEIPT_CONSTANTS.PULLS_WEEKLY.WINDOW_MS;
+    const to = now.getTime();
+    const from = to - span;
+    const thisWeek = countWeek(records, from, to);
+    const lastWeek = countWeek(records, from - span, from);
+    return {
+        window: { from: new Date(from).toISOString(), to: new Date(to).toISOString() },
+        thisWeek,
+        lastWeek,
+        change: thisWeek.total - lastWeek.total,
+        ...(ownerTouches ? { ownerTouches } : {}),
+    };
+}
+/**
+ * Sum the owner touches of traces whose root falls in each week.
+ *
+ * @param traces - Trace rows: root time and the owner-touch total from metrics
+ * @param now - End of the counted week
+ * @returns Counts for this and last week
+ */
+export function countOwnerTouches(traces, now) {
+    const span = OWNER_RECEIPT_CONSTANTS.PULLS_WEEKLY.WINDOW_MS;
+    const to = now.getTime();
+    const out = { thisWeek: 0, lastWeek: 0 };
+    for (const t of traces) {
+        const at = Date.parse(t.createdAt);
+        if (!Number.isFinite(at) || at >= to)
+            continue;
+        if (at >= to - span)
+            out.thisWeek += t.ownerTouches;
+        else if (at >= to - 2 * span)
+            out.lastWeek += t.ownerTouches;
+    }
+    return out;
+}
+/** `+3`, `-2`, `no change`. */
+function changeWords(change) {
+    if (change === 0)
+        return 'same as last week';
+    return `${change > 0 ? 'up' : 'down'} ${Math.abs(change)} from last week`;
+}
+/**
+ * Render the weekly line for the owner (Slack mrkdwn, at most four lines, no
+ * ticket or card numbers). Empty string when there were no pulls this week
+ * and last week: nothing to say.
+ *
+ * @param w - The rollup
+ * @returns Text or ''
+ */
+export function renderPullsWeekly(w) {
+    if (w.thisWeek.total === 0 && w.lastWeek.total === 0)
+        return '';
+    const { thisWeek } = w;
+    const noun = thisWeek.total === 1 ? 'time' : 'times';
+    const lines = [`*Pulled you in ${thisWeek.total} ${noun} this week* (${changeWords(w.change)})`];
+    if (thisWeek.total > 0) {
+        const kinds = PULL_KINDS.filter((k) => thisWeek.byKind[k] > 0).map((k) => `${thisWeek.byKind[k]} ${PULLS_WEEKLY_KIND_LABELS[k]}`);
+        lines.push(`• By kind: ${kinds.join(', ')}`);
+        const outcomes = PULL_OUTCOMES.filter((o) => thisWeek.byOutcome[o] > 0).map((o) => `${o.replace('_', ' ')} ${thisWeek.byOutcome[o]}`);
+        lines.push(`• ${outcomes.join(', ').replace(/^./, (c) => c.toUpperCase())}`);
+        const max = OWNER_RECEIPT_CONSTANTS.PULLS_WEEKLY.MAX_TEAMS;
+        const shown = thisWeek.byTeam.slice(0, max).map((t) => `${t.team} ${t.count}`);
+        const rest = thisWeek.byTeam.length - shown.length;
+        lines.push(`• By team: ${shown.join(', ')}${rest > 0 ? `, +${rest} more` : ''}`);
+    }
+    if (w.ownerTouches && w.ownerTouches.thisWeek + w.ownerTouches.lastWeek > 0) {
+        lines.push(`• You replied or approved ${w.ownerTouches.thisWeek} times in runs (last week ${w.ownerTouches.lastWeek})`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=owner-pulls-weekly.js.map

package/dist/backend/backend/src/services/v3/owner-receipt/owner-pulls-weekly.js.map

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

package/dist/backend/backend/src/services/v3/owner-receipt/owner-pulls-weekly.loader.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Loader for the weekly owner-pulls rollup (#1387): reads decision cards,
+ * Request open items and trace owner touches, and hands them to the pure
+ * rollup in {@link ./owner-pulls-weekly}.
+ *
+ * @module services/v3/owner-receipt/owner-pulls-weekly.loader
+ */
+import type { OwnerDecision } from '../../../types/decision.types.js';
+import type { Request } from '../../../types/v2/request.types.js';
+import { type PullsWeekly } from './owner-pulls-weekly.js';
+/** Where the loader reads from. */
+export interface PullsWeeklyLoaderDeps {
+    listDecisions: () => Promise<OwnerDecision[]>;
+    listRequests: () => Promise<Request[]>;
+    /** session → team name */
+    loadTeamIndex: () => Promise<Map<string, string>>;
+    /** Team id → team name (a card carries the id of the team whose channel has it) */
+    loadTeamNameById?: () => Promise<Map<string, string>>;
+    /**
+     * Trace rows with their owner-touch total, newest first; absent = the
+     * owner-touch count is left out.
+     */
+    listTraceTouches?: (since: Date, limit: number) => Promise<Array<{
+        createdAt: string;
+        ownerTouches: number;
+    }>>;
+}
+/**
+ * Build the `loadPullsWeekly` dependency of the owner receipt service.
+ *
+ * @param deps - Data sources
+ * @returns Function that computes the rollup for the week ending at `now`
+ */
+export declare function createPullsWeeklyLoader(deps: PullsWeeklyLoaderDeps): (now: Date) => Promise<PullsWeekly>;
+//# sourceMappingURL=owner-pulls-weekly.loader.d.ts.map

package/dist/backend/backend/src/services/v3/owner-receipt/owner-pulls-weekly.loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"owner-pulls-weekly.loader.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/v3/owner-receipt/owner-pulls-weekly.loader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAKL,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AAEjC,mCAAmC;AACnC,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAC9C,YAAY,EAAE,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACvC,0BAA0B;IAC1B,aAAa,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,mFAAmF;IACnF,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;CAChH;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,qBAAqB,GAAG,CAAC,GAAG,EAAE,IAAI,KAAK,OAAO,CAAC,WAAW,CAAC,CA2BxG"}