@backendkit-labs/agent-enterprise 0.3.2 → 0.4.0

package/dist/__tests__/unit/ProfilePolicies.test.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Structural compliance test for Fase 4 — Policies-in-vault (ADR-4).
+ *
+ * Criterio de salida: grep of hardcoded thresholds/matrices in ALL system prompts → 0 matches.
+ * The prompts must instruct agents to retrieve current policies via their search tool at runtime.
+ */
+const profiles_1 = require("../../profiles");
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function violations(prompt, pattern) {
+    const matches = [];
+    for (const line of prompt.split('\n')) {
+        if (pattern.test(line))
+            matches.push(line.trim());
+    }
+    return matches;
+}
+// ── Criterio de salida: zero hardcoded thresholds ─────────────────────────────
+describe('Fase 4 — criterio de salida: no hardcoded business rules in system prompts', () => {
+    for (const profile of profiles_1.ALL_ENTERPRISE_PROFILES) {
+        const prompt = profile.systemPrompt ?? '';
+        it(`[${profile.id}] must not contain hardcoded currency amounts ($NNN)`, () => {
+            const found = violations(prompt, /\$\d/);
+            expect(found).toEqual([]);
+        });
+        it(`[${profile.id}] must not contain hardcoded percentage thresholds (NN%)`, () => {
+            // Exclude "100%" which is never a business threshold
+            const found = violations(prompt, /\b(?!100)\d+%/);
+            expect(found).toEqual([]);
+        });
+        it(`[${profile.id}] must not contain hardcoded severity codes (P1:, P2:, P3:, P4:)`, () => {
+            const found = violations(prompt, /\bP[1-4]:/);
+            expect(found).toEqual([]);
+        });
+        it(`[${profile.id}] must not contain hardcoded escalation tiers (Tier N:)`, () => {
+            const found = violations(prompt, /\bTier\s+[123]:/i);
+            expect(found).toEqual([]);
+        });
+    }
+});
+// ── Prompts must reference their search tool for policy lookups ───────────────
+describe('Profiles — prompts instruct to use search tool for policy lookups', () => {
+    const POLICY_AGENTS = [
+        { id: 'finance', tool: 'search_finance_kb', keyword: 'approval' },
+        { id: 'hr', tool: 'search_hr_kb', keyword: 'privacy' },
+        { id: 'sales', tool: 'search_sales_kb', keyword: 'discount' },
+        { id: 'ops', tool: 'search_ops_kb', keyword: 'severity' },
+        { id: 'support', tool: 'search_support_kb', keyword: 'escalation' },
+    ];
+    for (const { id, tool, keyword } of POLICY_AGENTS) {
+        const profile = profiles_1.ALL_ENTERPRISE_PROFILES.find(p => p.id === id);
+        it(`[${id}] prompt references its domain search tool (${tool})`, () => {
+            expect(profile.systemPrompt).toContain(tool);
+        });
+        it(`[${id}] prompt contains a policy search instruction related to '${keyword}'`, () => {
+            expect(profile.systemPrompt?.toLowerCase()).toContain(keyword);
+        });
+    }
+});
+// ── All profiles have non-empty systemPrompts ─────────────────────────────────
+describe('All profiles have well-formed system prompts', () => {
+    for (const profile of profiles_1.ALL_ENTERPRISE_PROFILES) {
+        it(`[${profile.id}] has a non-empty systemPrompt`, () => {
+            expect(typeof profile.systemPrompt).toBe('string');
+            expect((profile.systemPrompt ?? '').length).toBeGreaterThan(50);
+        });
+    }
+});
+//# sourceMappingURL=ProfilePolicies.test.js.map

package/dist/__tests__/unit/ProfilePolicies.test.js.map

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

package/dist/__tests__/unit/ReconciliationSweeper.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ReconciliationSweeper.test.d.ts.map

package/dist/__tests__/unit/ReconciliationSweeper.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReconciliationSweeper.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/ReconciliationSweeper.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/unit/ReconciliationSweeper.test.js

