crewly 1.20.215 → 1.20.217

package/dist/backend/backend/src/services/tl-delegation/lead-share.js

@@ -0,0 +1,175 @@
+/**
+ * Lead share of a team's tokens (crewly#1083, specs/2026-10-04-tl-delegation.md §3).
+ *
+ * A team whose lead burns most of its tokens is a team whose lead does the
+ * work. Per team: the lead sessions' tokens over the whole team's, today and
+ * over the last week, flagged above {@link TL_DELEGATION_CONSTANTS.FLAG_SHARE}.
+ *
+ * Pure functions only: the token ledger is passed in as a visitor.
+ *
+ * @module services/tl-delegation/lead-share
+ */
+import { TL_DELEGATION_CONSTANTS } from '../../constants.js';
+import { getTeamLeads } from '../../utils/team.utils.js';
+import { eventTokens } from '../monitoring/token-usage.service.js';
+/**
+ * The ledger keys a member's usage is recorded under: its session name and
+ * its permanent agent id (a stopped member has no session name).
+ *
+ * @param m - Team member
+ * @returns Non-empty keys
+ */
+export function memberLedgerKeys(m) {
+    return [...new Set([m.sessionName, m.agentId].filter((k) => typeof k === 'string' && k.length > 0))];
+}
+/**
+ * Local midnight of a date.
+ *
+ * @param now - Clock
+ * @returns Midnight (local time) of the same day
+ */
+export function startOfLocalDay(now) {
+    const d = new Date(now.getTime());
+    d.setHours(0, 0, 0, 0);
+    return d;
+}
+/**
+ * Build a period from its totals.
+ *
+ * @param lead - Lead tokens
+ * @param team - Team tokens
+ * @param teamBudget - Team cost-weighted tokens, for display
+ * @returns The period
+ */
+export function sharePeriod(lead, team, teamBudget) {
+    const share = team > 0 ? lead / team : null;
+    return {
+        lead,
+        team,
+        share,
+        flagged: share !== null && share > TL_DELEGATION_CONSTANTS.FLAG_SHARE && team >= TL_DELEGATION_CONSTANTS.MIN_TEAM_TOKENS,
+        ...(teamBudget !== undefined ? { teamBudget: Math.round(teamBudget) } : {}),
+    };
+}
+/**
+ * Lead share per team. Teams that are archived, have no lead, or have no
+ * other member are left out (a one-person team has no one to delegate to).
+ *
+ * @param teams - Teams
+ * @param forEachEvent - Ledger visitor
+ * @param now - Clock
+ * @returns One row per team with a lead and at least one other member
+ */
+export function computeLeadShares(teams, forEachEvent, now) {
+    const dayStart = startOfLocalDay(now).getTime();
+    const weekStart = startOfLocalDay(new Date(now.getTime() - (TL_DELEGATION_CONSTANTS.WEEK_DAYS - 1) * 24 * 60 * 60 * 1000)).getTime();
+    const accs = [];
+    // ledger key → (team accumulator, is lead)
+    const owners = new Map();
+    for (const team of teams) {
+        if (team.archived)
+            continue;
+        const members = (team.members ?? []).filter((m) => m.role !== 'orchestrator');
+        const leads = getTeamLeads(team);
+        if (leads.length === 0 || members.length < 2)
+            continue;
+        const leadIds = new Set(leads.map((l) => l.id));
+        const acc = {
+            row: {
+                teamId: team.id,
+                teamName: team.name,
+                leads: leads.map((l) => l.name),
+                leadSessions: leads.flatMap((l) => memberLedgerKeys(l)),
+            },
+            day: { lead: 0, team: 0, budget: 0 },
+            week: { lead: 0, team: 0, budget: 0 },
+        };
+        accs.push(acc);
+        for (const m of members) {
+            for (const key of memberLedgerKeys(m)) {
+                if (!owners.has(key))
+                    owners.set(key, { acc, lead: leadIds.has(m.id) });
+            }
+        }
+    }
+    if (accs.length === 0)
+        return [];
+    forEachEvent((session, event) => {
+        const owner = owners.get(session);
+        if (!owner)
+            return;
+        const at = Date.parse(event.timestamp);
+        if (!Number.isFinite(at) || at < weekStart || at > now.getTime())
+            return;
+        const et = eventTokens(event);
+        const tokens = et.total;
+        owner.acc.week.budget += et.budget;
+        owner.acc.week.team += tokens;
+        if (owner.lead)
+            owner.acc.week.lead += tokens;
+        if (at >= dayStart) {
+            owner.acc.day.budget += et.budget;
+            owner.acc.day.team += tokens;
+            if (owner.lead)
+                owner.acc.day.lead += tokens;
+        }
+    }, new Date(weekStart));
+    return accs.map((a) => ({ ...a.row, today: sharePeriod(a.day.lead, a.day.team, a.day.budget), week: sharePeriod(a.week.lead, a.week.team, a.week.budget) }));
+}
+/**
+ * A share as a whole percentage.
+ *
+ * @param share - 0..1 or null
+ * @returns "63%" or "–"
+ */
+export function formatShare(share) {
+    return share === null ? '–' : `${Math.round(share * 100)}%`;
+}
+/**
+ * Token count, short.
+ *
+ * @param n - Tokens
+ * @returns "306M", "4.2M", "12k", "800"
+ */
+export function formatTokens(n) {
+    if (n >= 100_000_000)
+        return `${Math.round(n / 1_000_000)}M`;
+    if (n >= 1_000_000)
+        return `${(n / 1_000_000).toFixed(1)}M`;
+    if (n >= 1_000)
+        return `${Math.round(n / 1_000)}k`;
+    return String(Math.round(n));
+}
+/**
+ * The "Team leads" block of the evening digest. Teams with no tokens today
+ * and no records are left out.
+ *
+ * @param rows - Lead shares
+ * @param extras - Team id → nudges / kept-work reasons
+ * @returns Block text, or null when there is nothing to say
+ */
+export function buildLeadShareDigest(rows, extras = new Map()) {
+    const lines = [];
+    for (const r of rows) {
+        const x = extras.get(r.teamId) ?? {};
+        const kept = x.keptReasons ?? [];
+        if (r.today.team === 0 && kept.length === 0 && !x.nudges?.count)
+            continue;
+        const flag = r.today.flagged || r.week.flagged ? ' — over half: the lead is doing the work' : '';
+        const parts = [
+            `- *${r.teamName}* (${r.leads.join(', ')}): ${formatShare(r.today.share)} of ${formatTokens(r.today.team)} today${r.today.teamBudget !== undefined ? ` (${formatTokens(r.today.teamBudget)} weighted)` : ''}, ${formatShare(r.week.share)} this week${flag}`,
+        ];
+        if (x.nudges && x.nudges.count > 0)
+            parts.push(`  nudged to delegate ${x.nudges.count}×, delegated after ${x.nudges.followed}`);
+        if (kept.length > 0) {
+            const max = 3;
+            const shown = kept.slice(0, max).map((k) => `"${k}"`).join('; ');
+            parts.push(`  kept work, no member fits: ${shown}${kept.length > max ? `; +${kept.length - max} more` : ''}`);
+        }
+        lines.push(parts.join('\n'));
+    }
+    if (lines.length === 0)
+        return null;
+    return ['*Team leads* (lead share of team tokens)', ...lines].join('\n');
+}
+//# sourceMappingURL=lead-share.js.map

