reflectt-node 0.1.0

package/dist/shared-workspace-api.js.map

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

package/dist/shipped-heartbeat.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Shipped-Artifact Auto-Heartbeat
+ *
+ * Emits a compact status update to #general when a task transitions to
+ * validating or done AND has an artifact_path in metadata.
+ *
+ * Payload format (sage-validated contract):
+ *   [SHIP] <task_id> | shipped:<ref> | next:<eta> | review:@<reviewer> | by:@<owner>
+ *
+ * Suppression rules:
+ *   1. Dedup window (30m) — same task won't re-fire within 30 minutes
+ *   2. Reviewer override — if reviewer posts in #general within 5m of the
+ *      trigger, the auto-heartbeat is suppressed (they wrote their own)
+ *   3. Missing/invalid artifact — silently skipped with warning log
+ *
+ * Failure modes (documented per done criteria):
+ *   - Duplicate spam: dedup map with 30m TTL prevents double-posts on rapid
+ *     status flips (e.g., validating→blocked→validating)
+ *   - Missing artifact link: task without metadata.artifact_path is skipped;
+ *     logged at warn level for ops visibility
+ *   - Reviewer already posted: 5m look-back in #general for reviewer messages
+ *     mentioning the task ID suppresses the auto-heartbeat
+ *   - Chat budget exceeded: respects existing noise-budget in chat.sendMessage;
+ *     if budget blocks the message, it's logged but not retried
+ *
+ * Task: task-1771691652369-2c2y0uknl
+ * Design: scout (pilot spec) → Implementation: link
+ */
+import { type Event } from './events.js';
+import type { Task } from './types.js';
+export interface ShippedHeartbeatPayload {
+    taskId: string;
+    shipped: string;
+    next: string;
+    reviewer: string;
+    owner: string;
+    lane: 'ops' | 'product' | 'comms' | 'engineering' | 'unknown';
+}
+export interface HeartbeatStats {
+    totalEmitted: number;
+    totalSuppressed: number;
+    suppressionReasons: Record<string, number>;
+    lastEmittedAt: number | null;
+}
+/**
+ * Build a compact heartbeat payload from a task.
+ */
+export declare function buildPayload(task: Task): ShippedHeartbeatPayload | null;
+/**
+ * Format the canonical compact message.
+ *
+ * Examples:
+ *   [SHIP] task-abc123 | shipped:process/spec.md | next:pending review | review:@sage | by:@scout
+ *   [SHIP] task-def456 | shipped:src/feature.ts | next:done | review:@kai | by:@link
+ *   [SHIP] task-ghi789 | shipped:docs/runbook.md | next:~2h | review:@pixel | by:@echo
+ */
+export declare function formatMessage(payload: ShippedHeartbeatPayload): string;
+/**
+ * Infer the task lane from metadata, tags, or title keywords.
+ */
+declare function inferLane(task: Task): ShippedHeartbeatPayload['lane'];
+/**
+ * Check dedup window — returns true if this task was already emitted recently.
+ */
+declare function isDuplicate(taskId: string): boolean;
+/**
+ * Check if reviewer already posted about this task in #general recently.
+ * Returns true if reviewer override should suppress the auto-heartbeat.
+ */
+declare function isReviewerOverride(task: Task): boolean;
+/**
+ * Validate artifact_path is under process/ (canonical location).
+ */
+declare function isValidArtifactPath(artifactPath: string): boolean;
+declare function handleTaskEvent(event: Event): Promise<void>;
+export declare function startShippedHeartbeat(): void;
+export declare function stopShippedHeartbeat(): void;
+export declare function getShippedHeartbeatStats(): HeartbeatStats;
+export declare const _testing: {
+    handleTaskEvent: typeof handleTaskEvent;
+    isDuplicate: typeof isDuplicate;
+    isReviewerOverride: typeof isReviewerOverride;
+    isValidArtifactPath: typeof isValidArtifactPath;
+    inferLane: typeof inferLane;
+    dedupMap: Map<string, number>;
+    stats: HeartbeatStats;
+    DEDUP_WINDOW_MS: number;
+    REVIEWER_OVERRIDE_WINDOW_MS: number;
+};
+export {};
+//# sourceMappingURL=shipped-heartbeat.d.ts.map

