crewly 1.20.211 → 1.20.213

package/dist/backend/backend/src/services/team/team-pause.registry.js

@@ -0,0 +1,263 @@
+/**
+ * Paused teams — the in-memory index every automation path consults
+ * (specs/2026-10-04-team-pause.md).
+ *
+ * The pause itself is stored on the team (`Team.paused`, persisted in the
+ * team's config.json), so it survives restarts. This module keeps a
+ * synchronous index of it — team id → pause, and every session name a
+ * member of a paused team may run under → team — because most of the gates
+ * (the reconciler's wake rule, the queued-message wake, the dispatcher's
+ * target planning) only have a session name and must not await storage.
+ *
+ * The index is rebuilt from storage: {@link syncPausedTeams} runs on every
+ * `StorageService.getTeams()` read and at boot, and {@link notePausedTeam}
+ * on every save. A pause whose `until` has passed counts as resumed at once,
+ * before the auto-resume sweep clears it from storage.
+ *
+ * Module-level and dependency-free (types and two utils only), so the team
+ * controller, the storage service and the services can share it without
+ * import cycles.
+ *
+ * @module services/team/team-pause.registry
+ */
+import { deriveMemberSessionName } from '../../utils/member-session-name.utils.js';
+const pausedTeams = new Map();
+const teamOfSession = new Map();
+/** Every known team (id → name, archived), for the owner's Slack commands */
+const knownTeams = new Map();
+/**
+ * Whether a pause is in force at `now` (set, and its `until` not reached).
+ *
+ * @param pause - The team's pause, if any
+ * @param now - Clock (ms)
+ * @returns True while paused
+ *
+ * @example
+ * isPauseActive({ pausedAt: '…', by: 'owner', until: '2099-01-01T00:00:00Z' }) // true
+ */
+export function isPauseActive(pause, now = Date.now()) {
+    if (!pause || !pause.pausedAt)
+        return false;
+    if (!pause.until)
+        return true;
+    const until = Date.parse(pause.until);
+    return Number.isNaN(until) || until > now;
+}
+/**
+ * Whether a team object is paused now. Prefer this where the team is at
+ * hand: it reads the team itself, not the index.
+ *
+ * @param team - Team (only `paused` is read)
+ * @param now - Clock (ms)
+ * @returns True while paused
+ */
+export function isTeamPausedNow(team, now = Date.now()) {
+    return isPauseActive(team?.paused, now);
+}
+/**
+ * Every session name a member may run under: its live session, its
+ * permanent agent id, and the name the controller derives on start.
+ *
+ * @param teamName - Team display name
+ * @param member - Member
+ * @returns Distinct, non-empty session names
+ */
+export function memberSessionKeys(teamName, member) {
+    const keys = [member.sessionName, member.agentId, member.id ? deriveMemberSessionName(teamName, member.name, member.id) : undefined];
+    return [...new Set(keys.filter((k) => typeof k === 'string' && k.length > 0))];
+}
+/**
+ * Build the index entry for a team (whether or not it is paused).
+ *
+ * @param team - Team with a pause
+ * @returns Entry
+ */
+function entryOf(team) {
+    const sessions = new Set();
+    for (const m of team.members ?? [])
+        for (const k of memberSessionKeys(team.name, m))
+            sessions.add(k);
+    return {
+        teamId: team.id,
+        teamName: team.name || team.id,
+        ...(team.issueRepo ? { issueRepo: team.issueRepo } : {}),
+        pause: team.paused,
+        sessions: [...sessions],
+        memberNames: (team.members ?? []).map((m) => m.name).filter(Boolean),
+    };
+}
+/**
+ * Remove a team from the index.
+ *
+ * @param teamId - Team
+ */
+function forget(teamId) {
+    const prev = pausedTeams.get(teamId);
+    if (!prev)
+        return;
+    for (const s of prev.sessions)
+        if (teamOfSession.get(s) === teamId)
+            teamOfSession.delete(s);
+    pausedTeams.delete(teamId);
+}
+/**
+ * Update the index for one team (after a save). A team that is not paused
+ * is removed from it.
+ *
+ * @param team - The saved team
+ */
+export function notePausedTeam(team) {
+    if (!team?.id)
+        return;
+    knownTeams.set(team.id, { name: team.name || team.id, archived: !!team.archived });
+    forget(team.id);
+    if (!team.paused)
+        return;
+    const entry = entryOf(team);
+    pausedTeams.set(team.id, entry);
+    for (const s of entry.sessions)
+        teamOfSession.set(s, team.id);
+}
+/**
+ * Forget a deleted team.
+ *
+ * @param teamId - Deleted team
+ */
+export function noteTeamDeleted(teamId) {
+    forget(teamId);
+    knownTeams.delete(teamId);
+}
+/**
+ * Every team the index has seen (id and name), archived ones excluded.
+ *
+ * @returns Teams
+ */
+export function listKnownTeams() {
+    return [...knownTeams.entries()].filter(([, t]) => !t.archived).map(([id, t]) => ({ id, name: t.name }));
+}
+/**
+ * Rebuild the index from a full team list (a storage read, boot).
+ *
+ * @param teams - Every stored team
+ */
+export function syncPausedTeams(teams) {
+    pausedTeams.clear();
+    teamOfSession.clear();
+    knownTeams.clear();
+    for (const team of teams)
+        notePausedTeam(team);
+}
+/**
+ * The paused team with this id, if its pause is in force.
+ *
+ * @param teamId - Team id
+ * @param now - Clock (ms)
+ * @returns Info, or null
+ */
+export function pausedTeamById(teamId, now = Date.now()) {
+    if (!teamId)
+        return null;
+    const entry = pausedTeams.get(teamId);
+    return entry && isPauseActive(entry.pause, now) ? entry : null;
+}
+/**
+ * Whether the team with this id is paused now.
+ *
+ * @param teamId - Team id
+ * @returns True while paused
+ */
+export function isTeamIdPaused(teamId) {
+    return pausedTeamById(teamId) !== null;
+}
+/**
+ * The paused team a session belongs to, if its pause is in force.
+ *
+ * @param session - Agent session (or agent id)
+ * @param now - Clock (ms)
+ * @returns Info, or null
+ */
+export function pausedTeamOfSession(session, now = Date.now()) {
+    if (!session)
+        return null;
+    const teamId = teamOfSession.get(session);
+    return teamId ? pausedTeamById(teamId, now) : null;
+}
+/**
+ * Whether a session belongs to a paused team.
+ *
+ * @param session - Agent session (or agent id)
+ * @returns True while its team is paused
+ *
+ * @example
+ * if (isSessionPaused(wi.target)) return false; // do not dispatch
+ */
+export function isSessionPaused(session) {
+    return pausedTeamOfSession(session) !== null;
+}
+/**
+ * The paused team named by an id, a name (case-insensitive) or a member
+ * session — whatever an agent typed.
+ *
+ * @param ref - Team id, team name, or member session
+ * @returns Info, or null
+ */
+export function pausedTeamByRef(ref) {
+    if (!ref)
+        return null;
+    const byId = pausedTeamById(ref) ?? pausedTeamOfSession(ref);
+    if (byId)
+        return byId;
+    const want = ref.trim().toLowerCase();
+    for (const entry of pausedTeams.values()) {
+        if (entry.teamName.toLowerCase() === want && isPauseActive(entry.pause))
+            return entry;
+    }
+    return null;
+}
+/**
+ * Every team paused now.
+ *
+ * @param now - Clock (ms)
+ * @returns Infos
+ */
+export function listPausedTeams(now = Date.now()) {
+    return [...pausedTeams.values()].filter((e) => isPauseActive(e.pause, now));
+}
+/**
+ * Teams whose pause has an `until` that has passed (still stored as paused).
+ *
+ * @param now - Clock (ms)
+ * @returns Infos due for auto-resume
+ */
+export function listExpiredPauses(now = Date.now()) {
+    return [...pausedTeams.values()].filter((e) => !isPauseActive(e.pause, now));
+}
+/**
+ * The refusal an agent gets when it targets a paused team (English: harness
+ * text rule).
+ *
+ * @param info - The paused team
+ * @param options - `callerIsOrc`: the orchestrator asked (it tells the owner, not itself)
+ * @returns Message
+ *
+ * @example
+ * pausedRefusalMessage({ teamName: 'Crewly', issueRepo: 'stevehuang0115/crewly' })
+ * // 'Crewly is paused by the owner. File a GitHub issue instead: `gh issue create -R stevehuang0115/crewly --title "…" --body "…"`'
+ */
+export function pausedRefusalMessage(info, options = {}) {
+    const until = info.pause?.until ? ` until ${info.pause.until}` : '';
+    const head = `${info.teamName} is paused by the owner${until}.`;
+    if (info.issueRepo) {
+        return `${head} File a GitHub issue instead: \`gh issue create -R ${info.issueRepo} --title "<short title>" --body "<what is needed and why>"\``;
+    }
+    return options.callerIsOrc
+        ? `${head} Do not hand it work or wake it. If this cannot wait until the owner resumes it, tell the owner.`
+        : `${head} Do not hand it work. Tell the orc what you need instead.`;
+}
+/** Clear the index (tests only). */
+export function resetTeamPauseRegistryForTesting() {
+    pausedTeams.clear();
+    teamOfSession.clear();
+    knownTeams.clear();
+}
+//# sourceMappingURL=team-pause.registry.js.map

