reflectt-node 0.1.0

package/dist/cf-keepalive.js

@@ -0,0 +1,153 @@
+// SPDX-License-Identifier: Apache-2.0
+// Self-keepalive: prevents Cloudflare Workers / serverless containers from going cold.
+// Pings localhost on a timer to keep the process active.
+// Enable via REFLECTT_KEEPALIVE=true or auto-detects Cloudflare environment.
+// ── State ──
+const state = {
+    enabled: false,
+    intervalMs: 4 * 60 * 1000, // 4 min default (under 5min CF idle threshold)
+    lastPingAt: null,
+    lastPingOk: null,
+    coldStarts: 0,
+    timer: null,
+};
+let _bootInfo = null;
+// ── Environment detection ──
+function isCloudflareEnv() {
+    // CF Workers set CF_PAGES, CF_WORKER, CLOUDFLARE_* or run under workerd
+    return !!(process.env['CF_PAGES'] ||
+        process.env['CF_WORKER'] ||
+        process.env['CLOUDFLARE_ACCOUNT_ID'] ||
+        process.env['WORKERS_RS_VERSION']);
+}
+function shouldAutoEnable() {
+    const explicit = process.env['REFLECTT_KEEPALIVE'];
+    if (explicit === 'true' || explicit === '1')
+        return true;
+    if (explicit === 'false' || explicit === '0')
+        return false;
+    // Auto-enable in Cloudflare environments
+    return isCloudflareEnv();
+}
+// ── Self-ping ──
+async function selfPing(port) {
+    try {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 5_000);
+        const resp = await fetch(`http://127.0.0.1:${port}/health/ping`, {
+            signal: controller.signal,
+            headers: { 'User-Agent': 'reflectt-self-keepalive/1.0' },
+        });
+        clearTimeout(timeout);
+        state.lastPingAt = Date.now();
+        state.lastPingOk = resp.ok;
+        return resp.ok;
+    }
+    catch {
+        state.lastPingAt = Date.now();
+        state.lastPingOk = false;
+        return false;
+    }
+}
+// ── Warm boot detection ──
+export function detectWarmBoot(db) {
+    try {
+        const taskCount = db.prepare('SELECT COUNT(*) as c FROM tasks').get();
+        const chatCount = db.prepare('SELECT COUNT(*) as c FROM chat_messages').get();
+        const hostCount = db.prepare('SELECT COUNT(*) as c FROM hosts').get();
+        let reflectionCount = 0;
+        try {
+            const r = db.prepare('SELECT COUNT(*) as c FROM reflections').get();
+            reflectionCount = r?.c ?? 0;
+        }
+        catch { /* table may not exist */ }
+        const tasks = taskCount?.c ?? 0;
+        const chat = chatCount?.c ?? 0;
+        const hosts = hostCount?.c ?? 0;
+        // Check last activity timestamp
+        const lastTask = db.prepare('SELECT MAX(updated_at) as ts FROM tasks').get();
+        const lastChat = db.prepare('SELECT MAX(timestamp) as ts FROM chat_messages').get();
+        const lastActivity = Math.max(lastTask?.ts ?? 0, lastChat?.ts ?? 0);
+        const hasExistingData = tasks > 0 || chat > 0;
+        const lastActivityAge = lastActivity > 0 ? Date.now() - lastActivity : null;
+        const info = {
+            isColdStart: !hasExistingData,
+            isWarmBoot: hasExistingData,
+            lastActivityAge,
+            recoveredState: hasExistingData ? {
+                tasks,
+                chatMessages: chat,
+                hosts,
+                reflections: reflectionCount,
+            } : null,
+        };
+        _bootInfo = info;
+        if (hasExistingData) {
+            const ageSec = lastActivityAge ? Math.round(lastActivityAge / 1000) : '?';
+            console.log(`[Keepalive] Warm boot detected — recovered ${tasks} tasks, ${chat} messages, ${hosts} hosts ` +
+                `(last activity ${ageSec}s ago)`);
+            state.coldStarts++; // Track that we had to restart
+        }
+        else {
+            console.log('[Keepalive] Cold start — fresh instance, no existing data');
+        }
+        return info;
+    }
+    catch (err) {
+        const info = {
+            isColdStart: true,
+            isWarmBoot: false,
+            lastActivityAge: null,
+            recoveredState: null,
+        };
+        _bootInfo = info;
+        console.warn('[Keepalive] Could not detect boot state:', err.message);
+        return info;
+    }
+}
+// ── Start / Stop ──
+export function startSelfKeepalive(port, intervalMs) {
+    if (!shouldAutoEnable()) {
+        console.log('[Keepalive] Self-keepalive disabled (set REFLECTT_KEEPALIVE=true to enable)');
+        return;
+    }
+    if (state.timer)
+        return; // Already running
+    if (intervalMs)
+        state.intervalMs = intervalMs;
+    state.enabled = true;
+    // First ping after 30s (let server fully boot)
+    setTimeout(() => {
+        selfPing(port).catch(() => { });
+    }, 30_000);
+    state.timer = setInterval(() => {
+        selfPing(port).catch(() => { });
+    }, state.intervalMs);
+    console.log(`[Keepalive] Self-keepalive started — pinging localhost:${port} every ${Math.round(state.intervalMs / 1000)}s`);
+}
+export function stopSelfKeepalive() {
+    if (state.timer) {
+        clearInterval(state.timer);
+        state.timer = null;
+    }
+    state.enabled = false;
+}
+// ── Status ──
+export function getSelfKeepaliveStatus() {
+    return {
+        enabled: state.enabled,
+        intervalMs: state.intervalMs,
+        lastPingAt: state.lastPingAt,
+        lastPingOk: state.lastPingOk,
+        coldStarts: state.coldStarts,
+        bootInfo: _bootInfo,
+        environment: {
+            cloudflare: isCloudflareEnv(),
+            keepaliveEnv: process.env['REFLECTT_KEEPALIVE'],
+        },
+    };
+}
+export function getBootInfo() {
+    return _bootInfo;
+}
+//# sourceMappingURL=cf-keepalive.js.map