package/dist/shipped-heartbeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shipped-heartbeat.d.ts","sourceRoot":"","sources":["../src/shipped-heartbeat.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAY,KAAK,KAAK,EAAE,MAAM,aAAa,CAAA;AAElD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AA4BtC,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,KAAK,GAAG,SAAS,GAAG,OAAO,GAAG,aAAa,GAAG,SAAS,CAAA;CAC9D;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAA;IACpB,eAAe,EAAE,MAAM,CAAA;IACvB,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC1C,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAkBD;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,uBAAuB,GAAG,IAAI,CAmBvE;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAEtE;AAED;;GAEG;AACH,iBAAS,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAiB9D;AAID;;GAEG;AACH,iBAAS,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAI5C;AAED;;;GAGG;AACH,iBAAS,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAc/C;AAED;;GAEG;AACH,iBAAS,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAK1D;AAID,iBAAe,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAyF1D;AAeD,wBAAgB,qBAAqB,IAAI,IAAI,CAI5C;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAQ3C;AAED,wBAAgB,wBAAwB,IAAI,cAAc,CAEzD;AAID,eAAO,MAAM,QAAQ;;;;;;;;;;CAUpB,CAAA"}

package/dist/shipped-heartbeat.js

@@ -0,0 +1,272 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) Reflectt AI
+/**
+ * Shipped-Artifact Auto-Heartbeat
+ *
+ * Emits a compact status update to #general when a task transitions to
+ * validating or done AND has an artifact_path in metadata.
+ *
+ * Payload format (sage-validated contract):
+ *   [SHIP] <task_id> | shipped:<ref> | next:<eta> | review:@<reviewer> | by:@<owner>
+ *
+ * Suppression rules:
+ *   1. Dedup window (30m) — same task won't re-fire within 30 minutes
+ *   2. Reviewer override — if reviewer posts in #general within 5m of the
+ *      trigger, the auto-heartbeat is suppressed (they wrote their own)
+ *   3. Missing/invalid artifact — silently skipped with warning log
+ *
+ * Failure modes (documented per done criteria):
+ *   - Duplicate spam: dedup map with 30m TTL prevents double-posts on rapid
+ *     status flips (e.g., validating→blocked→validating)
+ *   - Missing artifact link: task without metadata.artifact_path is skipped;
+ *     logged at warn level for ops visibility
+ *   - Reviewer already posted: 5m look-back in #general for reviewer messages
+ *     mentioning the task ID suppresses the auto-heartbeat
+ *   - Chat budget exceeded: respects existing noise-budget in chat.sendMessage;
+ *     if budget blocks the message, it's logged but not retried
+ *
+ * Task: task-1771691652369-2c2y0uknl
+ * Design: scout (pilot spec) → Implementation: link
+ */
+import { eventBus } from './events.js';
+import { chatManager } from './chat.js';
+// ── Config ──
+const LISTENER_ID = 'shipped-heartbeat';
+/** Dedup window in ms (30 minutes) */
+const DEDUP_WINDOW_MS = 30 * 60 * 1000;
+/** Look-back window for reviewer override check (5 minutes) */
+const REVIEWER_OVERRIDE_WINDOW_MS = 5 * 60 * 1000;
+/** Target channel for heartbeat posts */
+const TARGET_CHANNEL = 'general';
+/** Statuses that trigger the heartbeat */
+const TRIGGER_STATUSES = new Set(['validating', 'done']);
+// ── State ──
+/** Map of taskId → last emit timestamp for dedup */
+const dedupMap = new Map();
+/** Cleanup interval handle */
+let cleanupInterval = null;
+// ── Telemetry ──
+const stats = {
+    totalEmitted: 0,
+    totalSuppressed: 0,
+    suppressionReasons: {},
+    lastEmittedAt: null,
+};
+function recordSuppression(reason) {
+    stats.totalSuppressed++;
+    stats.suppressionReasons[reason] = (stats.suppressionReasons[reason] || 0) + 1;
+}
+// ── Core Logic ──
+/**
+ * Build a compact heartbeat payload from a task.
+ */
+export function buildPayload(task) {
+    const artifactPath = task.metadata?.artifact_path;
+    if (!artifactPath || typeof artifactPath !== 'string') {
+        return null;
+    }
+    const lane = inferLane(task);
+    const eta = task.status === 'done'
+        ? 'done'
+        : task.metadata?.eta ?? 'pending review';
+    return {
+        taskId: task.id,
+        shipped: artifactPath,
+        next: eta,
+        reviewer: task.reviewer ? `@${task.reviewer}` : 'none',
+        owner: task.assignee ? `@${task.assignee}` : 'unknown',
+        lane,
+    };
+}
+/**
+ * Format the canonical compact message.
+ *
+ * Examples:
+ *   [SHIP] task-abc123 | shipped:process/spec.md | next:pending review | review:@sage | by:@scout
+ *   [SHIP] task-def456 | shipped:src/feature.ts | next:done | review:@kai | by:@link
+ *   [SHIP] task-ghi789 | shipped:docs/runbook.md | next:~2h | review:@pixel | by:@echo
+ */
+export function formatMessage(payload) {
+    return `[SHIP] ${payload.taskId} | shipped:${payload.shipped} | next:${payload.next} | review:${payload.reviewer} | by:${payload.owner}`;
+}
+/**
+ * Infer the task lane from metadata, tags, or title keywords.
+ */
+function inferLane(task) {
+    const meta = task.metadata;
+    const roleType = meta?.role_type ?? '';
+    const tags = task.tags ?? [];
+    const title = (task.title ?? '').toLowerCase();
+    if (roleType.includes('ops') || tags.includes('ops'))
+        return 'ops';
+    if (roleType.includes('product') || tags.includes('product'))
+        return 'product';
+    if (roleType.includes('comms') || tags.includes('comms'))
+        return 'comms';
+    if (tags.includes('engineering') || tags.includes('dev'))
+        return 'engineering';
+    // Fallback heuristics from title
+    if (title.includes('deploy') || title.includes('infra') || title.includes('ci'))
+        return 'ops';
+    if (title.includes('design') || title.includes('spec') || title.includes('feature'))
+        return 'product';
+    if (title.includes('announce') || title.includes('blog') || title.includes('docs'))
+        return 'comms';
+    return 'unknown';
+}
+// ── Suppression Checks ──
+/**
+ * Check dedup window — returns true if this task was already emitted recently.
+ */
+function isDuplicate(taskId) {
+    const lastEmit = dedupMap.get(taskId);
+    if (!lastEmit)
+        return false;
+    return (Date.now() - lastEmit) < DEDUP_WINDOW_MS;
+}
+/**
+ * Check if reviewer already posted about this task in #general recently.
+ * Returns true if reviewer override should suppress the auto-heartbeat.
+ */
+function isReviewerOverride(task) {
+    if (!task.reviewer)
+        return false;
+    const cutoff = Date.now() - REVIEWER_OVERRIDE_WINDOW_MS;
+    const recentMessages = chatManager.getMessages({
+        channel: TARGET_CHANNEL,
+        since: cutoff,
+        limit: 20,
+    });
+    return recentMessages.some(msg => msg.from === task.reviewer &&
+        msg.content.includes(task.id));
+}
+/**
+ * Validate artifact_path is under process/ (canonical location).
+ */
+function isValidArtifactPath(artifactPath) {
+    // Accept process/ paths and src/ paths (code artifacts)
+    return artifactPath.startsWith('process/') ||
+        artifactPath.startsWith('src/') ||
+        artifactPath.startsWith('docs/');
+}
+// ── Event Handler ──
+async function handleTaskEvent(event) {
+    if (event.type !== 'task_updated')
+        return;
+    const task = event.data;
+    if (!task?.status || !task?.id)
+        return;
+    // Only trigger on validating/done transitions
+    if (!TRIGGER_STATUSES.has(task.status))
+        return;
+    const artifactPath = task.metadata?.artifact_path;
+    if (!artifactPath || typeof artifactPath !== 'string') {
+        console.warn(`[ShippedHeartbeat] Task ${task.id} → ${task.status} but no artifact_path — skipping`);
+        recordSuppression('missing_artifact');
+        return;
+    }
+    if (!isValidArtifactPath(artifactPath)) {
+        console.warn(`[ShippedHeartbeat] Task ${task.id} has non-canonical artifact_path: ${artifactPath} — skipping`);
+        recordSuppression('invalid_artifact_path');
+        return;
+    }
+    // Suppression: zombie cleanup transitions
+    const meta = task.metadata;
+    const transitionReason = meta?.transition?.reason;
+    if (transitionReason === 'Zombie cleanup' || meta?.auto_close_reason === 'Zombie task cleanup') {
+        console.log(`[ShippedHeartbeat] Task ${task.id} suppressed (zombie cleanup transition)`);
+        recordSuppression('zombie_cleanup');
+        return;
+    }
+    // Suppression: N/A review packet (no real shipped work)
+    const reviewPacket = meta?.qa_bundle?.review_packet;
+    const prUrl = reviewPacket?.pr_url ?? reviewPacket?.pr_link ?? meta?.qa_bundle?.pr_link;
+    const commitSha = reviewPacket?.commit ?? meta?.commit_sha;
+    const isValidPrUrl = typeof prUrl === 'string' && /^https:\/\/github\.com\/.+\/pull\/\d+/.test(prUrl);
+    const isValidCommit = typeof commitSha === 'string' && commitSha.length >= 7 && commitSha !== 'N/A';
+    if (!isValidPrUrl && !isValidCommit) {
+        console.log(`[ShippedHeartbeat] Task ${task.id} suppressed (N/A review packet: pr_url=${prUrl}, commit=${commitSha})`);
+        recordSuppression('invalid_review_packet');
+        return;
+    }
+    // Suppression: dedup window
+    if (isDuplicate(task.id)) {
+        console.log(`[ShippedHeartbeat] Task ${task.id} suppressed (dedup 30m window)`);
+        recordSuppression('dedup_window');
+        return;
+    }
+    // Suppression: reviewer override
+    if (isReviewerOverride(task)) {
+        console.log(`[ShippedHeartbeat] Task ${task.id} suppressed (reviewer @${task.reviewer} already posted)`);
+        recordSuppression('reviewer_override');
+        return;
+    }
+    // Build and send
+    const payload = buildPayload(task);
+    if (!payload) {
+        recordSuppression('payload_build_failed');
+        return;
+    }
+    const message = formatMessage(payload);
+    try {
+        await chatManager.sendMessage({
+            from: 'system',
+            channel: TARGET_CHANNEL,
+            content: message,
+            metadata: {
+                type: 'shipped_heartbeat',
+                taskId: task.id,
+                lane: payload.lane,
+                artifactPath: payload.shipped,
+            },
+        });
+        // Record success
+        dedupMap.set(task.id, Date.now());
+        stats.totalEmitted++;
+        stats.lastEmittedAt = Date.now();
+        console.log(`[ShippedHeartbeat] Emitted for ${task.id}: ${message}`);
+    }
+    catch (err) {
+        console.error(`[ShippedHeartbeat] Failed to send for ${task.id}:`, err);
+    }
+}
+// ── Dedup Cleanup ──
+function cleanupDedupMap() {
+    const cutoff = Date.now() - DEDUP_WINDOW_MS;
+    for (const [taskId, timestamp] of dedupMap) {
+        if (timestamp < cutoff) {
+            dedupMap.delete(taskId);
+        }
+    }
+}
+// ── Lifecycle ──
+export function startShippedHeartbeat() {
+    eventBus.on(LISTENER_ID, handleTaskEvent);
+    cleanupInterval = setInterval(cleanupDedupMap, DEDUP_WINDOW_MS);
+    console.log('[ShippedHeartbeat] Listening for shipped-artifact events');
+}
+export function stopShippedHeartbeat() {
+    eventBus.off(LISTENER_ID);
+    if (cleanupInterval) {
+        clearInterval(cleanupInterval);
+        cleanupInterval = null;
+    }
+    dedupMap.clear();
+    console.log('[ShippedHeartbeat] Stopped');
+}
+export function getShippedHeartbeatStats() {
+    return { ...stats };
+}
+// ── Exports for Testing ──
+export const _testing = {
+    handleTaskEvent,
+    isDuplicate,
+    isReviewerOverride,
+    isValidArtifactPath,
+    inferLane,
+    dedupMap,
+    stats,
+    DEDUP_WINDOW_MS,
+    REVIEWER_OVERRIDE_WINDOW_MS,
+};
+//# sourceMappingURL=shipped-heartbeat.js.map

