crewly 1.20.193 → 1.20.195

package/dist/backend/backend/src/controllers/trace/trace.controller.js

@@ -0,0 +1,169 @@
+/**
+ * Run traces API (specs/2026-10-03-run-traces.md, issue #983).
+ *
+ * - `GET  /api/traces?since=<ISO>&type=<rootKind>&limit=` — traces, most recently active first
+ * - `GET  /api/traces/by-ref?workItemId=|ticketId=|requestId=|decisionId=|experimentId=` — the trace of an entity
+ * - `GET  /api/traces/:id?offset=&limit=` — `{ root, events, total, offset, limit, truncated }`
+ * - `POST /api/traces` `{ kind: 'goal'|'experiment', summary, refs? }` — start a goal / experiment root
+ *
+ * @module controllers/trace/trace.controller
+ */
+import { Router } from 'express';
+import { TRACE_CONSTANTS } from '../../constants.js';
+import { readAgentSessionHeader } from '../../utils/agent-caller.utils.js';
+import { getTraceStore } from '../../services/trace/trace-store.js';
+import { startGoalTrace } from '../../services/trace/trace-recorder.js';
+import { isTraceId, isTraceRootKind } from '../../services/trace/trace.types.js';
+/** Query parameter → index ref kind, in lookup order. */
+const REF_PARAMS = [
+    ['workItemId', 'workItem'],
+    ['ticketId', 'ticket'],
+    ['requestId', 'request'],
+    ['decisionId', 'decision'],
+    ['experimentId', 'experiment'],
+];
+/**
+ * A query value as a trimmed string.
+ *
+ * @param value - Raw query value
+ * @returns String, or undefined
+ */
+function queryString(value) {
+    const v = Array.isArray(value) ? value[0] : value;
+    return typeof v === 'string' && v.trim().length > 0 ? v.trim() : undefined;
+}
+/**
+ * A query value as a non-negative integer.
+ *
+ * @param value - Raw query value
+ * @param fallback - Default
+ * @returns The integer
+ */
+function queryInt(value, fallback) {
+    const s = queryString(value);
+    if (!s || !/^\d+$/.test(s))
+        return fallback;
+    return Number(s);
+}
+/**
+ * GET /api/traces
+ *
+ * @param req - Query: since (ISO), type (root kind), limit
+ * @param res - `{ success, data: { traces, writeFailures } }`
+ */
+export function listTraces(req, res) {
+    const sinceRaw = queryString(req.query.since);
+    const since = sinceRaw ? new Date(sinceRaw) : undefined;
+    if (since && Number.isNaN(since.getTime())) {
+        res.status(400).json({ success: false, error: 'since must be an ISO date' });
+        return;
+    }
+    const type = queryString(req.query.type);
+    if (type && !isTraceRootKind(type)) {
+        res.status(400).json({ success: false, error: 'type must be one of request, goal, experiment, owner_message' });
+        return;
+    }
+    const store = getTraceStore();
+    const traces = store.list({
+        ...(since ? { since } : {}),
+        ...(type && isTraceRootKind(type) ? { rootKind: type } : {}),
+        limit: queryInt(req.query.limit, TRACE_CONSTANTS.DEFAULT_LIST_LIMIT),
+    });
+    // writeFailures: trace writes lost since the backend started (disk full, permissions).
+    res.json({ success: true, data: { traces, writeFailures: store.writeFailures } });
+}
+/**
+ * GET /api/traces/by-ref
+ *
+ * @param req - Query: one of workItemId, ticketId, requestId, decisionId, experimentId
+ * @param res - `{ success, data: { traceId, root } }`, 400 without a ref, 404 when unknown
+ */
+export function traceByRef(req, res) {
+    const store = getTraceStore();
+    let asked = false;
+    for (const [param, kind] of REF_PARAMS) {
+        const id = queryString(req.query[param]);
+        if (!id)
+            continue;
+        asked = true;
+        const traceId = store.traceByRef(kind, id);
+        const entry = traceId ? store.getEntry(traceId) : null;
+        if (entry) {
+            res.json({ success: true, data: { traceId: entry.traceId, root: entry.root } });
+            return;
+        }
+    }
+    if (!asked) {
+        res.status(400).json({ success: false, error: 'Pass one of workItemId, ticketId, requestId, decisionId, experimentId' });
+        return;
+    }
+    res.status(404).json({ success: false, error: 'No trace for that reference (only work started after traces were enabled has one)' });
+}
+/**
+ * GET /api/traces/:id
+ *
+ * @param req - Params: id; query: offset, limit
+ * @param res - `{ success, data: { root, events, total, offset, limit, truncated } }`
+ */
+export async function getTrace(req, res) {
+    const id = req.params.id;
+    if (!isTraceId(id)) {
+        res.status(400).json({ success: false, error: 'Not a trace id (tr-YYYYMMDD-xxxxxxxx)' });
+        return;
+    }
+    const page = await getTraceStore().read(id, queryInt(req.query.offset, 0), queryInt(req.query.limit, TRACE_CONSTANTS.DEFAULT_PAGE_SIZE));
+    if (!page) {
+        res.status(404).json({ success: false, error: `Trace ${id} not found` });
+        return;
+    }
+    res.json({ success: true, data: page });
+}
+/**
+ * POST /api/traces — start a goal or experiment trace. An agent caller's turn
+ * is bound to it.
+ *
+ * @param req - Body: kind ('goal' | 'experiment'), summary, refs?
+ * @param res - 201 `{ success, data: { traceId } }`
+ */
+export function startTrace(req, res) {
+    const body = (req.body ?? {});
+    if (body.kind !== 'goal' && body.kind !== 'experiment') {
+        res.status(400).json({ success: false, error: "kind must be 'goal' or 'experiment'" });
+        return;
+    }
+    if (typeof body.summary !== 'string' || body.summary.trim().length === 0) {
+        res.status(400).json({ success: false, error: 'summary is required' });
+        return;
+    }
+    const refs = {};
+    if (body.refs && typeof body.refs === 'object') {
+        for (const key of ['requestId', 'ticketId', 'workItemId', 'messageId', 'decisionId', 'experimentId']) {
+            const v = body.refs[key];
+            if (typeof v === 'string' && v.length > 0)
+                refs[key] = v;
+        }
+    }
+    const session = readAgentSessionHeader(req);
+    const traceId = startGoalTrace({ kind: body.kind, summary: body.summary, refs, ...(session ? { session } : {}) });
+    if (!traceId) {
+        res.status(500).json({ success: false, error: 'The trace could not be started' });
+        return;
+    }
+    res.status(201).json({ success: true, data: { traceId } });
+}
+/**
+ * Router for `/api/traces`.
+ *
+ * @returns Express router
+ */
+export function createTraceRouter() {
+    const router = Router();
+    router.get('/', listTraces);
+    router.get('/by-ref', traceByRef);
+    router.post('/', startTrace);
+    router.get('/:id', (req, res, next) => {
+        getTrace(req, res).catch(next);
+    });
+    return router;
+}
+//# sourceMappingURL=trace.controller.js.map