package/dist/cf-keepalive.js.map

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

package/dist/changeFeed.d.ts

@@ -0,0 +1,38 @@
+export type FeedEventKind = 'task_created' | 'task_status_changed' | 'task_assigned' | 'task_commented' | 'task_completed' | 'pr_merged' | 'mention' | 'review_requested' | 'deploy' | 'blocker' | 'digest';
+export interface FeedEvent {
+    id: string;
+    kind: FeedEventKind;
+    timestamp: number;
+    /** Agent this event is relevant to (null = relevant to all) */
+    relevantTo: string | null;
+    /** Source agent/actor */
+    actor: string;
+    /** Human-readable summary */
+    summary: string;
+    /** Related task ID if applicable */
+    taskId: string | null;
+    /** Related PR URL if applicable */
+    prUrl: string | null;
+    /** Raw data for programmatic consumption */
+    data: Record<string, unknown>;
+}
+export interface FeedOptions {
+    /** Return events since this timestamp (required) */
+    since: number;
+    /** Maximum events to return (default: 100) */
+    limit?: number;
+    /** Filter to specific event kinds */
+    kinds?: FeedEventKind[];
+    /** Include events relevant to all agents (default: true) */
+    includeGlobal?: boolean;
+}
+export interface FeedResult {
+    agent: string;
+    since: number;
+    until: number;
+    events: FeedEvent[];
+    count: number;
+    hasMore: boolean;
+}
+export declare function buildAgentFeed(agent: string, options: FeedOptions): FeedResult;
+//# sourceMappingURL=changeFeed.d.ts.map

package/dist/changeFeed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changeFeed.d.ts","sourceRoot":"","sources":["../src/changeFeed.ts"],"names":[],"mappings":"AAmBA,MAAM,MAAM,aAAa,GACrB,cAAc,GACd,qBAAqB,GACrB,eAAe,GACf,gBAAgB,GAChB,gBAAgB,GAChB,WAAW,GACX,SAAS,GACT,kBAAkB,GAClB,QAAQ,GACR,SAAS,GACT,QAAQ,CAAA;AAEZ,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,aAAa,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,+DAA+D;IAC/D,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,oCAAoC;IACpC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,mCAAmC;IACnC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAA;IACb,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qCAAqC;IACrC,KAAK,CAAC,EAAE,aAAa,EAAE,CAAA;IACvB,4DAA4D;IAC5D,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,SAAS,EAAE,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;CACjB;AAID,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,UAAU,CAwD9E"}

