crewly 1.20.161 → 1.20.163

package/dist/backend/backend/src/services/project-tickets/ticket-autopilot-messages.js

@@ -0,0 +1,195 @@
+/**
+ * Ticket autopilot — the texts (specs/2026-09-30-ticket-autopilot.md §3, §5):
+ * the driver's triage brief, the owner's batched questions and the evening
+ * digest. Pure functions; the owner-facing texts are phone-sized and carry no
+ * harness mechanics (no WorkItem ids, claims or pool states).
+ *
+ * @module services/project-tickets/ticket-autopilot-messages
+ */
+import { TICKET_AUTOPILOT_CONSTANTS } from '../../constants.js';
+/**
+ * Actions that need the owner's explicit OK even with the autopilot on.
+ * Spelled out in the triage brief and in the team-leader prompt.
+ */
+export const TICKET_AUTOPILOT_BOUNDARIES = [
+    'sending email or messages to outside people',
+    'publishing content publicly',
+    'deploying to production',
+    'spending money',
+];
+/**
+ * Human age of a timestamp ("3h", "2d").
+ *
+ * @param iso - ISO time
+ * @param now - Clock (epoch ms)
+ * @returns Short age, or "?" when unreadable
+ */
+export function formatAge(iso, now) {
+    const t = Date.parse(iso);
+    if (!Number.isFinite(t))
+        return '?';
+    const minutes = Math.max(0, Math.floor((now - t) / 60_000));
+    if (minutes < 60)
+        return `${minutes}m`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 48)
+        return `${hours}h`;
+    return `${Math.floor(hours / 24)}d`;
+}
+/**
+ * Who created a ticket, for the brief.
+ *
+ * @param source - Ticket `source`
+ * @returns `owner`, the agent session, the request, or `unknown`
+ */
+function creatorOf(source) {
+    if (!source)
+        return 'unknown';
+    if (source.startsWith('agent:'))
+        return source.slice('agent:'.length);
+    return source;
+}
+/**
+ * Shorten free text to one excerpt line.
+ *
+ * @param text - Text
+ * @param max - Max characters
+ * @returns Single-line excerpt
+ */
+function excerpt(text, max) {
+    const flat = text.replace(/\s+/g, ' ').trim();
+    return flat.length > max ? `${flat.slice(0, max - 1)}…` : flat;
+}
+/**
+ * The triage brief the driver receives (WorkItem `briefMarkdown`).
+ *
+ * @param input - Project, tickets, team, limits, clock
+ * @returns Markdown brief
+ */
+export function buildTriageBrief(input) {
+    const p = input.project.id;
+    const tk = '$AGENT_SKILLS_PATH/core/project-tickets/execute.sh';
+    const lines = [
+        `# Ticket triage — ${input.project.name} (${input.candidates.length} ticket${input.candidates.length === 1 ? '' : 's'})`,
+        '',
+        'Ticket autopilot is on for this project: you keep its backlog moving while the owner is away (on a phone).',
+        'Decide every ticket below, then complete this WorkItem (complete-task with its id) with one line per ticket saying what you did.',
+        '',
+        '## For each ticket, do one of these',
+        '',
+        `1. **Ready + assign** — \`bash ${tk} assign --project ${p} --id <ID> --to <member>\`, or \`… update --project ${p} --id <ID> --status ready\` to let the next idle member take it. At most ${input.maxInFlightPerMember} ticket${input.maxInFlightPerMember === 1 ? '' : 's'} in progress per member.`,
+        `2. **Split** — create smaller tickets (\`… create --project ${p} --title "…" --acceptance "…" --status ready\`), then cancel the original with a note naming the new ids.`,
+        `3. **Needs the owner** — \`bash ${tk} ask-owner --project ${p} --id <ID> --question "<one line the owner can answer with a tap or a word>"\`. Crewly batches these to the owner's phone; do not message the owner about them yourself.`,
+        `4. **Cancel** — \`… update --project ${p} --id <ID> --status cancelled --note "<reason>"\`.`,
+        '',
+        '## Boundaries — the autopilot does NOT lift these',
+        '',
+        'Even with the autopilot on, these need the owner\'s explicit OK:',
+        ...TICKET_AUTOPILOT_BOUNDARIES.map((b) => `- ${b};`),
+        '',
+        'A ticket whose completion needs one of these may be worked up to a draft or a PR; then use ask-owner for the final step.',
+        '"The autopilot is on" is never that OK, and neither is your own judgement.',
+        '',
+        'Tickets marked **worker-created — review first** were filed by a team member, not by the owner, a lead or the orchestrator.',
+        'Check that they are wanted and in scope before making them ready; if unsure, ask the owner.',
+        '',
+        '## Team',
+        '',
+        ...(input.members.length > 0
+            ? input.members.map((m) => `- ${m.session}${m.name && m.name !== m.session ? ` (${m.name}${m.role ? `, ${m.role}` : ''})` : m.role ? ` (${m.role})` : ''} — ${m.idle ? 'idle' : 'busy'}, ${m.inFlight} in progress`)
+            : ['- (no members found)']),
+        '',
+        '## Tickets',
+        '',
+    ];
+    for (const c of input.candidates) {
+        const t = c.ticket;
+        const why = c.reason === 'backlog' ? 'backlog' : c.reason === 'ready_no_taker' ? 'ready, but nobody on the team can take it' : 'ready, but nobody has taken it for a day';
+        lines.push(`### ${t.id} · ${t.priority} · ${why} · ${formatAge(t.createdAt, input.now)} old`);
+        lines.push(t.title);
+        const meta = [`created by ${creatorOf(t.source)}`];
+        if (t.labels.length > 0)
+            meta.push(`labels: ${t.labels.join(', ')}`);
+        if (t.team)
+            meta.push(`team: ${t.team}`);
+        lines.push(`${meta.join(' · ')}${c.workerCreated ? ' · **worker-created — review first**' : ''}`);
+        if (t.description)
+            lines.push(`> ${excerpt(t.description, TICKET_AUTOPILOT_CONSTANTS.TRIAGE_DESCRIPTION_EXCERPT_CHARS)}`);
+        lines.push('');
+    }
+    if (input.more > 0)
+        lines.push(`${input.more} more ticket${input.more === 1 ? '' : 's'} will come in the next triage.`, '');
+    lines.push(`Full ticket: \`bash ${tk} show --project ${p} --id <ID>\`.`);
+    return lines.join('\n');
+}
+/**
+ * The one batched message with every open owner question — numbered, short,
+ * answerable with a tap or a word.
+ *
+ * @param items - Questions (already ordered)
+ * @returns Message text
+ */
+export function buildOwnerQuestionsMessage(items) {
+    const multiProject = new Set(items.map((i) => i.projectName)).size > 1;
+    const lines = [
+        items.length === 1 ? 'One ticket is waiting on you:' : `${items.length} tickets are waiting on you:`,
+        '',
+        ...items.map((q, i) => `${i + 1}. ${q.ticketId}${multiProject ? ` (${q.projectName})` : ''} ${excerpt(q.title, 60)} — ${q.question}`),
+        '',
+        'Reply with the number and your answer (e.g. "1 yes").',
+    ];
+    return lines.join('\n');
+}
+/**
+ * One digest section line: count plus the first few tickets.
+ *
+ * @param label - Section label
+ * @param tickets - Tickets
+ * @param withAssignee - Append the assignee
+ * @returns Line, or null when empty
+ */
+function digestSection(label, tickets, withAssignee) {
+    if (tickets.length === 0)
+        return null;
+    const max = TICKET_AUTOPILOT_CONSTANTS.DIGEST_MAX_ITEMS_PER_SECTION;
+    const named = tickets
+        .slice(0, max)
+        .map((t) => `${t.id} ${excerpt(t.title, 50)}${withAssignee && t.assignee ? ` (${t.assignee})` : ''}`);
+    const rest = tickets.length > max ? `; +${tickets.length - max} more` : '';
+    return `${label} (${tickets.length}): ${named.join('; ')}${rest}`;
+}
+/**
+ * The evening digest: per project, done today / in progress / waiting on the
+ * owner. Projects with nothing to report are left out.
+ *
+ * @param projects - Per-project sections
+ * @returns Message text, or null when there is nothing to say
+ */
+export function buildDigestMessage(projects) {
+    const blocks = [];
+    for (const p of projects) {
+        const rows = [
+            digestSection('Done today', p.doneToday, false),
+            digestSection('In progress', p.inProgress, true),
+            digestSection('Waiting on you', p.waitingOnOwner, false),
+        ].filter((r) => r !== null);
+        if (rows.length === 0)
+            continue;
+        blocks.push([`*${p.name}*`, ...rows.map((r) => `- ${r}`)].join('\n'));
+    }
+    if (blocks.length === 0)
+        return null;
+    return ['Tickets today', '', blocks.join('\n\n')].join('\n');
+}
+/**
+ * The once-a-day notice that the autopilot paused on its budget.
+ *
+ * @param projectName - Project
+ * @param spentUsd - Spent today
+ * @param budgetUsd - Daily budget
+ * @returns Message text
+ */
+export function buildBudgetPausedMessage(projectName, spentUsd, budgetUsd) {
+    return `Ticket autopilot paused for today on ${projectName}: the team has used $${spentUsd.toFixed(2)} of its $${budgetUsd.toFixed(2)} daily budget. It picks up again tomorrow. Reply "raise the budget to $N" to change it.`;
+}
+//# sourceMappingURL=ticket-autopilot-messages.js.map

package/dist/backend/backend/src/services/project-tickets/ticket-autopilot-messages.js.map

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

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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"}