package/dist/backend/backend/src/services/tl-delegation/lead-share.js.map

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

package/dist/backend/backend/src/services/tl-delegation/lead-share.wiring.d.ts

@@ -0,0 +1,32 @@
+/**
+ * The "Team leads" block of the evening digest from the process singletons
+ * (crewly#1083, specs/2026-10-04-tl-delegation.md §3).
+ *
+ * @module services/tl-delegation/lead-share.wiring
+ */
+import type { Team } from '../../types/index.js';
+import { type LedgerVisitor } from './lead-share.js';
+import type { TlDelegationService } from './tl-delegation.service.js';
+/** Collaborators of {@link leadShareDigestFor}. */
+export interface LeadShareDigestDeps {
+    teams: () => Promise<Team[]>;
+    forEachEvent: LedgerVisitor;
+    delegation: Pick<TlDelegationService, 'nudgeCounts' | 'keptWorkSince'>;
+}
+/**
+ * The digest block for today: lead shares, today's nudges and kept work.
+ *
+ * @param now - Clock
+ * @param deps - Collaborators
+ * @returns Block text, or null when there is nothing to say
+ */
+export declare function leadShareDigestFor(now: Date, deps: LeadShareDigestDeps): Promise<string | null>;
+/**
+ * {@link leadShareDigestFor} over the team store, the token ledger and the
+ * delegation service.
+ *
+ * @param now - Clock
+ * @returns Block text, or null
+ */
+export declare function defaultLeadShareDigest(now: Date): Promise<string | null>;
+//# sourceMappingURL=lead-share.wiring.d.ts.map