package/dist/changeFeed.js

@@ -0,0 +1,324 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) Reflectt AI
+/**
+ * Since-Last-Seen Change Feed
+ *
+ * Unified timeline of changes relevant to an agent since a given timestamp.
+ * Covers: task state changes, PR merges, deploys, reviewer comments,
+ * direct mentions, and assignment changes.
+ *
+ * Agents can catch up after deep work without reading all of #general.
+ */
+import { taskManager } from './tasks.js';
+import { chatManager } from './chat.js';
+// ── Feed Builder ───────────────────────────────────────────────────────────
+export function buildAgentFeed(agent, options) {
+    const since = options.since;
+    const limit = options.limit ?? 100;
+    const includeGlobal = options.includeGlobal ?? true;
+    const now = Date.now();
+    const agentLower = agent.toLowerCase();
+    const events = [];
+    // 1. Task state changes from history
+    collectTaskEvents(agentLower, since, events);
+    // 2. Task comments (on agent's tasks or mentioning agent)
+    collectTaskComments(agentLower, since, events);
+    // 3. Chat mentions and relevant messages
+    collectChatEvents(agentLower, since, events);
+    // 4. PR/deploy signals from chat
+    collectPrAndDeployEvents(agentLower, since, events);
+    // Filter by relevance
+    let filtered = events.filter(e => e.relevantTo === agentLower || (includeGlobal && e.relevantTo === null));
+    // Filter by kinds if specified
+    if (options.kinds?.length) {
+        const kindSet = new Set(options.kinds);
+        filtered = filtered.filter(e => kindSet.has(e.kind));
+    }
+    // Sort by timestamp descending (most recent first)
+    filtered.sort((a, b) => b.timestamp - a.timestamp);
+    // Deduplicate by id
+    const seen = new Set();
+    const deduped = [];
+    for (const event of filtered) {
+        if (!seen.has(event.id)) {
+            seen.add(event.id);
+            deduped.push(event);
+        }
+    }
+    const hasMore = deduped.length > limit;
+    const result = deduped.slice(0, limit);
+    return {
+        agent: agentLower,
+        since,
+        until: now,
+        events: result,
+        count: result.length,
+        hasMore,
+    };
+}
+// ── Collectors ─────────────────────────────────────────────────────────────
+function collectTaskEvents(agent, since, events) {
+    const allTasks = taskManager.listTasks({});
+    for (const task of allTasks) {
+        const history = taskManager.getTaskHistory(task.id);
+        for (const event of history) {
+            if (event.timestamp < since)
+                continue;
+            const isRelevant = isTaskRelevantToAgent(task, agent, event);
+            if (!isRelevant)
+                continue;
+            switch (event.type) {
+                case 'created':
+                    if ((task.assignee || '').toLowerCase() === agent) {
+                        events.push({
+                            id: `feed-${event.id}`,
+                            kind: 'task_created',
+                            timestamp: event.timestamp,
+                            relevantTo: agent,
+                            actor: event.actor,
+                            summary: `New task assigned to you: ${task.title}`,
+                            taskId: task.id,
+                            prUrl: null,
+                            data: { taskTitle: task.title, assignee: task.assignee },
+                        });
+                    }
+                    break;
+                case 'status_changed': {
+                    const newStatus = event.data?.to || task.status;
+                    const oldStatus = event.data?.from || 'unknown';
+                    if (newStatus === 'done') {
+                        events.push({
+                            id: `feed-${event.id}`,
+                            kind: 'task_completed',
+                            timestamp: event.timestamp,
+                            relevantTo: isMyTask(task, agent) ? agent : null,
+                            actor: event.actor,
+                            summary: `Task completed: ${task.title} (${oldStatus} → done)`,
+                            taskId: task.id,
+                            prUrl: extractPrUrl(task),
+                            data: { from: oldStatus, to: newStatus },
+                        });
+                    }
+                    else if (newStatus === 'validating' && (task.reviewer || '').toLowerCase() === agent) {
+                        events.push({
+                            id: `feed-${event.id}`,
+                            kind: 'review_requested',
+                            timestamp: event.timestamp,
+                            relevantTo: agent,
+                            actor: event.actor,
+                            summary: `Review requested: ${task.title} → validating`,
+                            taskId: task.id,
+                            prUrl: extractPrUrl(task),
+                            data: { from: oldStatus, to: newStatus, assignee: task.assignee },
+                        });
+                    }
+                    else {
+                        events.push({
+                            id: `feed-${event.id}`,
+                            kind: 'task_status_changed',
+                            timestamp: event.timestamp,
+                            relevantTo: isMyTask(task, agent) ? agent : null,
+                            actor: event.actor,
+                            summary: `${task.title}: ${oldStatus} → ${newStatus}`,
+                            taskId: task.id,
+                            prUrl: null,
+                            data: { from: oldStatus, to: newStatus },
+                        });
+                    }
+                    break;
+                }
+                case 'assigned': {
+                    const newAssignee = (event.data?.to || '').toLowerCase();
+                    if (newAssignee === agent) {
+                        events.push({
+                            id: `feed-${event.id}`,
+                            kind: 'task_assigned',
+                            timestamp: event.timestamp,
+                            relevantTo: agent,
+                            actor: event.actor,
+                            summary: `Task assigned to you: ${task.title}`,
+                            taskId: task.id,
+                            prUrl: null,
+                            data: { from: event.data?.from, to: event.data?.to },
+                        });
+                    }
+                    break;
+                }
+            }
+        }
+    }
+}
+function collectTaskComments(agent, since, events) {
+    const allTasks = taskManager.listTasks({});
+    for (const task of allTasks) {
+        if (!isMyTask(task, agent))
+            continue;
+        const comments = taskManager.getTaskComments(task.id);
+        for (const comment of comments) {
+            if (comment.timestamp < since)
+                continue;
+            if (comment.author.toLowerCase() === agent)
+                continue; // Skip own comments
+            events.push({
+                id: `feed-comment-${comment.id}`,
+                kind: 'task_commented',
+                timestamp: comment.timestamp,
+                relevantTo: agent,
+                actor: comment.author,
+                summary: `${comment.author} commented on ${task.title}: ${truncate(comment.content, 300)}`,
+                taskId: task.id,
+                prUrl: null,
+                data: { commentId: comment.id, content: comment.content },
+            });
+        }
+    }
+}
+function collectChatEvents(agent, since, events) {
+    const messages = chatManager.getMessages({ since, limit: 500 });
+    const mentionPattern = new RegExp(`@${agent}\\b`, 'i');
+    for (const msg of messages) {
+        const from = (msg.from || '').toLowerCase();
+        if (from === agent)
+            continue; // Skip own messages
+        const content = typeof msg.content === 'string' ? msg.content : '';
+        // Direct mentions
+        if (mentionPattern.test(content)) {
+            events.push({
+                id: `feed-mention-${msg.id}`,
+                kind: 'mention',
+                timestamp: msg.timestamp,
+                relevantTo: agent,
+                actor: from,
+                summary: `${msg.from} mentioned you: ${truncate(content, 300)}`,
+                taskId: extractTaskId(content),
+                prUrl: extractPrUrlFromText(content),
+                data: { channel: msg.channel, messageId: msg.id, content },
+            });
+        }
+        // Blocker signals
+        if (/\bblocker\b/i.test(content) && from !== 'system' && from !== 'watchdog') {
+            const taskId = extractTaskId(content);
+            if (taskId) {
+                const task = taskManager.getTask(taskId);
+                if (task && isMyTask(task, agent)) {
+                    events.push({
+                        id: `feed-blocker-${msg.id}`,
+                        kind: 'blocker',
+                        timestamp: msg.timestamp,
+                        relevantTo: agent,
+                        actor: from,
+                        summary: `Blocker reported: ${truncate(content, 300)}`,
+                        taskId,
+                        prUrl: null,
+                        data: { channel: msg.channel, content },
+                    });
+                }
+            }
+        }
+    }
+}
+function collectPrAndDeployEvents(agent, since, events) {
+    const messages = chatManager.getMessages({ since, channel: 'shipping', limit: 200 });
+    const prPattern = /(?:PR|pull request)\s*#?(\d+)/i;
+    const mergedPattern = /\bmerged\b/i;
+    const deployPattern = /\b(?:deployed|deploy|shipped)\b/i;
+    for (const msg of messages) {
+        const content = typeof msg.content === 'string' ? msg.content : '';
+        const from = (msg.from || '').toLowerCase();
+        // PR merge signals
+        const prMatch = content.match(prPattern);
+        if (prMatch && mergedPattern.test(content)) {
+            const prUrl = extractPrUrlFromText(content);
+            const taskId = extractTaskId(content);
+            const isRelevant = taskId
+                ? isTaskRelevantById(taskId, agent)
+                : mentionsAgent(content, agent);
+            if (isRelevant || from === agent) {
+                events.push({
+                    id: `feed-pr-${msg.id}`,
+                    kind: 'pr_merged',
+                    timestamp: msg.timestamp,
+                    relevantTo: isRelevant ? agent : null,
+                    actor: from,
+                    summary: `PR #${prMatch[1]} merged: ${truncate(content, 300)}`,
+                    taskId,
+                    prUrl,
+                    data: { prNumber: Number(prMatch[1]), channel: msg.channel },
+                });
+            }
+        }
+        // Deploy signals
+        if (deployPattern.test(content) && !prMatch) {
+            events.push({
+                id: `feed-deploy-${msg.id}`,
+                kind: 'deploy',
+                timestamp: msg.timestamp,
+                relevantTo: null, // Deploys are relevant to everyone
+                actor: from,
+                summary: `Deploy: ${truncate(content, 300)}`,
+                taskId: extractTaskId(content),
+                prUrl: extractPrUrlFromText(content),
+                data: { channel: msg.channel },
+            });
+        }
+    }
+}
+// ── Helpers ────────────────────────────────────────────────────────────────
+function isMyTask(task, agent) {
+    return (task.assignee || '').toLowerCase() === agent
+        || (task.reviewer || '').toLowerCase() === agent;
+}
+function isTaskRelevantToAgent(task, agent, event) {
+    // Relevant if agent is assignee, reviewer, or the actor
+    return isMyTask(task, agent) || event.actor.toLowerCase() === agent;
+}
+function isTaskRelevantById(taskId, agent) {
+    const task = taskManager.getTask(taskId);
+    if (!task)
+        return false;
+    return isMyTask(task, agent);
+}
+function mentionsAgent(text, agent) {
+    return new RegExp(`@${agent}\\b`, 'i').test(text);
+}
+function isValidPrUrl(url) {
+    const match = url.match(/\/pull\/(\d+)/);
+    if (!match)
+        return false;
+    return parseInt(match[1], 10) > 0;
+}
+function extractPrUrl(task) {
+    const meta = task.metadata;
+    if (!meta)
+        return null;
+    // Skip doc-only/config-only tasks that use placeholder PR URLs
+    const handoff = meta.review_handoff;
+    if (handoff?.doc_only || handoff?.config_only)
+        return null;
+    const candidates = [];
+    if (typeof meta.pr_url === 'string')
+        candidates.push(meta.pr_url);
+    if (typeof meta.pr_link === 'string')
+        candidates.push(meta.pr_link);
+    if (handoff && typeof handoff.pr_url === 'string')
+        candidates.push(handoff.pr_url);
+    for (const url of candidates) {
+        if (isValidPrUrl(url))
+            return url;
+    }
+    return null;
+}
+function extractPrUrlFromText(text) {
+    const match = text.match(/https?:\/\/github\.com\/[^\s/]+\/[^\s/]+\/pull\/\d+/);
+    return match ? match[0] : null;
+}
+function extractTaskId(text) {
+    const match = text.match(/\b(task-[a-z0-9-]+)\b/i);
+    return match ? match[1] : null;
+}
+function truncate(text, maxLen) {
+    if (text.length <= maxLen)
+        return text;
+    return text.slice(0, maxLen - 3) + '...';
+}
+//# sourceMappingURL=changeFeed.js.map