package/dist/backend/backend/src/controllers/trace/trace.controller.js.map

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

package/dist/backend/backend/src/index.d.ts.map

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

package/dist/backend/backend/src/index.js

@@ -28,7 +28,8 @@ import { getSettingsService } from './services/settings/index.js';
 import { MemoryService } from './services/memory/memory.service.js';
 import { getImprovementStartupService } from './services/orchestrator/improvement-startup.service.js';
 import { dedicatedDecisionFor } from './services/people/dedicated-agent.js';
-import { setPeopleOwnerLookup } from './services/people/people-directory.service.js';
+import { setPeopleBotLookup, setPeopleOwnerLookup } from './services/people/people-directory.service.js';
+import { isCrewlyBotUserId } from './services/slack/slack-bot-ids.js';
 import { getSlackCloudConfigService } from './services/slack/slack-cloud-config.service.js';
 import { initializeSlackIfConfigured, shutdownSlack } from './services/slack/index.js';
 import { isNonFatalUnhandledRejection, unhandledRejectionMessage } from './utils/unhandled-rejection.utils.js';
@@ -67,7 +68,7 @@ import { getSlackAutoWorkingService } from './services/slack/slack-auto-working.
 import { getSlackAgentDmService } from './services/slack/slack-agent-dm.service.js';
 import { sendBootAnnouncement, isFirstBoot, markBooted } from './services/boot/boot-announce.service.js';
 import { SubAgentMessageQueue } from './services/messaging/sub-agent-message-queue.service.js';