package/dist/backend/backend/src/services/tl-delegation/lead-share.wiring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lead-share.wiring.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/tl-delegation/lead-share.wiring.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAmF,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACtI,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,mDAAmD;AACnD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7B,YAAY,EAAE,aAAa,CAAC;IAC5B,UAAU,EAAE,IAAI,CAAC,mBAAmB,EAAE,aAAa,GAAG,eAAe,CAAC,CAAC;CACxE;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWrG;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAY9E"}

package/dist/backend/backend/src/services/tl-delegation/lead-share.wiring.js

@@ -0,0 +1,47 @@
+/**
+ * The "Team leads" block of the evening digest from the process singletons
+ * (crewly#1083, specs/2026-10-04-tl-delegation.md §3).
+ *
+ * @module services/tl-delegation/lead-share.wiring
+ */
+import { buildLeadShareDigest, computeLeadShares, startOfLocalDay } from './lead-share.js';
+/**
+ * The digest block for today: lead shares, today's nudges and kept work.
+ *
+ * @param now - Clock
+ * @param deps - Collaborators
+ * @returns Block text, or null when there is nothing to say
+ */
+export async function leadShareDigestFor(now, deps) {
+    const teams = await deps.teams();
+    const rows = computeLeadShares(teams, deps.forEachEvent, now);
+    const dayStart = startOfLocalDay(now).getTime();
+    const extras = new Map();
+    for (const r of rows) {
+        const nudges = deps.delegation.nudgeCounts(r.leadSessions, now.getTime()).day;
+        const kept = deps.delegation.keptWorkSince(dayStart, { teamId: r.teamId, sessions: r.leadSessions }).map((k) => k.reason);
+        extras.set(r.teamId, { nudges, keptReasons: kept });
+    }
+    return buildLeadShareDigest(rows, extras);
+}
+/**
+ * {@link leadShareDigestFor} over the team store, the token ledger and the
+ * delegation service.
+ *
+ * @param now - Clock
+ * @returns Block text, or null
+ */
+export async function defaultLeadShareDigest(now) {
+    const [{ StorageService }, { TokenUsageService }, { TlDelegationService }] = await Promise.all([
+        import('../core/storage.service.js'),
+        import('../monitoring/token-usage.service.js'),
+        import('./tl-delegation.service.js'),
+    ]);
+    const usage = TokenUsageService.getInstance();
+    return leadShareDigestFor(now, {
+        teams: () => StorageService.getInstance().getTeams(),
+        forEachEvent: (visit, since) => usage.forEachEvent(visit, since),
+        delegation: TlDelegationService.getInstance(),
+    });
+}
+//# sourceMappingURL=lead-share.wiring.js.map