package/dist/changeFeed.js.map

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

package/dist/channels.d.ts

@@ -0,0 +1,28 @@
+export declare const CHANNEL_DEFINITIONS: readonly [{
+    readonly id: "general";
+    readonly name: "General";
+}, {
+    readonly id: "decisions";
+    readonly name: "Decisions";
+}, {
+    readonly id: "shipping";
+    readonly name: "Shipping";
+}, {
+    readonly id: "reviews";
+    readonly name: "Reviews";
+}, {
+    readonly id: "blockers";
+    readonly name: "Blockers";
+}, {
+    readonly id: "ops";
+    readonly name: "Ops";
+}, {
+    readonly id: "problems";
+    readonly name: "Problems & Ideas";
+}, {
+    readonly id: "dev";
+    readonly name: "Development";
+}];
+export declare const DEFAULT_CHAT_CHANNELS: ("general" | "ops" | "decisions" | "shipping" | "reviews" | "blockers" | "problems" | "dev")[];
+export declare const DEFAULT_INBOX_SUBSCRIPTIONS: string[];
+//# sourceMappingURL=channels.d.ts.map

package/dist/channels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../src/channels.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;EAUtB,CAAA;AAEV,eAAO,MAAM,qBAAqB,gGAAiD,CAAA;AAEnF,eAAO,MAAM,2BAA2B,UAOvC,CAAA"}

