crewly 1.20.160 → 1.20.162

package/dist/backend/backend/src/services/project-tickets/ticket-autopilot.service.d.ts

@@ -0,0 +1,286 @@
+/**
+ * Ticket autopilot (specs/2026-09-30-ticket-autopilot.md).
+ *
+ * A per-project switch (default off). While it is on:
+ * - the project's driver (its team lead) is woken with ONE `ticket_triage`
+ *   WorkItem listing the backlog tickets to decide (ready + assign, split,
+ *   ask the owner, cancel) — only when someone on the team is idle, at most
+ *   one live triage per project, at most every 30 min (sooner when a member
+ *   goes idle with nothing ready);
+ * - brakes hold: a daily USD budget over the team's agents (pauses the
+ *   autopilot and ticket auto-claim for the day, owner told once) and an
+ *   in-progress cap per member ({@link ProjectTicketAutopilotPolicy});
+ * - the owner gets the open `needs-owner` questions batched into one phone
+ *   message (at most every 2 h unless a new P0 one appears) and one evening
+ *   digest (skipped when nothing changed).
+ *
+ * The approval boundary is unchanged: the autopilot only wakes the lead and
+ * talks to the owner; it never makes a ticket ready or starts work itself.
+ *
+ * @module services/project-tickets/ticket-autopilot.service
+ */
+import { type ComponentLogger } from '../core/logger.service.js';
+import type { Project, Team } from '../../types/index.js';
+import { type WorkItem } from '../../types/v2/work-item.types.js';
+import type { ProjectTicketList } from '../../types/project-ticket.types.js';
+import { type ResolvedTicketAutopilotSettings, type TicketAutopilotSettingsInput } from '../../types/ticket-autopilot.types.js';
+import { type ProjectTicketAccess, type ProjectTicketAutopilotPolicy, type ProjectTicketCaller } from './project-ticket-workflow.service.js';
+import { type TriageDecision } from './ticket-autopilot-decision.js';
+/** The subset of the task pool the autopilot uses. */
+export interface TicketAutopilotPool {
+    addToPool(workItem: WorkItem): Promise<void>;
+    getAllItems(): Promise<WorkItem[]>;
+    cancelQueued(workItemId: string, reason: string): Promise<void>;
+}
+/** The subset of storage the autopilot uses. */
+export interface TicketAutopilotDirectory {
+    getTeams(): Promise<Team[]>;
+    getProjects(): Promise<Project[]>;
+    saveProject(project: Project): Promise<void>;
+}
+/** The ticket store (read only). */
+export interface TicketAutopilotTicketStore {
+    list(projectPath: string): Promise<ProjectTicketList>;
+}
+/** Project resolution + caller access (the ticket workflow). */
+export interface TicketAutopilotWorkflow {
+    resolveProject(ref: string): Promise<Project>;
+    accessOf(caller: ProjectTicketCaller, project: Project): Promise<{
+        access: ProjectTicketAccess;
+    }>;
+    setAutopilotPolicy?(policy: ProjectTicketAutopilotPolicy | null): void;
+}
+/** Token / cost ledger (see TokenUsageService.getSessionUsageSince). */
+export interface TicketAutopilotLedger {
+    getSessionUsageSince(sessionName: string, since: Date, until?: Date): {
+        cost: number;
+    };
+}
+/** A message to the owner through the usual owner-notification path. */
+export interface OwnerNotice {
+    title: string;
+    message: string;
+    urgent: boolean;
+}
+/** Dependencies. */
+export interface TicketAutopilotDeps {
+    tickets: TicketAutopilotTicketStore;
+    pool: TicketAutopilotPool;
+    directory: TicketAutopilotDirectory;
+    workflow: TicketAutopilotWorkflow;
+    ledger: TicketAutopilotLedger;
+    /** Sends to the owner; resolves false when it could not be sent (retried on the next tick) */
+    notifyOwner: (notice: OwnerNotice) => Promise<boolean>;
+    /** JSON file holding the autopilot's bookkeeping */
+    stateFile: string;
+    now?: () => Date;
+    logger?: ComponentLogger;
+}
+/** The driver of a project. */
+export interface ResolvedDriver {
+    session: string;
+    teamId: string;
+    source: 'setting' | 'team_lead';
+}
+/** What {@link TicketAutopilotService.getStatus} returns. */
+export interface TicketAutopilotStatus {
+    project: {
+        id: string;
+        name: string;
+        path: string;
+    };
+    settings: ResolvedTicketAutopilotSettings;
+    driver: ResolvedDriver | null;
+    spentTodayUsd: number;
+    pausedForToday: boolean;
+    triageInFlight: boolean;
+    lastTriageAt: string | null;
+}
+/** Outcome of one project evaluation. */
+export interface ProjectEvaluation {
+    projectId: string;
+    decision: TriageDecision;
+    /** The triage WorkItem created, when the decision was `triage` */
+    workItem?: WorkItem;
+}
+export declare class TicketAutopilotService {
+    private static instance;
+    private readonly deps;
+    private readonly logger;
+    private readonly now;
+    private state;
+    private timer;
+    /** Serialises evaluations so an idle event and the tick never create two triages */
+    private chain;
+    /**
+     * @param deps - Stores, pool, ledger, owner notifier, state file, clock
+     */
+    constructor(deps: TicketAutopilotDeps);
+    /**
+     * The wired process-wide instance, or null before boot wired it.
+     *
+     * @returns Instance or null
+     */
+    static getInstance(): TicketAutopilotService | null;
+    /**
+     * Install the process-wide instance (boot path).
+     *
+     * @param service - Instance, or null to clear (tests)
+     */
+    static setInstance(service: TicketAutopilotService | null): void;
+    /**
+     * Install the brakes on the ticket workflow and start the periodic tick.
+     *
+     * @param intervalMs - Tick interval (0 = no timer; tests call {@link tick})
+     */
+    start(intervalMs?: number): void;
+    /** Stop the tick and remove the brakes. */
+    stop(): void;
+    /**
+     * The brakes the ticket workflow asks about.
+     *
+     * @returns Policy bound to this service
+     */
+    policy(): ProjectTicketAutopilotPolicy;
+    /**
+     * The project's autopilot settings and live status.
+     *
+     * @param ref - Project id, name or path
+     * @param caller - Owner or orchestrator
+     * @returns Settings, driver, today's spend, pause / triage state
+     * @throws ProjectTicketError(403/404)
+     */
+    getStatus(ref: string, caller: ProjectTicketCaller): Promise<TicketAutopilotStatus>;
+    /**
+     * Change the project's autopilot settings.
+     *
+     * @param ref - Project id, name or path
+     * @param input - `enabled`, `driver`, `dailyBudgetUsd`, `maxInFlightPerMember` (null resets one)
+     * @param caller - Owner or orchestrator
+     * @returns The new status
+     * @throws ProjectTicketError(400) on invalid input or a driver who is not a lead of a project team; (403/404)
+     */
+    updateSettings(ref: string, input: TicketAutopilotSettingsInput, caller: ProjectTicketCaller): Promise<TicketAutopilotStatus>;
+    /**
+     * Periodic pass: evaluate every enabled project, then the owner questions
+     * and the daily digest.
+     *
+     * @returns Per-project evaluations
+     */
+    tick(): Promise<ProjectEvaluation[]>;
+    /**
+     * A member went idle and AutoClaim found nothing ready for it: evaluate
+     * the enabled projects it works on right away (bounded by
+     * {@link TICKET_AUTOPILOT_CONSTANTS.IDLE_TRIGGER_MIN_INTERVAL_MS}).
+     *
+     * @param session - The idle agent
+     * @returns Per-project evaluations
+     */
+    onMemberIdle(session: string): Promise<ProjectEvaluation[]>;
+    /**
+     * Evaluate one project and, when {@link decideTriage} says so, wake its
+     * driver with a triage WorkItem.
+     *
+     * @param project - Project (with its stored settings)
+     * @param trigger - Periodic tick or a member going idle
+     * @param idleSession - The member that just went idle
+     * @returns The decision (and the WorkItem when one was created)
+     */
+    private evaluateProject;
+    /**
+     * The project's live triage item, if any. A triage item still queued
+     * (never picked up) after {@link TICKET_AUTOPILOT_CONSTANTS.TRIAGE_STALE_QUEUED_MS}
+     * is cancelled so a fresh one can replace it.
+     *
+     * @param project - Project
+     * @param nowMs - Clock
+     * @returns The live item, or null
+     */
+    private liveTriageItem;
+    /**
+     * Send the batched owner questions of every enabled project when due.
+     *
+     * @param projects - Enabled projects
+     * @returns True when a batch went out
+     */
+    private processOwnerQuestions;
+    /**
+     * Send the evening digest of the enabled projects when due.
+     *
+     * @param projects - Enabled projects
+     * @returns True when a digest went out
+     */
+    private processDigest;
+    /**
+     * Tell the owner once per day that a project's autopilot paused on its budget.
+     *
+     * @param project - Project
+     * @param ps - Its bookkeeping
+     * @param spent - Spent today
+     * @param budget - Daily budget
+     * @param now - Clock
+     */
+    private noticeBudgetPaused;
+    /**
+     * The settings view plus live status of a project.
+     *
+     * @param project - Project
+     * @returns Status
+     */
+    private statusOf;
+    /**
+     * Refuse anyone but the owner and the orchestrator.
+     *
+     * @param caller - Caller
+     * @param project - Project
+     * @throws ProjectTicketError(403)
+     */
+    private requireOwnerOrOrc;
+    /**
+     * Non-archived teams working on a project.
+     *
+     * @param project - Project
+     * @returns Teams
+     */
+    private projectTeams;
+    /**
+     * A lead of one of the teams running as `session`.
+     *
+     * @param teams - Project teams
+     * @param session - Session
+     * @returns The team id, or null
+     */
+    private findLead;
+    /**
+     * Who triages: the configured driver (must be a lead of a project team),
+     * else the first lead found on the project's teams.
+     *
+     * @param settings - Resolved settings
+     * @param teams - Project teams
+     * @returns Driver, or null when there is none
+     */
+    private resolveDriver;
+    /**
+     * USD spent since local midnight by the agents of the given teams.
+     *
+     * @param teams - Teams
+     * @returns Spend
+     */
+    private spentToday;
+    /**
+     * Run `fn` after every evaluation queued before it.
+     *
+     * @param fn - Work
+     * @returns Its result
+     */
+    private serial;
+    /**
+     * Load the bookkeeping (once per process).
+     *
+     * @returns State
+     */
+    private loadState;
+    /** Persist the bookkeeping (best-effort). */
+    private saveState;
+}
+//# sourceMappingURL=ticket-autopilot.service.d.ts.map

package/dist/backend/backend/src/services/project-tickets/ticket-autopilot.service.d.ts.map

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