package/dist/backend/backend/src/services/tl-delegation/lead-share.wiring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lead-share.wiring.js","sourceRoot":"","sources":["../../../../../../backend/src/services/tl-delegation/lead-share.wiring.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,eAAe,EAA6C,MAAM,iBAAiB,CAAC;AAUtI;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,GAAS,EAAE,IAAyB;IAC3E,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;IAC9D,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;IAChD,MAAM,MAAM,GAAG,IAAI,GAAG,EAA4B,CAAC;IACnD,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC;QAC9E,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC1H,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,GAAS;IACpD,MAAM,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE,mBAAmB,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC7F,MAAM,CAAC,4BAA4B,CAAC;QACpC,MAAM,CAAC,sCAAsC,CAAC;QAC9C,MAAM,CAAC,4BAA4B,CAAC;KACrC,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,iBAAiB,CAAC,WAAW,EAAE,CAAC;IAC9C,OAAO,kBAAkB,CAAC,GAAG,EAAE;QAC7B,KAAK,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;QACpD,YAAY,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC;QAChE,UAAU,EAAE,mBAAmB,CAAC,WAAW,EAAE;KAC9C,CAAC,CAAC;AACL,CAAC"}

package/dist/backend/backend/src/services/tl-delegation/tl-delegation.service.d.ts