package/dist/channels.js

@@ -0,0 +1,23 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) Reflectt AI
+export const CHANNEL_DEFINITIONS = [
+    { id: 'general', name: 'General' },
+    { id: 'decisions', name: 'Decisions' },
+    { id: 'shipping', name: 'Shipping' },
+    { id: 'reviews', name: 'Reviews' },
+    { id: 'blockers', name: 'Blockers' },
+    { id: 'ops', name: 'Ops' },
+    // Legacy channels retained for compatibility with historical workflows.
+    { id: 'problems', name: 'Problems & Ideas' },
+    { id: 'dev', name: 'Development' },
+];
+export const DEFAULT_CHAT_CHANNELS = CHANNEL_DEFINITIONS.map(channel => channel.id);
+export const DEFAULT_INBOX_SUBSCRIPTIONS = [
+    'general',
+    'decisions',
+    'shipping',
+    'reviews',
+    'blockers',
+    'problems',
+];
+//# sourceMappingURL=channels.js.map

package/dist/channels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.js","sourceRoot":"","sources":["../src/channels.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,4BAA4B;AAE5B,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;IAClC,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE;IACtC,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE;IACpC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;IAClC,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE;IACpC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE;IAC1B,wEAAwE;IACxE,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,kBAAkB,EAAE;IAC5C,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE;CAC1B,CAAA;AAEV,MAAM,CAAC,MAAM,qBAAqB,GAAG,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;AAEnF,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,SAAS;IACT,WAAW;IACX,UAAU;IACV,SAAS;IACT,UAAU;IACV,UAAU;CACX,CAAA"}