@@ -0,0 +1,235 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const ReconciliationSweeper_1 = require("../../events/ReconciliationSweeper");
+// ── Helpers ───────────────────────────────────────────────────────────────────
+async function makeTmpVault() {
+    const dir = await fs.mkdtemp(path.join(os.tmpdir(), 'sweeper-'));
+    await fs.mkdir(path.join(dir, 'eventos'), { recursive: true });
+    await fs.mkdir(path.join(dir, 'auditoria'), { recursive: true });
+    return dir;
+}
+function eventNote(eventId, type = 'contratacion', source = 'hr-system') {
+    return [
+        '---',
+        `title: "Event: ${type} (${eventId})"`,
+        `author: "agent/${source}"`,
+        `date: 2026-06-11`,
+        `tags: ["evento"]`,
+        '---',
+        '',
+        `## Event: ${type}`,
+        '',
+        '| Field | Value |',
+        '|-------|-------|',
+        `| ID | \`${eventId}\` |`,
+        `| Type | \`${type}\` |`,
+        `| Occurred | 2026-06-11T10:00:00.000Z |`,
+        `| Source | \`${source}\` |`,
+        `| Version | 1 |`,
+    ].join('\n');
+}
+function auditNote(eventId) {
+    return `# Audit\n\nProcessed event ${eventId} successfully.\n`;
+}
+async function writeEventNote(vault, eventId, type = 'contratacion') {
+    const file = path.join(vault, 'eventos', `${eventId}.md`);
+    await fs.writeFile(file, eventNote(eventId, type), 'utf-8');
+}
+async function writeAuditNote(vault, eventId, subfolder = '') {
+    const dir = subfolder
+        ? path.join(vault, 'auditoria', subfolder)
+        : path.join(vault, 'auditoria');
+    await fs.mkdir(dir, { recursive: true });
+    await fs.writeFile(path.join(dir, `${eventId}-audit.md`), auditNote(eventId), 'utf-8');
+}
+// ── sweep — empty / missing folders ──────────────────────────────────────────
+describe('ReconciliationSweeper — empty vault', () => {
+    it('returns empty report when eventos folder is missing', async () => {
+        const vault = await fs.mkdtemp(path.join(os.tmpdir(), 'sw-'));
+        try {
+            const sweeper = new ReconciliationSweeper_1.ReconciliationSweeper({ vaultPath: vault });
+            const report = await sweeper.sweep();
+            expect(report.checked).toBe(0);
+            expect(report.orphaned).toEqual([]);
+        }
+        finally {
+            await fs.rm(vault, { recursive: true, force: true });
+        }
+    });
+    it('returns empty report when both folders are empty', async () => {
+        const vault = await makeTmpVault();
+        try {
+            const sweeper = new ReconciliationSweeper_1.ReconciliationSweeper({ vaultPath: vault });
+            const report = await sweeper.sweep();
+            expect(report.checked).toBe(0);
+            expect(report.matched).toBe(0);
+        }
+        finally {
+            await fs.rm(vault, { recursive: true, force: true });
+        }
+    });
+});
+// ── sweep — matching ──────────────────────────────────────────────────────────
+describe('ReconciliationSweeper — matched events', () => {
+    let vault;
+    beforeEach(async () => { vault = await makeTmpVault(); });
+    afterEach(async () => { await fs.rm(vault, { recursive: true, force: true }); });
+    it('reports checked=1, matched=1, orphaned=[] when event has an audit note', async () => {
+        const id = 'evt-abc-001';
+        await writeEventNote(vault, id);
+        await writeAuditNote(vault, id);
+        const sweeper = new ReconciliationSweeper_1.ReconciliationSweeper({ vaultPath: vault });
+        const report = await sweeper.sweep();
+        expect(report.checked).toBe(1);
+        expect(report.matched).toBe(1);
+        expect(report.orphaned).toEqual([]);
+    });
+    it('matches event IDs in nested audit subfolders', async () => {
+        const id = 'evt-abc-002';
+        await writeEventNote(vault, id);
+        await writeAuditNote(vault, id, 'onboarding/run-xyz');
+        const sweeper = new ReconciliationSweeper_1.ReconciliationSweeper({ vaultPath: vault });
+        const report = await sweeper.sweep();
+        expect(report.matched).toBe(1);
+        expect(report.orphaned).toEqual([]);
+    });
+    it('handles multiple events — all with audit notes', async () => {
+        for (let i = 0; i < 3; i++) {
+            const id = `evt-abc-${i}`;
+            await writeEventNote(vault, id);
+            await writeAuditNote(vault, id);
+        }
+        const sweeper = new ReconciliationSweeper_1.ReconciliationSweeper({ vaultPath: vault });
+        const report = await sweeper.sweep();
+        expect(report.checked).toBe(3);
+        expect(report.matched).toBe(3);
+        expect(report.orphaned).toHaveLength(0);
+    });
+});
+// ── sweep — orphaned events ───────────────────────────────────────────────────
+describe('ReconciliationSweeper — orphaned events', () => {
+    let vault;
+    beforeEach(async () => { vault = await makeTmpVault(); });
+    afterEach(async () => { await fs.rm(vault, { recursive: true, force: true }); });
+    it('reports an orphaned event when no audit note exists', async () => {
+        const id = 'evt-orphan-001';
+        await writeEventNote(vault, id, 'contratacion');
+        const sweeper = new ReconciliationSweeper_1.ReconciliationSweeper({ vaultPath: vault });
+        const report = await sweeper.sweep();
+        expect(report.checked).toBe(1);
+        expect(report.matched).toBe(0);
+        expect(report.orphaned).toHaveLength(1);
+        expect(report.orphaned[0].eventId).toBe(id);
+        expect(report.orphaned[0].type).toBe('contratacion');
+    });
+    it('reports partial orphans: 1 matched, 1 orphaned', async () => {
+        const matched = 'evt-matched-001';
+        const orphan = 'evt-orphan-002';
+        await writeEventNote(vault, matched);
+        await writeAuditNote(vault, matched);
+        await writeEventNote(vault, orphan);
+        const sweeper = new ReconciliationSweeper_1.ReconciliationSweeper({ vaultPath: vault });
+        const report = await sweeper.sweep();
+        expect(report.checked).toBe(2);
+        expect(report.matched).toBe(1);
+        expect(report.orphaned.map(o => o.eventId)).toEqual([orphan]);
+    });
+    it('includes notePath pointing to the event note file', async () => {
+        const id = 'evt-orphan-path';
+        await writeEventNote(vault, id);
+        const sweeper = new ReconciliationSweeper_1.ReconciliationSweeper({ vaultPath: vault });
+        const report = await sweeper.sweep();
+        expect(report.orphaned[0].notePath).toContain('eventos');
+        expect(report.orphaned[0].notePath).toContain('.md');
+    });
+    it('report.sweptAt is a valid ISO timestamp', async () => {
+        const sweeper = new ReconciliationSweeper_1.ReconciliationSweeper({ vaultPath: vault });
+        const report = await sweeper.sweep();
+        expect(report.sweptAt).toMatch(/^\d{4}-\d{2}-\d{2}T/);
+    });
+});
+// ── Custom folders ────────────────────────────────────────────────────────────
+describe('ReconciliationSweeper — custom folders', () => {
+    it('respects custom eventsFolder and auditFolder options', async () => {
+        const vault = await fs.mkdtemp(path.join(os.tmpdir(), 'sw-custom-'));
+        try {
+            const id = 'evt-custom-001';
+            await fs.mkdir(path.join(vault, 'pub'), { recursive: true });
+            await fs.mkdir(path.join(vault, 'logs'), { recursive: true });
+            await fs.writeFile(path.join(vault, 'pub', `${id}.md`), eventNote(id), 'utf-8');
+            const sweeper = new ReconciliationSweeper_1.ReconciliationSweeper({
+                vaultPath: vault,
+                eventsFolder: 'pub',
+                auditFolder: 'logs',
+            });
+            const report = await sweeper.sweep();
+            expect(report.checked).toBe(1);
+            expect(report.orphaned).toHaveLength(1);
+        }
+        finally {
+            await fs.rm(vault, { recursive: true, force: true });
+        }
+    });
+});
+// ── Criterio de salida fase 3 ─────────────────────────────────────────────────
+describe('Fase 3 — criterio de salida (sweeper detects injected orphan)', () => {
+    it('detects an event without an audit note injected on purpose', async () => {
+        const vault = await makeTmpVault();
+        try {
+            // 2 events with audit notes (normal flow)
+            for (const id of ['evt-ok-1', 'evt-ok-2']) {
+                await writeEventNote(vault, id);
+                await writeAuditNote(vault, id);
+            }
+            // 1 orphan injected on purpose — no audit note
+            await writeEventNote(vault, 'evt-orphan-injected', 'solicitud-compra');
+            const sweeper = new ReconciliationSweeper_1.ReconciliationSweeper({ vaultPath: vault });
+            const report = await sweeper.sweep();
+            expect(report.checked).toBe(3);
+            expect(report.matched).toBe(2);
+            expect(report.orphaned).toHaveLength(1);
+            expect(report.orphaned[0].eventId).toBe('evt-orphan-injected');
+            expect(report.orphaned[0].type).toBe('solicitud-compra');
+        }
+        finally {
+            await fs.rm(vault, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=ReconciliationSweeper.test.js.map

package/dist/__tests__/unit/ReconciliationSweeper.test.js.map

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

package/dist/__tests__/unit/n8nTriggerTool.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=n8nTriggerTool.test.d.ts.map

package/dist/__tests__/unit/n8nTriggerTool.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"n8nTriggerTool.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/n8nTriggerTool.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/unit/n8nTriggerTool.test.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const n8nTriggerTool_1 = require("../../integrations/n8nTriggerTool");
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function mockFetch(ok, text, status = 200) {
+    return jest.fn().mockResolvedValue({ ok, status, text: jest.fn().mockResolvedValue(text) });
+}
+const WEBHOOK = 'https://n8n.internal/webhook/abc123';
+// ── Construction ──────────────────────────────────────────────────────────────
+describe('createN8nTriggerTool — construction', () => {
+    it('throws when no URL is configured', () => {
+        delete process.env.N8N_WEBHOOK_URL;
+        expect(() => (0, n8nTriggerTool_1.createN8nTriggerTool)()).toThrow('N8N_WEBHOOK_URL');
+    });
+    it('accepts URL via opts.webhookUrl', () => {
+        expect(() => (0, n8nTriggerTool_1.createN8nTriggerTool)({ webhookUrl: WEBHOOK })).not.toThrow();
+    });
+    it('falls back to N8N_WEBHOOK_URL env var', () => {
+        process.env.N8N_WEBHOOK_URL = WEBHOOK;
+        expect(() => (0, n8nTriggerTool_1.createN8nTriggerTool)()).not.toThrow();
+        delete process.env.N8N_WEBHOOK_URL;
+    });
+    it('returns a tool with name "n8n_trigger"', () => {
+        const tool = (0, n8nTriggerTool_1.createN8nTriggerTool)({ webhookUrl: WEBHOOK });
+        expect(tool.name).toBe('n8n_trigger');
+    });
+});
+// ── execute — happy path ──────────────────────────────────────────────────────
+describe('createN8nTriggerTool — execute', () => {
+    let fetchMock;
+    beforeEach(() => {
+        fetchMock = mockFetch(true, 'ok');
+        global.fetch = fetchMock;
+    });
+    afterEach(() => { jest.restoreAllMocks(); });
+    it('calls fetch with POST, correct URL, and Content-Type header', async () => {
+        const tool = (0, n8nTriggerTool_1.createN8nTriggerTool)({ webhookUrl: WEBHOOK });
+        await tool.execute({ event: 'test.event', payload: {}, correlation_id: 'cid-1' });
+        expect(fetchMock).toHaveBeenCalledTimes(1);
+        const [url, init] = fetchMock.mock.calls[0];
+        expect(url).toBe(WEBHOOK);
+        expect(init.method).toBe('POST');
+        expect(init.headers['Content-Type']).toBe('application/json');
+    });
+    it('serializes event + payload + correlationId in body', async () => {
+        const tool = (0, n8nTriggerTool_1.createN8nTriggerTool)({ webhookUrl: WEBHOOK });
+        await tool.execute({
+            event: 'employee.onboarded',
+            payload: { employee_id: 42, name: 'Ana' },
+            correlation_id: 'cid-2',
+        });
+        const body = JSON.parse(fetchMock.mock.calls[0][1].body);
+        expect(body.event).toBe('employee.onboarded');
+        expect(body.correlationId).toBe('cid-2');
+        expect(body.employee_id).toBe(42);
+        expect(body.name).toBe('Ana');
+    });
+    it('auto-generates a UUID correlation_id when omitted', async () => {
+        const tool = (0, n8nTriggerTool_1.createN8nTriggerTool)({ webhookUrl: WEBHOOK });
+        await tool.execute({ event: 'x', payload: {} });
+        const body = JSON.parse(fetchMock.mock.calls[0][1].body);
+        expect(body.correlationId).toMatch(/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i);
+    });
+    it('returns the event name and correlation_id in the result', async () => {
+        const tool = (0, n8nTriggerTool_1.createN8nTriggerTool)({ webhookUrl: WEBHOOK });
+        const result = await tool.execute({
+            event: 'invoice.approved',
+            payload: {},
+            correlation_id: 'trace-99',
+        });
+        expect(result).toContain('invoice.approved');
+        expect(result).toContain('trace-99');
+    });
+    it('includes n8n response text in result when non-empty', async () => {
+        fetchMock = mockFetch(true, '{"workflowId":"wf-1"}');
+        global.fetch = fetchMock;
+        const tool = (0, n8nTriggerTool_1.createN8nTriggerTool)({ webhookUrl: WEBHOOK });
+        const result = await tool.execute({ event: 'x', payload: {} });
+        expect(result).toContain('wf-1');
+    });
+    it('throws on non-OK HTTP response', async () => {
+        fetchMock = mockFetch(false, 'Webhook not found', 404);
+        global.fetch = fetchMock;
+        const tool = (0, n8nTriggerTool_1.createN8nTriggerTool)({ webhookUrl: WEBHOOK });
+        await expect(tool.execute({ event: 'x', payload: {} })).rejects.toThrow('404');
+    });
+});
+// ── criterio de salida ─────────────────────────────────────────────────────────
+describe('n8n_trigger — criterio de salida', () => {
+    beforeEach(() => { global.fetch = mockFetch(true, 'triggered'); });
+    afterEach(() => jest.restoreAllMocks());
+    it('two separate calls produce different correlation IDs', async () => {
+        const tool = (0, n8nTriggerTool_1.createN8nTriggerTool)({ webhookUrl: WEBHOOK });
+        const r1 = await tool.execute({ event: 'a', payload: {} });
+        const r2 = await tool.execute({ event: 'b', payload: {} });
+        const id1 = r1.match(/correlationId: (\S+)/)?.[1];
+        const id2 = r2.match(/correlationId: (\S+)/)?.[1];
+        expect(id1).toBeDefined();
+        expect(id2).toBeDefined();
+        expect(id1).not.toBe(id2);
+    });
+});
+//# sourceMappingURL=n8nTriggerTool.test.js.map

package/dist/__tests__/unit/n8nTriggerTool.test.js.map

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

package/dist/events/EventPublisher.d.ts

@@ -0,0 +1,47 @@
+import type { EventEnvelope, EventSchema, PublishOptions } from './types';
+/**
+ * Minimal subset of the BullMQ Queue API required by EventPublisher.
+ * Satisfied by a real BullMQ Queue without importing bullmq at build time.
+ */
+export interface QueueLike {
+    name: string;
+    add(jobName: string, data: unknown, opts?: {
+        attempts?: number;
+        backoff?: {
+            type: string;
+            delay: number;
+        };
+        removeOnComplete?: boolean | {
+            count: number;
+        };
+        removeOnFail?: boolean | {
+            count: number;
+        };
+        jobId?: string;
+    }): Promise<{
+        id?: string | undefined;
+    }>;
+}
+export interface EventPublisherOptions {
+    /** BullMQ Queue (or any QueueLike). Must target the right queue name. */
+    queue: QueueLike;
+    /** Absolute path to the shared vault. Events are written to {vaultPath}/eventos/. */
+    vaultPath: string;
+    /** Publisher identity (agentId, system name) written into the envelope and vault note. */
+    source: string;
+}
+/**
+ * Publishes a typed, validated event in a single atomic call:
+ *   1. Validates payload against the EventSchema's Zod schema.
+ *   2. Creates an EventEnvelope with a UUID and ISO timestamp.
+ *   3. Adds the job to the BullMQ queue (retry config, removeOnComplete: false for reconciliation).
+ *   4. Writes a canonical vault note to /eventos/ so the event is auditable and RAG-queryable.
+ */
+export declare class EventPublisher {
+    private readonly opts;
+    private readonly vaultWriter;
+    constructor(opts: EventPublisherOptions);
+    publish<T>(schema: EventSchema<T>, payload: T, options?: PublishOptions): Promise<EventEnvelope<T>>;
+    private writeEventNote;
+}
+//# sourceMappingURL=EventPublisher.d.ts.map

package/dist/events/EventPublisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventPublisher.d.ts","sourceRoot":"","sources":["../../src/events/EventPublisher.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI1E;;;GAGG;AACH,MAAM,WAAW,SAAS;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CACC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,OAAO,EACb,IAAI,CAAC,EAAE;QACH,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QAC1C,gBAAgB,CAAC,EAAE,OAAO,GAAG;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QAC/C,YAAY,CAAC,EAAE,OAAO,GAAG;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,GACF,OAAO,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC,CAAC;CAC3C;AAID,MAAM,WAAW,qBAAqB;IAClC,yEAAyE;IACzE,KAAK,EAAE,SAAS,CAAC;IACjB,qFAAqF;IACrF,SAAS,EAAE,MAAM,CAAC;IAClB,0FAA0F;IAC1F,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,qBAAa,cAAc;IAGX,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;gBAEb,IAAI,EAAE,qBAAqB;IAOlD,OAAO,CAAC,CAAC,EACX,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EACtB,OAAO,EAAE,CAAC,EACV,OAAO,CAAC,EAAE,cAAc,GACzB,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;YA8Bd,cAAc;CA6B/B"}

package/dist/events/EventPublisher.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventPublisher = void 0;
+const crypto_1 = require("crypto");
+const VaultWriter_1 = require("../rag/VaultWriter");
+/**
+ * Publishes a typed, validated event in a single atomic call:
+ *   1. Validates payload against the EventSchema's Zod schema.
+ *   2. Creates an EventEnvelope with a UUID and ISO timestamp.
+ *   3. Adds the job to the BullMQ queue (retry config, removeOnComplete: false for reconciliation).
+ *   4. Writes a canonical vault note to /eventos/ so the event is auditable and RAG-queryable.
+ */
+class EventPublisher {
+    opts;
+    vaultWriter;
+    constructor(opts) {
+        this.opts = opts;
+        this.vaultWriter = new VaultWriter_1.VaultWriter({
+            vaultPath: opts.vaultPath,
+            agentFolder: 'eventos',
+        });
+    }
+    async publish(schema, payload, options) {
+        // Validate — throws ZodError if payload doesn't match the schema
+        schema.schema.parse(payload);
+        const envelope = {
+            id: (0, crypto_1.randomUUID)(),
+            type: schema.type,
+            occurredAt: new Date().toISOString(),
+            source: this.opts.source,
+            version: schema.version,
+            payload,
+        };
+        const jobId = options?.jobId ?? envelope.id;
+        await this.opts.queue.add(schema.type, envelope, {
+            attempts: options?.attempts ?? 3,
+            backoff: { type: 'exponential', delay: options?.backoffDelay ?? 1000 },
+            removeOnComplete: false, // keep completed jobs available for reconciliation
+            removeOnFail: false,
+            jobId,
+        });
+        await this.writeEventNote(envelope);
+        return envelope;
+    }
+    // ── Private ───────────────────────────────────────────────────────────────
+    async writeEventNote(envelope) {
+        const payloadJson = JSON.stringify(envelope.payload, null, 2);
+        const content = [
+            `## Event: ${envelope.type}`,
+            '',
+            '| Field | Value |',
+            '|-------|-------|',
+            `| ID | \`${envelope.id}\` |`,
+            `| Type | \`${envelope.type}\` |`,
+            `| Occurred | ${envelope.occurredAt} |`,
+            `| Source | \`${envelope.source}\` |`,
+            `| Version | ${envelope.version} |`,
+            '',
+            '### Payload',
+            '',
+            '```json',
+            payloadJson,
+            '```',
+        ].join('\n');
+        await this.vaultWriter.writeNote({
+            title: `Event: ${envelope.type} (${envelope.id})`,
+            content,
+            agentId: envelope.source,
+            tags: ['evento', `tipo/${envelope.type}`],
+            description: `Published event — type: ${envelope.type}, source: ${envelope.source}`,
+        });
+    }
+}
+exports.EventPublisher = EventPublisher;
+//# sourceMappingURL=EventPublisher.js.map

package/dist/events/EventPublisher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventPublisher.js","sourceRoot":"","sources":["../../src/events/EventPublisher.ts"],"names":[],"mappings":";;;AAAA,mCAAoC;AACpC,oDAAiD;AAmCjD;;;;;;GAMG;AACH,MAAa,cAAc;IAGM;IAFZ,WAAW,CAAc;IAE1C,YAA6B,IAA2B;QAA3B,SAAI,GAAJ,IAAI,CAAuB;QACpD,IAAI,CAAC,WAAW,GAAG,IAAI,yBAAW,CAAC;YAC/B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,WAAW,EAAE,SAAS;SACzB,CAAC,CAAC;IACP,CAAC;IAED,KAAK,CAAC,OAAO,CACT,MAAsB,EACtB,OAAU,EACV,OAAwB;QAExB,iEAAiE;QACjE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAE7B,MAAM,QAAQ,GAAqB;YAC/B,EAAE,EAAE,IAAA,mBAAU,GAAE;YAChB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM;YACxB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,OAAO;SACV,CAAC;QAEF,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,QAAQ,CAAC,EAAE,CAAC;QAE5C,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE;YAC7C,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,CAAC;YAChC,OAAO,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,IAAI,IAAI,EAAE;YACtE,gBAAgB,EAAE,KAAK,EAAG,mDAAmD;YAC7E,YAAY,EAAE,KAAK;YACnB,KAAK;SACR,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAEpC,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED,6EAA6E;IAErE,KAAK,CAAC,cAAc,CAAI,QAA0B;QACtD,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAE9D,MAAM,OAAO,GAAG;YACZ,aAAa,QAAQ,CAAC,IAAI,EAAE;YAC5B,EAAE;YACF,mBAAmB;YACnB,mBAAmB;YACnB,YAAY,QAAQ,CAAC,EAAE,MAAM;YAC7B,cAAc,QAAQ,CAAC,IAAI,MAAM;YACjC,gBAAgB,QAAQ,CAAC,UAAU,IAAI;YACvC,gBAAgB,QAAQ,CAAC,MAAM,MAAM;YACrC,eAAe,QAAQ,CAAC,OAAO,IAAI;YACnC,EAAE;YACF,aAAa;YACb,EAAE;YACF,SAAS;YACT,WAAW;YACX,KAAK;SACR,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC;YAC7B,KAAK,EAAE,UAAU,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,EAAE,GAAG;YACjD,OAAO;YACP,OAAO,EAAE,QAAQ,CAAC,MAAM;YACxB,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;YACzC,WAAW,EAAE,2BAA2B,QAAQ,CAAC,IAAI,aAAa,QAAQ,CAAC,MAAM,EAAE;SACtF,CAAC,CAAC;IACP,CAAC;CACJ;AAzED,wCAyEC"}

package/dist/events/ReconciliationSweeper.d.ts

@@ -0,0 +1,37 @@
+import type { ReconciliationReport } from './types';
+export interface ReconciliationSweeperOptions {
+    /** Absolute path to the shared vault. */
+    vaultPath: string;
+    /** Subfolder where EventPublisher writes event notes. Default: 'eventos' */
+    eventsFolder?: string;
+    /** Subfolder tree where consumers write audit notes. Default: 'auditoria' */
+    auditFolder?: string;
+}
+/**
+ * Compares published events (vault /eventos/) against audit notes (vault /auditoria/).
+ *
+ * Each event note written by EventPublisher contains a table row:
+ *   | ID | `<event-uuid>` |
+ *
+ * The sweeper extracts these IDs and checks if the text appears anywhere in
+ * the /auditoria/ subtree. Events without a matching audit note are "orphaned".
+ *
+ * This detects consistency gaps without an outbox transaction, using the vault
+ * as the source of truth (ADR-1).
+ */
+export declare class ReconciliationSweeper {
+    private readonly vaultPath;
+    private readonly eventsFolder;
+    private readonly auditFolder;
+    constructor(opts: ReconciliationSweeperOptions);
+    sweep(): Promise<ReconciliationReport>;
+    private readEventNotes;
+    private readAuditContent;
+    private collectContent;
+    /**
+     * Extracts a value from a Markdown table row of the form:
+     *   | FieldName | `value` |  or  | FieldName | value |
+     */
+    private extractTableField;
+}
+//# sourceMappingURL=ReconciliationSweeper.d.ts.map

package/dist/events/ReconciliationSweeper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReconciliationSweeper.d.ts","sourceRoot":"","sources":["../../src/events/ReconciliationSweeper.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAiB,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEnE,MAAM,WAAW,4BAA4B;IACzC,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,qBAAqB;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,IAAI,EAAE,4BAA4B;IAMxC,KAAK,IAAI,OAAO,CAAC,oBAAoB,CAAC;YAyB9B,cAAc;YA6Bd,gBAAgB;YAShB,cAAc;IAmB5B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;CAO5B"}