-import { SUB_AGENT_QUEUE_CONSTANTS, CHAT_CONTEXT_CONSTANTS, SAFE_RESTART, AUTO_UPDATE_CONSTANTS, PROCESS_EXIT_CODES, CLAUDE_STARTUP_CONSTANTS, WEB_CONSTANTS, TICKET_CONSTANTS, UNASSIGNED_ROUTE_CONSTANTS, CLOUD_TALK_CONSTANTS, STANDING_ANSWERS_CONSTANTS, TICKET_AUTOPILOT_CONSTANTS, WORK_ITEM_DESTINATION_CONSTANTS, CODEX_USAGE_SYNC_CONSTANTS, ANTIGRAVITY_USAGE_SYNC_CONSTANTS } from './constants.js';
+import { SUB_AGENT_QUEUE_CONSTANTS, CHAT_CONTEXT_CONSTANTS, SAFE_RESTART, AUTO_UPDATE_CONSTANTS, PROCESS_EXIT_CODES, CLAUDE_STARTUP_CONSTANTS, WEB_CONSTANTS, TICKET_CONSTANTS, UNASSIGNED_ROUTE_CONSTANTS, CLOUD_TALK_CONSTANTS, STANDING_ANSWERS_CONSTANTS, TICKET_AUTOPILOT_CONSTANTS, EXPERIMENT_CONSTANTS, WORK_ITEM_DESTINATION_CONSTANTS, CODEX_USAGE_SYNC_CONSTANTS, ANTIGRAVITY_USAGE_SYNC_CONSTANTS } from './constants.js';
 import { PtyActivityTrackerService } from './services/agent/pty-activity-tracker.service.js';
 import { InFlightTurnTracker } from './services/restart/in-flight-turn-tracker.service.js';
 import { TicketIntakeService, setTicketIntakeService, resolveTicketIdForSession, } from './services/v3/ticket-intake.service.js';
