crewly 1.6.0 → 1.6.2

package/dist/backend/backend/src/types/v2/work-item.types.js

@@ -62,7 +62,12 @@ export const WORK_ITEM_TRANSITIONS = {
     scheduled: new Set(['queued', 'cancelled']),
     proposed: new Set(['accepted', 'rejected', 'cancelled']),
     accepted: new Set(['running', 'cancelled']),
-    running: new Set(['done', 'done_by_worker', 'failed', 'blocked', 'escalated', 'cancelled']),
+    // TRANS-2: `running → queued` legalised so TaskPoolService.releaseBack
+    // (Reconciler abandon path, controller-initiated agent-busy releases)
+    // can route through the guarded {@link transitionStatus} helper. Gated
+    // in TRANSITION_PERMISSIONS to TL/orchestrator/system — agents cannot
+    // self-revive a running claim.
+    running: new Set(['done', 'done_by_worker', 'failed', 'blocked', 'escalated', 'cancelled', 'queued']),
     blocked: new Set(['queued', 'cancelled']),
     escalated: new Set(['queued', 'cancelled']),
     done_by_worker: new Set(['verified', 'rejected']),
@@ -97,6 +102,25 @@ export const TRANSITION_PERMISSIONS = {
     'done_by_worker→rejected': new Set(['team_lead']),
     // Simple done — allowed for agents (simple tasks) and system (reconciler)
     'running→done': new Set(['agent', 'system', 'orchestrator']),
+    // TRANS-1 F-F: only TL / orchestrator / system may re-queue a rejected
+    // WorkItem. Without this entry, the backward-compat default-allow at
+    // isTransitionPermitted line ~322 lets any actor (including the agent
+    // whose work was rejected) re-queue itself — a self-revival hazard.
+    // BRIDGE-1 retry policy is the canonical re-queueing path; manual
+    // TL action (or system reconciler) is the only other legal path.
+    'rejected→queued': new Set(['team_lead', 'orchestrator', 'system']),
+    // failed→queued (BRIDGE-1 retry path) — same gate as rejected→queued.
+    // Agent cannot self-resurrect a failed WorkItem.
+    'failed→queued': new Set(['team_lead', 'orchestrator', 'system']),
+    // blocked→queued (dependency-resolution path) — system-only by
+    // default. The TaskPoolService.resolveBlockedDependents() helper
+    // is the canonical caller and runs as system.
+    'blocked→queued': new Set(['team_lead', 'orchestrator', 'system']),
+    // TRANS-2: running→queued (releaseBack abandon path). Same gate as
+    // the other re-queue transitions — Reconciler revoke and TL manual
+    // release are the legitimate callers; agents cannot self-revive a
+    // running claim by re-queueing it.
+    'running→queued': new Set(['team_lead', 'orchestrator', 'system']),
 };
 /**
  * Checks whether a role is permitted to trigger a specific status transition.

package/dist/backend/backend/src/types/v2/work-item.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"work-item.types.js","sourceRoot":"","sources":["../../../../../../backend/src/types/v2/work-item.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"work-item.types.js","sourceRoot":"","sources":["../../../../../../backend/src/types/v2/work-item.types.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/utils/google-userinfo.utils.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Google Userinfo Helper
+ *
+ * Fetches the signed-in user's email from Google's userinfo endpoint given a
+ * valid OAuth access token. Best-effort: returns `undefined` on network or
+ * HTTP error so callers can proceed without an account email when the grant
+ * is still valid.
+ *
+ * Used by both the credentials controller (headless OAuth completion) and
+ * the Gemini CLI Workspace helper (token capture) so the fetch + parsing
+ * logic lives in one place.
+ *
+ * @module utils/google-userinfo.utils
+ */
+/**
+ * Minimal fetch-compatible function shape — injectable for tests and to
+ * match the `FetchLike` shape used by the Gemini CLI helper.
+ */
+export type FetchLike = (url: string, init?: {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    text(): Promise<string>;
+    json(): Promise<unknown>;
+}>;
+/**
+ * Fetch the account email associated with the given OAuth access token.
+ *
+ * Best-effort: returns `undefined` on network failure, non-2xx response,
+ * or a response missing the `email` field. Never throws.
+ *
+ * @param accessToken - A valid Google OAuth access token with a scope that
+ *                      grants `userinfo.email` (e.g. openid/email).
+ * @param fetchImpl - Injectable fetch (defaults to the global `fetch`).
+ * @returns The account email, or `undefined` if it cannot be determined.
+ */
+export declare function fetchGoogleAccountEmail(accessToken: string, fetchImpl?: FetchLike): Promise<string | undefined>;
+//# sourceMappingURL=google-userinfo.utils.d.ts.map

package/dist/backend/backend/src/utils/google-userinfo.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-userinfo.utils.d.ts","sourceRoot":"","sources":["../../../../../backend/src/utils/google-userinfo.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,CACtB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE;IACL,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,KACE,OAAO,CAAC;IACX,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1B,CAAC,CAAC;AAEH;;;;;;;;;;GAUG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,SAAS,GACpB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAiB7B"}

package/dist/backend/backend/src/utils/google-userinfo.utils.js

@@ -0,0 +1,44 @@
+/**
+ * Google Userinfo Helper
+ *
+ * Fetches the signed-in user's email from Google's userinfo endpoint given a
+ * valid OAuth access token. Best-effort: returns `undefined` on network or
+ * HTTP error so callers can proceed without an account email when the grant
+ * is still valid.
+ *
+ * Used by both the credentials controller (headless OAuth completion) and
+ * the Gemini CLI Workspace helper (token capture) so the fetch + parsing
+ * logic lives in one place.
+ *
+ * @module utils/google-userinfo.utils
+ */
+import { GOOGLE_USERINFO_ENDPOINT } from '../config/oauth.config.js';
+/**
+ * Fetch the account email associated with the given OAuth access token.
+ *
+ * Best-effort: returns `undefined` on network failure, non-2xx response,
+ * or a response missing the `email` field. Never throws.
+ *
+ * @param accessToken - A valid Google OAuth access token with a scope that
+ *                      grants `userinfo.email` (e.g. openid/email).
+ * @param fetchImpl - Injectable fetch (defaults to the global `fetch`).
+ * @returns The account email, or `undefined` if it cannot be determined.
+ */
+export async function fetchGoogleAccountEmail(accessToken, fetchImpl) {
+    const doFetch = fetchImpl ??
+        ((url, init) => fetch(url, init));
+    try {
+        const response = await doFetch(GOOGLE_USERINFO_ENDPOINT, {
+            method: 'GET',
+            headers: { Authorization: `Bearer ${accessToken}` },
+        });
+        if (!response.ok)
+            return undefined;
+        const data = (await response.json());
+        return data.email;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=google-userinfo.utils.js.map

package/dist/backend/backend/src/utils/google-userinfo.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-userinfo.utils.js","sourceRoot":"","sources":["../../../../../backend/src/utils/google-userinfo.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAoBrE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,WAAmB,EACnB,SAAqB;IAErB,MAAM,OAAO,GACX,SAAS;QACT,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CACb,KAAK,CAAC,GAAG,EAAE,IAAmB,CAAqC,CAAC,CAAC;IAEzE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,wBAAwB,EAAE;YACvD,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,WAAW,EAAE,EAAE;SACpD,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,OAAO,SAAS,CAAC;QACnC,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAuB,CAAC;QAC3D,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/backend/backend/src/utils/team.utils.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Team utility helpers
+ *
+ * Shared, dependency-free helpers operating on the `Team` / `TeamMember`
+ * shape. These are extracted here so multiple call sites (chat-v2 mention
+ * resolver, mission OKR reminder service, …) can share a single canonical
+ * implementation instead of drifting over time.
+ *
+ * @module utils/team.utils
+ */
+import type { Team, TeamMember } from '../types/index.js';
+/**
+ * Choose the TL (Team Lead) responder for a team.
+ *
+ * Resolution rules (ordered, first match wins):
+ *   1. Hierarchy TL: `hierarchyLevel === 1 && canDelegate === true`.
+ *   2. Any delegator: `canDelegate === true` regardless of level. Covers
+ *      teams that were imported before hierarchy fields were added but
+ *      already have a flagged TL.
+ *   3. Role-tagged TL: `role === 'team-leader'` so role-based teams that
+ *      didn't fill in `canDelegate` still resolve correctly.
+ *   4. First member: deterministic last resort — better to dispatch to
+ *      _someone_ than silently drop a `@team` ping. Tests cover this
+ *      case.
+ *
+ * Returns `null` only when the team has no members at all.
+ *
+ * @param team - The matched team.
+ * @returns The TL to dispatch to, or `null` when the team has no members.
+ *
+ * @example
+ * ```typescript
+ * const tl = pickTeamLead(team);
+ * if (tl) await sendNotification({ to: tl.sessionName });
+ * ```
+ */
+export declare function pickTeamLead(team: Team): TeamMember | null;
+//# sourceMappingURL=team.utils.d.ts.map

package/dist/backend/backend/src/utils/team.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team.utils.d.ts","sourceRoot":"","sources":["../../../../../backend/src/utils/team.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,UAAU,GAAG,IAAI,CAU1D"}

package/dist/backend/backend/src/utils/team.utils.js

@@ -0,0 +1,45 @@
+/**
+ * Team utility helpers
+ *
+ * Shared, dependency-free helpers operating on the `Team` / `TeamMember`
+ * shape. These are extracted here so multiple call sites (chat-v2 mention
+ * resolver, mission OKR reminder service, …) can share a single canonical
+ * implementation instead of drifting over time.
+ *
+ * @module utils/team.utils
+ */
+/**
+ * Choose the TL (Team Lead) responder for a team.
+ *
+ * Resolution rules (ordered, first match wins):
+ *   1. Hierarchy TL: `hierarchyLevel === 1 && canDelegate === true`.
+ *   2. Any delegator: `canDelegate === true` regardless of level. Covers
+ *      teams that were imported before hierarchy fields were added but
+ *      already have a flagged TL.
+ *   3. Role-tagged TL: `role === 'team-leader'` so role-based teams that
+ *      didn't fill in `canDelegate` still resolve correctly.
+ *   4. First member: deterministic last resort — better to dispatch to
+ *      _someone_ than silently drop a `@team` ping. Tests cover this
+ *      case.
+ *
+ * Returns `null` only when the team has no members at all.
+ *
+ * @param team - The matched team.
+ * @returns The TL to dispatch to, or `null` when the team has no members.
+ *
+ * @example
+ * ```typescript
+ * const tl = pickTeamLead(team);
+ * if (tl) await sendNotification({ to: tl.sessionName });
+ * ```
+ */
+export function pickTeamLead(team) {
+    const members = team.members ?? [];
+    if (members.length === 0)
+        return null;
+    return (members.find((m) => m.hierarchyLevel === 1 && m.canDelegate === true) ??
+        members.find((m) => m.canDelegate === true) ??
+        members.find((m) => m.role === 'team-leader') ??
+        members[0]);
+}
+//# sourceMappingURL=team.utils.js.map

package/dist/backend/backend/src/utils/team.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"team.utils.js","sourceRoot":"","sources":["../../../../../backend/src/utils/team.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,YAAY,CAAC,IAAU;IACrC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IACnC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEtC,OAAO,CACL,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,KAAK,CAAC,IAAI,CAAC,CAAC,WAAW,KAAK,IAAI,CAAC;QACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,IAAI,CAAC;QAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC;QAC7C,OAAO,CAAC,CAAC,CAAC,CACX,CAAC;AACJ,CAAC"}

package/dist/backend/backend/src/websocket/chat-v2.gateway.d.ts

@@ -0,0 +1,195 @@
+/**
+ * ChatV2Gateway — native WebSocket gateway for the Phase 1 Chat MVP.
+ *
+ * Listens on `/ws/chat?channelId=X&token=Y&lastSeenSeq=N` and fans out
+ * wire-format frames to subscribers per Sam's tech spec §6 / the frontend
+ * contract implemented by Max in `packages/chat-ui/src/api/client.ts`.
+ *
+ * Wire contract this gateway must honor (enforced by co-located tests):
+ *  - Client→server: `{type:"ping",ts}` every 25s
+ *  - Server→client: `{type:"pong",ts}` echo within 10s
+ *  - Server→client: `{type:"message",payload:{channelId,message:MessageDTO}}`
+ *  - Server→client: `{type:"presence",payload:{agentSession,status,lastSeenAt?}}`
+ *  - Server→client: `{type:"error",code,message}` followed by close() on fatal
+ *
+ * This module is intentionally thin: it does not persist, does not dispatch
+ * to agents, and does not manage presence state. The controller/dispatcher
+ * call `broadcast()` after the service layer writes to SQLite, so the
+ * gateway's only job is routing frames to the right sockets.
+ *
+ * Upgrade-handoff pattern copied from `BrowserBridgeService.attach()` —
+ * Socket.IO's Engine.IO upgrade handler would otherwise corrupt frames on
+ * non-`/socket.io/` paths, so we intercept the `upgrade` event on the
+ * HTTP server and handle `/ws/chat` exclusively.
+ *
+ * @module websocket/chat-v2.gateway
+ */
+import type { Server as HttpServer } from 'http';
+import { WebSocketServer, WebSocket } from 'ws';
+import type { ChatV2Service } from '../services/chat-v2/chat-v2.service.js';
+import type { ChatAgentPresenceStatus, ChatChannelDTO, ChatMessageDTO } from '../services/chat-v2/types.js';
+/** Server→client wire frame. Discriminated by `type`. */
+export type ChatWireEvent = {
+    type: 'message';
+    payload: {
+        channelId: string;
+        message: ChatMessageDTO;
+    };
+} | {
+    type: 'presence';
+    payload: {
+        agentSession: string;
+        status: ChatAgentPresenceStatus;
+        lastSeenAt?: number | null;
+    };
+} | {
+    type: 'pong';
+    ts: number;
+} | {
+    type: 'error';
+    code: string;
+    message: string;
+};
+/** Client→server wire frame (Phase 1 only has `ping`). */
+export interface ChatClientFrame {
+    type: 'ping';
+    ts: number;
+}
+/**
+ * Pluggable auth for the WS handshake. Must resolve the `?token=` query
+ * parameter into a userId, or throw to reject the connection.
+ *
+ * In production this verifies the OSS session JWT. In dev (no secret
+ * configured) `DevTokenVerifier` allows any token (or none) and returns a
+ * static userId — sufficient for localhost tests.
+ */
+export interface ChatWsTokenVerifier {
+    (token: string | null): Promise<{
+        userId: string;
+    } | null>;
+}
+/** Constructor options for {@link ChatV2Gateway}. */
+export interface ChatV2GatewayOptions {
+    service: ChatV2Service;
+    verifyToken: ChatWsTokenVerifier;
+    /** Mount path on the HTTP server. Defaults to `/ws/chat`. */
+    path?: string;
+    /** Optional WebSocketServer override for tests. */
+    webSocketServerImpl?: typeof WebSocketServer;
+    /** Optional clock override (tests). Defaults to `Date.now`. */
+    now?: () => number;
+}
+/** Default WS mount path — matches the frontend `?${qs}` URL in client.ts. */
+export declare const CHAT_V2_WS_PATH = "/ws/chat";
+/**
+ * Always-accept token verifier used when `CREWLY_JWT_SECRET` is not
+ * configured. Returns the SAME `userId` that `requireAuth`'s dev
+ * fallback uses (`dev-user-001`) so that channels created via the
+ * REST API are owned by the same principal the WS client will verify
+ * as. Not for production — in production a JWT-verifying `verifyToken`
+ * function is passed to `ChatV2Gateway` instead.
+ */
+export declare const devAnonymousTokenVerifier: ChatWsTokenVerifier;
+/**
+ * A WebSocket gateway that fans chat events out to subscribers.
+ *
+ * Lifecycle:
+ *  1. `attach(httpServer)` — hooks the upgrade interceptor
+ *  2. `broadcast(channelId, event)` — called by controller after persist
+ *  3. `close()` — shutdown hook (graceful close all sockets)
+ *
+ * The gateway owns the WebSocketServer and the subscribers map. It never
+ * reaches into the service layer on its own — all domain data arrives via
+ * `broadcast()` from callers who have already persisted.
+ */
+export declare class ChatV2Gateway {
+    private readonly service;
+    private readonly verifyToken;
+    private readonly path;
+    private readonly webSocketServerImpl;
+    private readonly now;
+    private readonly logger;
+    private wss;
+    private attached;
+    /** channelId → set of subscribers listening on that channel. */
+    private readonly subscribers;
+    constructor(options: ChatV2GatewayOptions);
+    /**
+     * Mount the gateway on an HTTP server.
+     *
+     * Uses `noServer:true` + an `httpServer.emit` override identical to
+     * `BrowserBridgeService.attach()` — the override exclusively handles
+     * upgrades whose pathname matches `this.path`, so Engine.IO never sees
+     * them and cannot corrupt the frames.
+     *
+     * @param httpServer - Shared Node HTTP server instance
+     */
+    attach(httpServer: HttpServer): void;
+    /**
+     * Broadcast a wire event to every subscriber on `channelId`.
+     *
+     * Safe to call synchronously from inside a DB transaction — sends are
+     * queued on the underlying socket and do not block.
+     *
+     * @param channelId - Target channel
+     * @param event - Wire frame to push
+     */
+    broadcast(channelId: string, event: ChatWireEvent): void;
+    /**
+     * Count of currently-open subscribers for a channel. Exposed for tests
+     * and future observability dashboards.
+     */
+    subscriberCount(channelId: string): number;
+    /** Total open sockets across all channels. Observability helper. */
+    totalSubscribers(): number;
+    /**
+     * Gracefully close all sockets. Called during shutdown.
+     */
+    close(): Promise<void>;
+    /**
+     * Handle a freshly-upgraded socket: parse query string, verify token,
+     * authorize against the channel, and register the subscriber.
+     *
+     * On any failure we send a single `{type:"error",...}` frame and close
+     * with a 1008 (policy violation) code — matching the frontend's
+     * "fatal, stop reconnecting" contract.
+     */
+    handleConnection(ws: WebSocket, req: {
+        url?: string;
+        headers: Record<string, string | undefined>;
+    }): Promise<void>;
+    /**
+     * Handle a frame from the client.
+     *
+     * Phase 1 only understands `{type:"ping",ts}`; any other shape is
+     * silently dropped (forward-compat with future client-origin frames).
+     */
+    private handleMessage;
+    private registerSubscriber;
+    private unregisterSubscriber;
+    /**
+     * Send an error frame then close with 1008. Used for all pre-subscribe
+     * rejections (auth, malformed URL, missing channelId, not-found).
+     */
+    private sendErrorAndClose;
+}
+/**
+ * Build a presence wire frame. Placed here so both the gateway's tests and
+ * future presence emitters use the same shape.
+ *
+ * @param agentSession - The agent whose presence changed
+ * @param status - New status
+ * @param lastSeenAt - Optional last-seen timestamp (ms)
+ */
+export declare function buildPresenceEvent(agentSession: string, status: ChatAgentPresenceStatus, lastSeenAt?: number | null): Extract<ChatWireEvent, {
+    type: 'presence';
+}>;
+/**
+ * Build a message wire frame from a DTO. Used by both the controller (on
+ * HTTP persist) and the dispatcher (on agent reply).
+ */
+export declare function buildMessageEvent(channelId: string, message: ChatMessageDTO): Extract<ChatWireEvent, {
+    type: 'message';
+}>;
+export type { ChatChannelDTO };
+//# sourceMappingURL=chat-v2.gateway.d.ts.map

package/dist/backend/backend/src/websocket/chat-v2.gateway.d.ts.map

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