@@ -0,0 +1,207 @@
+/**
+ * Team-lead delegation: the execution nudge, its counts, and "no member
+ * fits" records (crewly#1083, specs/2026-10-04-tl-delegation.md §2, §4).
+ *
+ * The nudge rides on the Claude Code agent-status hook: each `PostToolUse`
+ * reports the tool name, and a lead that edited files
+ * {@link TL_DELEGATION_CONSTANTS.EDIT_THRESHOLD} times within
+ * {@link TL_DELEGATION_CONSTANTS.WINDOW_MS} gets one note back as hook
+ * `additionalContext` — at most once per
+ * {@link TL_DELEGATION_CONSTANTS.NUDGE_COOLDOWN_MS}. It never blocks: the
+ * tool already ran, and any failure means no note.
+ *
+ * @module services/tl-delegation/tl-delegation.service
+ */
+import type { Team, TeamMember } from '../../types/index.js';
+import { type ComponentLogger } from '../core/logger.service.js';
+/** A member as the nudge names it. */
+export interface NudgeMember {
+    name: string;
+    role: string;
+    /** idle: free now; stopped: starts when assigned; working: busy */
+    availability: 'idle' | 'stopped' | 'working';
+}
+/** The lead's team, for the nudge. */
+export interface LeadContext {
+    teamId: string;
+    teamName: string;
+    /** Members other than the lead(s) */
+    members: NudgeMember[];
+}
+/** Work a lead kept because no member fits. */
+export interface KeptWorkRecord {
+    at: string;
+    /** Lead session */
+    session: string;
+    teamId?: string;
+    reason: string;
+    work: string;
+    workItemId?: string;
+    ticket?: string;
+}
+/** Per-lead nudge counts. */
+export interface NudgeCounts {
+    /** Nudges sent */
+    count: number;
+    /** Nudges followed by a delegation within the follow window */
+    followed: number;
+    /** Last nudge (epoch ms) */
+    lastAt?: number;
+    /** A nudge not yet followed (epoch ms), cleared on delegation or when the window passes */
+    pendingSince?: number;
+    /** Per local day: day key → { count, followed } */
+    days?: Record<string, {
+        count: number;
+        followed: number;
+    }>;
+}
+/** Collaborators. */
+export interface TlDelegationDeps {
+    /** The lead's team, or null when the session is not a team lead (or has nobody to delegate to) */
+    leadContext: (session: string) => Promise<LeadContext | null>;
+    /** State file (default: CREWLY_HOME/tl-delegation.json) */
+    statePath?: string;
+    /** Clock (epoch ms) */
+    now?: () => number;
+    logger?: ComponentLogger;
+}
+/**
+ * Members best placed to take hands-on work: idle first, then stopped, then
+ * working; at most {@link TL_DELEGATION_CONSTANTS.NUDGE_MAX_MEMBERS}.
+ *
+ * @param members - The lead's members
+ * @returns Ranked, capped list
+ */
+export declare function rankMembersForNudge(members: readonly NudgeMember[]): NudgeMember[];
+/**
+ * The nudge text (English harness text).
+ *
+ * @param edits - Edits counted in the window
+ * @param members - The lead's members
+ * @returns Note
+ */
+export declare function buildNudgeText(edits: number, members: readonly NudgeMember[]): string;
+/**
+ * Local date key (YYYY-MM-DD).
+ *
+ * @param ms - Epoch ms
+ * @returns Day key
+ */
+export declare function localDayKey(ms: number): string;
+/**
+ * Nudge bookkeeping and kept-work records.
+ */
+export declare class TlDelegationService {
+    private static instance;
+    private readonly deps;
+    private readonly statePath;
+    private readonly now;
+    private readonly logger;
+    /** session → recent edit times (epoch ms), in-memory only */
+    private readonly edits;
+    private state;
+    private writing;
+    /**
+     * @param deps - Collaborators
+     */
+    constructor(deps: TlDelegationDeps);
+    /**
+     * The process instance (built from the team store on first use).
+     *
+     * @returns Service
+     */
+    static getInstance(): TlDelegationService;
+    /**
+     * Replace (tests) or clear the process instance.
+     *
+     * @param service - New instance, or null
+     */
+    static setInstance(service: TlDelegationService | null): void;
+    /**
+     * A tool call finished in `session`. Returns the nudge to show the agent,
+     * or null. Never throws.
+     *
+     * @param session - Agent session
+     * @param toolName - Claude Code tool name
+     * @returns Nudge text, or null
+     */
+    observeToolUse(session: string, toolName: string): Promise<string | null>;
+    /**
+     * A work item was delegated. Counts as following a nudge when the
+     * delegator was nudged within {@link TL_DELEGATION_CONSTANTS.FOLLOW_WINDOW_MS}.
+     *
+     * @param delegator - Delegating session
+     * @param target - Target session
+     * @returns True when it followed a nudge
+     */
+    recordDelegation(delegator: string | undefined, target: string | undefined): boolean;
+    /**
+     * Record work a lead keeps because no member fits.
+     *
+     * @param input - Lead session, team, reason, work, optional work item / ticket
+     * @returns The stored record
+     */
+    recordKeptWork(input: {
+        session: string;
+        teamId?: string;
+        reason: string;
+        work: string;
+        workItemId?: string;
+        ticket?: string;
+    }): KeptWorkRecord;
+    /**
+     * Kept-work records since a time, optionally for one team or set of sessions.
+     *
+     * @param sinceMs - Lower bound (epoch ms)
+     * @param filter - Team id and/or lead sessions (either matches)
+     * @returns Records, oldest first
+     */
+    keptWorkSince(sinceMs: number, filter?: {
+        teamId?: string;
+        sessions?: readonly string[];
+    }): KeptWorkRecord[];
+    /**
+     * Nudge counts of some sessions: all-time, and for one local day.
+     *
+     * @param sessions - Lead sessions
+     * @param dayMs - A time on the day to report (default: now)
+     * @returns Totals and that day's numbers
+     */
+    nudgeCounts(sessions: readonly string[], dayMs?: number): {
+        total: {
+            count: number;
+            followed: number;
+        };
+        day: {
+            count: number;
+            followed: number;
+        };
+    };
+    /** Wait for pending writes (tests, shutdown). */
+    flush(): Promise<void>;
+    /**
+     * Load the state once (a missing or broken file starts empty).
+     *
+     * @returns State
+     */
+    private load;
+    /** Write the state (serialized, best-effort). */
+    private save;
+}
+/**
+ * The availability of a member, as the nudge words it.
+ *
+ * @param m - Member
+ * @returns Availability
+ */
+export declare function memberAvailability(m: Pick<TeamMember, 'agentStatus' | 'workingStatus'>): NudgeMember['availability'];
+/**
+ * The lead context of a session among teams: the team it leads, with its
+ * other members. Null when it leads no team with other members.
+ *
+ * @param teams - Teams
+ * @param session - Agent session
+ * @returns Context, or null
+ */
+export declare function leadContextFromTeams(teams: readonly Team[], session: string): LeadContext | null;
+//# sourceMappingURL=tl-delegation.service.d.ts.map

package/dist/backend/backend/src/services/tl-delegation/tl-delegation.service.d.ts.map

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