package/dist/chat-approval-detector.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Chat Approval Detector
+ *
+ * Bridges chat-based reviewer approvals to formal task review decisions.
+ *
+ * Problem: When a reviewer says "LGTM" or "approved" in chat, the task stays
+ * stuck in "validating" because chat messages don't trigger the formal review
+ * endpoint (POST /tasks/:id/review). This module detects approval signals in
+ * chat messages and auto-submits the formal review decision.
+ *
+ * Resolution logic:
+ *   1. If the message explicitly references a task ID → target that task
+ *   2. If the reviewer has exactly one task in "validating" → target that
+ *   3. If ambiguous (multiple validating tasks, no reference) → skip + log
+ *
+ * Safety:
+ *   - Only triggers for the assigned reviewer (reviewer identity gate)
+ *   - Only fires once per task (idempotent — checks reviewer_approved first)
+ *   - Adds audit comment documenting the auto-detection
+ *   - Never auto-rejects (approval signals only)
+ */
+import type { Task } from './types.js';
+export interface ApprovalSignal {
+    taskId: string;
+    reviewer: string;
+    source: 'explicit_reference' | 'sole_validating';
+    matchedPattern: string;
+    comment: string;
+}
+export interface DetectionResult {
+    detected: boolean;
+    signal?: ApprovalSignal;
+    skipped?: {
+        reason: 'no_approval_signal' | 'rejection_signal' | 'not_a_reviewer' | 'already_approved' | 'ambiguous_tasks' | 'no_validating_tasks' | 'task_not_validating' | 'reviewer_mismatch';
+        details?: string;
+    };
+}
+/**
+ * Check if a chat message contains an approval signal from a reviewer.
+ */
+export declare function detectApproval(from: string, content: string): DetectionResult;
+/**
+ * Apply an approval signal by updating the task metadata.
+ * Returns the updated task or null if the update failed.
+ */
+export declare function applyApproval(signal: ApprovalSignal): Promise<Task | undefined>;
+//# sourceMappingURL=chat-approval-detector.d.ts.map