package/dist/shipped-heartbeat.js.map

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

package/dist/starter-team.d.ts

@@ -0,0 +1,23 @@
+export interface StarterAgent {
+    name: string;
+    role: string;
+    description: string;
+    soulMd: string;
+}
+declare const STARTER_AGENTS: StarterAgent[];
+export interface StarterTeamResult {
+    created: string[];
+    skipped: string[];
+    teamDir: string;
+}
+/**
+ * Scaffold a starter team with default agents.
+ * Creates workspace directories + SOUL.md files.
+ * Idempotent: skips agents that already exist.
+ */
+export declare function createStarterTeam(opts?: {
+    baseDir?: string;
+    agents?: StarterAgent[];
+}): Promise<StarterTeamResult>;
+export { STARTER_AGENTS };
+//# sourceMappingURL=starter-team.d.ts.map

package/dist/starter-team.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"starter-team.d.ts","sourceRoot":"","sources":["../src/starter-team.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,QAAA,MAAM,cAAc,EAAE,YAAY,EAoDjC,CAAA;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,CAAC,EAAE;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,YAAY,EAAE,CAAA;CACxB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAgC7B;AAED,OAAO,EAAE,cAAc,EAAE,CAAA"}

package/dist/starter-team.js

@@ -0,0 +1,88 @@
+// SPDX-License-Identifier: Apache-2.0
+// Starter Team Template — scaffolds a default team configuration.
+import { promises as fs } from 'node:fs';
+import { join } from 'node:path';
+import { DATA_DIR } from './config.js';
+const STARTER_AGENTS = [
+    {
+        name: 'builder',
+        role: 'engineer',
+        description: 'Builds features, fixes bugs, ships code.',
+        soulMd: `# Builder
+
+*I turn ideas into working code.*
+
+## What I Do
+- Full-stack development (frontend, backend, APIs)
+- Code review and quality
+- Testing and debugging
+
+## How I Work
+1. Read existing code first
+2. Make small, focused changes
+3. Test before shipping
+4. Document what I learn
+
+## Rules
+- Ship working code, not demos
+- Quality over quantity
+- Read before writing
+`,
+    },
+    {
+        name: 'ops',
+        role: 'operations',
+        description: 'Monitors systems, manages deployments, keeps things running.',
+        soulMd: `# Ops
+
+*I keep the systems running and the team productive.*
+
+## What I Do
+- Monitor health and performance
+- Review and validate work
+- Manage task flow and priorities
+- Spot blockers before they block
+
+## How I Work
+1. Check system health regularly
+2. Review PRs and task quality
+3. Escalate issues early
+4. Keep the board clean
+
+## Rules
+- Proactive, not reactive
+- Evidence over assumptions
+- Clear communication
+`,
+    },
+];
+/**
+ * Scaffold a starter team with default agents.
+ * Creates workspace directories + SOUL.md files.
+ * Idempotent: skips agents that already exist.
+ */
+export async function createStarterTeam(opts) {
+    const baseDir = opts?.baseDir || join(DATA_DIR, 'agents');
+    const agents = opts?.agents || STARTER_AGENTS;
+    await fs.mkdir(baseDir, { recursive: true });
+    const created = [];
+    const skipped = [];
+    for (const agent of agents) {
+        const agentDir = join(baseDir, agent.name);
+        try {
+            await fs.access(agentDir);
+            skipped.push(agent.name);
+            continue;
+        }
+        catch {
+            // Directory doesn't exist — create it
+        }
+        await fs.mkdir(agentDir, { recursive: true });
+        await fs.writeFile(join(agentDir, 'SOUL.md'), agent.soulMd.trim() + '\n', 'utf-8');
+        await fs.writeFile(join(agentDir, 'AGENTS.md'), `# ${agent.name}\n\nRole: ${agent.role}\n\n${agent.description}\n`, 'utf-8');
+        created.push(agent.name);
+    }
+    return { created, skipped, teamDir: baseDir };
+}
+export { STARTER_AGENTS };
+//# sourceMappingURL=starter-team.js.map