@@ -2122,7 +2123,7 @@ export class CrewlyServer {
             // messages into the bound agent session so it can reply via the
             // `reply-channel` skill. See chat-v2.gateway.ts for the contract.
             try {
-                const [{ ChatV2Gateway, devAnonymousTokenVerifier }, { ChatV2DispatcherService }, { ChatV2MentionResolver }, { getChatV2Service }, { setChatV2RealtimeDeps }, { verifyHs256Token },] = await Promise.all([
+                const [{ ChatV2Gateway, devAnonymousTokenVerifier }, { ChatV2DispatcherService, agentAuthorOf }, { ChatV2MentionResolver }, { getChatV2Service }, { setChatV2RealtimeDeps }, { verifyHs256Token },] = await Promise.all([
                     import('./websocket/chat-v2.gateway.js'),
                     import('./services/chat-v2/chat-v2.dispatcher.service.js'),
                     import('./services/chat-v2/chat-v2.mention-resolver.js'),
@@ -2157,8 +2158,11 @@ export class CrewlyServer {
                     mentionResolver: chatMentionResolver,
                     // Issue #968: an agent dedicated to one person never gets (or
                     // is woken by) anyone else's Slack message.
+                    // A post another agent wrote (colleague's Slack post, or a
+                    // local agent's user turn) is never declined.
                     refuseDelivery: async (sessionName, message) => (await dedicatedDecisionFor(StorageService.getInstance(), sessionName, {
                         slackUserId: typeof message.metadata?.slackUserId === 'string' ? message.metadata.slackUserId : null,
+                        authorAgentSession: agentAuthorOf(message),
                     })).decline,
                     // Phase B-2 — huddle roster lookup. ChatV2Service owns
                     // the chat_channel_members table; the dispatcher just
@@ -3010,14 +3014,15 @@ export class CrewlyServer {
                         const slack = getSlackService();
                         if (!slack.isConnected())
                             return false;
-                        await slack.sendNotification({
+                        // Only a delivered notice counts: sendNotification resolves
+                        // false when there was no channel to send it to.
+                        return slack.sendNotification({
                             type: 'project_update',
                             title,
                             message,
                             urgency: urgent ? 'high' : 'normal',
                             timestamp: new Date().toISOString(),
                         });
-                        return true;
                     });
                     TicketAutopilotService.getInstance()?.stop();
                     TicketAutopilotService.setInstance(autopilot);
@@ -3030,6 +3035,37 @@ export class CrewlyServer {
                 else {
                     this.logger.info('Ticket autopilot off (CREWLY_TICKET_AUTOPILOT=0)');
                 }
+                // Experiment cards (specs/experiment-cards.md, issue #986): measure each
+                // shipped experiment at the end of its window, label it, log it to the
+                // wiki and tell the owner. Kill switch: CREWLY_EXPERIMENTS=0.
+                if (process.env[EXPERIMENT_CONSTANTS.ENV_SWITCH] !== '0')
+                    try {
+                        const { createDefaultExperimentService } = await import('./services/experiments/experiment.wiring.js');
+                        const { ExperimentService } = await import('./services/experiments/experiment.service.js');
+                        const experiments = await createDefaultExperimentService(async ({ title, message, urgent }) => {
+                            const slack = getSlackService();
+                            if (!slack.isConnected())
+                                return false;
+                            // Only a delivered notice counts: sendNotification resolves
+                            // false when there was no channel to send it to.
+                            return slack.sendNotification({
+                                type: 'project_update',
+                                title,
+                                message,
+                                urgency: urgent ? 'high' : 'normal',
+                                timestamp: new Date().toISOString(),
+                            });
+                        });
+                        ExperimentService.getInstance()?.stop();
+                        ExperimentService.setInstance(experiments);
+                        experiments.start();
+                        this.logger.info('Experiment cards started');
+                    }
+                    catch (experimentErr) {
+                        this.logger.warn('Experiment cards failed to start (non-fatal)', {
+                            error: experimentErr instanceof Error ? experimentErr.message : String(experimentErr),
+                        });
+                    }
                 // Decision cards (specs/2026-10-01-decision-cards.md): structured owner
                 // questions posted by the responsible agent's own bot, answered by
                 // button / reaction / thread reply / dashboard; deadlines applied here.
@@ -3418,6 +3454,8 @@ export class CrewlyServer {
         // The people directory's owner is the Slack user who installed Crewly's
         // Slack app (issue #968); before Slack is set up it is "owner".
         setPeopleOwnerLookup(() => getSlackCloudConfigService()?.getConfig()?.workspace.installedBy || null);
+        // Crewly's own bots (master bot, agent bots) are never people.
+        setPeopleBotLookup(isCrewlyBotUserId);
         try {
             this.logger.info('Checking Slack configuration...');
             const result = await initializeSlackIfConfigured({
@@ -4798,24 +4836,25 @@ export class CrewlyServer {
             const { createDecisionService, attachDecisionSlackListeners, attachSkipAllCommand } = await import('./services/decisions/decision.wiring.js');
             const { DecisionService } = await import('./services/decisions/decision.service.js');
             const RUNNING = new Set(['running', 'accepted', 'proposed']);
+            const sendToAgent = async (session, text) => {
+                let exists = false;
+                try {
+                    exists = getSessionBackendSync()?.sessionExists(session) ?? false;
+                }
+                catch {
+                    exists = false;
+                }
+                if (!exists) {
+                    const { activateAgentBySession } = await import('./controllers/team/team.controller.js');
+                    await activateAgentBySession(this.apiController, session).catch(() => undefined);
+                }
+                const result = await this.apiController.agentRegistrationService.sendMessageToAgent(session, text);
+                return result.success;
+            };
             const decisions = createDecisionService({
                 crewlyHome: this.config.crewlyHome,
                 getTeams: () => this.storageService.getTeams(),
-                sendToAgent: async (session, text) => {
-                    let exists = false;
-                    try {
-                        exists = getSessionBackendSync()?.sessionExists(session) ?? false;
-                    }
-                    catch {
-                        exists = false;
-                    }
-                    if (!exists) {
-                        const { activateAgentBySession } = await import('./controllers/team/team.controller.js');
-                        await activateAgentBySession(this.apiController, session).catch(() => undefined);
-                    }
-                    const result = await this.apiController.agentRegistrationService.sendMessageToAgent(session, text);
-                    return result.success;
-                },
+                sendToAgent,
                 sendToOrchestrator: async (text) => {
                     this.messageQueueService.enqueue({ content: text, conversationId: 'system', source: 'system_event' });
                     return true;
@@ -4844,6 +4883,13 @@ export class CrewlyServer {
             await attachSkipAllCommand(decisions).catch((err) => this.logger.warn('Skip-all command not wired (non-critical)', { error: err instanceof Error ? err.message : String(err) }));
             decisions.start();
             this.logger.info('Decision cards started');
+            // Daily signal digest (#987, specs/2026-10-03-signal-digest.md): Do / Skip
+            // per action on one card; Do opens an experiment ticket.
+            const { createSignalDigestService, attachSignalDigestSlackListeners } = await import('./services/signal-digest/signal-digest.wiring.js');
+            const { SignalDigestService } = await import('./services/signal-digest/signal-digest.service.js');
+            const signalDigests = createSignalDigestService({ crewlyHome: this.config.crewlyHome, getTeams: () => this.storageService.getTeams(), sendToAgent });
+            SignalDigestService.setInstance(signalDigests);
+            attachSignalDigestSlackListeners(signalDigests);
             // Runtime Terms consent (specs/2026-10-01-runtime-terms-consent.md): the
             // owner agrees to a runtime's first-run Terms from a Slack card.
             const { startRuntimeTerms } = await import('./services/runtime-terms/runtime-terms.wiring.js');