package/dist/backend/backend/src/services/team/team-pause.registry.js.map

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

package/dist/backend/backend/src/services/team/team-pause.service.d.ts

@@ -0,0 +1,172 @@
+/**
+ * Pause and resume a team (specs/2026-10-04-team-pause.md).
+ *
+ * The owner pauses a team — from the dashboard, the API or a DM to the orc —
+ * when its work is handled elsewhere for a while (the Crewly product team
+ * while a separate harness session works on the harness). While paused:
+ *
+ * - its members are not started by automation (the start path refuses
+ *   unless the owner asks), and automation does not route work to it;
+ * - other agents do not see it, and an agent that targets it is told to
+ *   file a GitHub issue (or tell the orc) instead.
+ *
+ * Pausing stores `Team.paused`, stops the running members the way stop-team
+ * does, and unassigns work that has not started: queued WorkItems go back to
+ * the unassigned pool (the router picks a decider that is not paused), and
+ * backlog / ready tickets lose their assignee. Running work stays where it
+ * is, for the owner to see. Resuming clears the pause; an `until` time
+ * resumes the team by itself ({@link TeamPauseService.sweepExpired}).
+ *
+ * @module services/team/team-pause.service
+ */
+import type { Team, TeamMember } from '../../types/index.js';
+/** A refused pause / resume (HTTP status + English message). */
+export declare class TeamPauseError extends Error {
+    readonly status: number;
+    /**
+     * @param status - HTTP status (400 bad input, 404 unknown team)
+     * @param message - Reason
+     */
+    constructor(status: number, message: string);
+}
+/** Pause options. */
+export interface PauseTeamInput {
+    reason?: string;
+    /** ISO time (or anything `Date.parse` reads) the pause ends by itself */
+    until?: string;
+}
+/** What a pause did. */
+export interface PauseTeamOutcome {
+    team: Team;
+    /** The team was already paused (reason / until updated) */
+    alreadyPaused: boolean;
+    /** Members whose running session was stopped */
+    stopped: string[];
+    /** Members whose session could not be stopped */
+    stopFailed: Array<{
+        member: string;
+        error: string;
+    }>;
+    /** Queued WorkItems unassigned */
+    releasedWorkItems: string[];
+    /** Tickets unassigned (or put back to ready) */
+    releasedTickets: string[];
+}
+/** What a resume did. */
+export interface ResumeTeamOutcome {
+    team: Team;
+    /** The team was not paused */
+    wasPaused: boolean;
+    /** The pause ran out (`until`), not an owner action */
+    auto: boolean;
+}
+/** Collaborators. */
+export interface TeamPauseServiceDeps {
+    storage: {
+        getTeams(): Promise<Team[]>;
+        saveTeam(team: Team): Promise<void>;
+    };
+    /** Stop one member's running session, the way stop-team does */
+    stopMember: (team: Team, member: TeamMember) => Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /** Unassign queued (unstarted) WorkItems targeting these sessions; returns their ids */
+    releaseWorkItems?: (sessions: ReadonlySet<string>, team: Team) => Promise<string[]>;
+    /** Unassign unstarted tickets assigned to these sessions; returns `<project>/<id>` refs */
+    releaseTickets?: (sessions: ReadonlySet<string>, team: Team) => Promise<string[]>;
+    /** Tell the owner (auto-resume); best effort */
+    notifyOwner?: (text: string) => Promise<unknown>;
+    logger?: {
+        info(msg: string, meta?: Record<string, unknown>): void;
+        warn(msg: string, meta?: Record<string, unknown>): void;
+    };
+    now?: () => number;
+}
+/**
+ * Find a team by id, by name (case-insensitive), or by a unique name prefix.
+ *
+ * @param teams - Every team
+ * @param ref - What the owner typed
+ * @returns The team, or null
+ */
+export declare function findTeamByRef(teams: readonly Team[], ref: string): Team | null;
+/**
+ * Every session name a team's members may run under.
+ *
+ * @param team - Team
+ * @returns Sessions
+ */
+export declare function teamSessionKeys(team: Team): Set<string>;
+/** The team pause service. */
+export declare class TeamPauseService {
+    private readonly deps;
+    private timer;
+    /**
+     * @param deps - Collaborators
+     */
+    constructor(deps: TeamPauseServiceDeps);
+    /**
+     * Resolve a team reference or throw 404.
+     *
+     * @param ref - Team id or name
+     * @returns The stored team
+     */
+    resolveTeam(ref: string): Promise<Team>;
+    /**
+     * Pause a team: store the pause, stop its running members, unassign its
+     * unstarted work. Pausing a paused team updates its reason / until.
+     *
+     * @param ref - Team id or name
+     * @param input - Reason and until
+     * @returns What was done
+     * @throws TeamPauseError on bad input or an unknown team
+     */
+    pause(ref: string, input?: PauseTeamInput): Promise<PauseTeamOutcome>;
+    /**
+     * Resume a team. Its members are not started: they start when there is
+     * work for them or the owner starts them, as before the pause.
+     *
+     * @param ref - Team id or name
+     * @param options - `auto`: the pause ran out
+     * @returns What was done
+     * @throws TeamPauseError(404) for an unknown team
+     */
+    resume(ref: string, options?: {
+        auto?: boolean;
+    }): Promise<ResumeTeamOutcome>;
+    /**
+     * Resume every team whose `until` has passed, and tell the owner.
+     *
+     * @returns Names of the teams resumed
+     */
+    sweepExpired(): Promise<string[]>;
+    /** Start the auto-resume sweep (runs once now, then every minute). */
+    start(): void;
+    /** Stop the sweep. */
+    stop(): void;
+    /**
+     * Run one release step; a failure is logged, never thrown.
+     *
+     * @param what - For the log
+     * @param fn - The step
+     * @param team - Team
+     * @returns Released ids
+     */
+    private release;
+    /** @returns Clock (ms) */
+    private now;
+}
+/**
+ * The wired service.
+ *
+ * @returns Service, or null before the server wired it
+ */
+export declare function getTeamPauseService(): TeamPauseService | null;
+/**
+ * Install (or clear) the service.
+ *
+ * @param service - Service, null to clear (tests)
+ */
+export declare function setTeamPauseService(service: TeamPauseService | null): void;
+//# sourceMappingURL=team-pause.service.d.ts.map

package/dist/backend/backend/src/services/team/team-pause.service.d.ts.map

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