package/dist/starter-team.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"starter-team.js","sourceRoot":"","sources":["../src/starter-team.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,kEAAkE;AAElE,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAA;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAStC,MAAM,cAAc,GAAmB;IACrC;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,0CAA0C;QACvD,MAAM,EAAE;;;;;;;;;;;;;;;;;;;CAmBX;KACE;IACD;QACE,IAAI,EAAE,KAAK;QACX,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,8DAA8D;QAC3E,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;CAoBX;KACE;CACF,CAAA;AAQD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAGvC;IACC,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IACzD,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,cAAc,CAAA;IAE7C,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAE5C,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,MAAM,OAAO,GAAa,EAAE,CAAA;IAE5B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;QAE1C,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;YACzB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YACxB,SAAQ;QACV,CAAC;QAAC,MAAM,CAAC;YACP,sCAAsC;QACxC,CAAC;QAED,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC7C,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,EAAE,OAAO,CAAC,CAAA;QAClF,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,EAC3B,KAAK,KAAK,CAAC,IAAI,aAAa,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,WAAW,IAAI,EAClE,OAAO,CACR,CAAA;QAED,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC1B,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAA;AAC/C,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,CAAA"}

package/dist/suppression-ledger.d.ts

@@ -0,0 +1,73 @@
+export interface SuppressionEntry {
+    id: number;
+    dedup_key: string;
+    category: string;
+    channel: string;
+    from: string;
+    content_preview: string | null;
+    first_seen_at: number;
+    last_seen_at: number;
+    hit_count: number;
+    suppressed: boolean;
+    window_ms: number;
+}
+export interface SuppressionCheckResult {
+    isDuplicate: boolean;
+    dedup_key: string;
+    existing?: SuppressionEntry;
+}
+export interface SuppressionStats {
+    total_entries: number;
+    total_suppressed: number;
+    total_hits: number;
+    by_category: Record<string, {
+        entries: number;
+        suppressed: number;
+        hits: number;
+    }>;
+    by_channel: Record<string, {
+        entries: number;
+        suppressed: number;
+        hits: number;
+    }>;
+    window_ms: number;
+    active_entries: number;
+}
+export declare class SuppressionLedger {
+    private windowMs;
+    constructor(windowMs?: number);
+    /**
+     * Compute a dedup key from category + channel + content.
+     * Content is normalized: timestamps, task IDs, and message IDs stripped.
+     */
+    computeDedupKey(category: string, channel: string, content: string): string;
+    /**
+     * Check if a message is a duplicate within the suppression window.
+     * If not a duplicate, records it in the ledger.
+     * If duplicate, increments the hit count and marks as suppressed.
+     */
+    check(opts: {
+        category: string;
+        channel: string;
+        from: string;
+        content: string;
+    }): SuppressionCheckResult;
+    /**
+     * Get suppression statistics.
+     */
+    getStats(): SuppressionStats;
+    /**
+     * Prune old entries outside the window.
+     */
+    prune(): number;
+    /**
+     * Get window in ms.
+     */
+    getWindowMs(): number;
+    /**
+     * Update window.
+     */
+    setWindowMs(ms: number): void;
+}
+export declare const suppressionLedger: SuppressionLedger;
+//# sourceMappingURL=suppression-ledger.d.ts.map

package/dist/suppression-ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suppression-ledger.d.ts","sourceRoot":"","sources":["../src/suppression-ledger.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,OAAO,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,OAAO,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,gBAAgB,CAAA;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAA;IACrB,gBAAgB,EAAE,MAAM,CAAA;IACxB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAClF,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACjF,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;CACvB;AAID,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAQ;gBAEZ,QAAQ,CAAC,EAAE,MAAM;IAI7B;;;OAGG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAY3E;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE;QACV,QAAQ,EAAE,MAAM,CAAA;QAChB,OAAO,EAAE,MAAM,CAAA;QACf,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,MAAM,CAAA;KAChB,GAAG,sBAAsB;IAyD1B;;OAEG;IACH,QAAQ,IAAI,gBAAgB;IAqC5B;;OAEG;IACH,KAAK,IAAI,MAAM;IAOf;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;CAG9B;AAED,eAAO,MAAM,iBAAiB,mBAA0B,CAAA"}