@citadel-labs/citadel 0.1.0

package/dist/__tests__/fo-task-report.test.js

@@ -0,0 +1,81 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import { handleTaskReport } from '../core/fo-task-report.js';
+import { readBeads } from '../core/append-bead.js';
+describe('handleTaskReport', () => {
+    let tmpDir;
+    beforeEach(async () => {
+        tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'citadel-report-'));
+        await fs.mkdir(path.join(tmpDir, '.citadel'), { recursive: true });
+    });
+    afterEach(async () => {
+        await fs.rm(tmpDir, { recursive: true, force: true });
+    });
+    const makeReport = (status, extras) => ({
+        bead_id: 'bead-report-1',
+        bead_type: 'MAIL',
+        schema_version: '9.0',
+        created_at: '2026-01-01T00:00:00Z',
+        task_id: 'task-123',
+        mail_type: 'TASK_REPORT',
+        from: 'alpha',
+        to: 'citadel',
+        subject: `Report: task-123`,
+        read: false,
+        retry_of: null,
+        payload: {
+            status: status,
+            summary: 'Status update',
+            blockers: [],
+            questions: [],
+            context_refs: [],
+            ...extras,
+        },
+    });
+    it('logs IN_PROGRESS without escalating', async () => {
+        const result = await handleTaskReport(tmpDir, makeReport('IN_PROGRESS'));
+        expect(result.status).toBe('IN_PROGRESS');
+        expect(result.action).toBe('logged');
+        expect(result.commandBeadPath).toBeUndefined();
+    });
+    it('escalates BLOCKED to Commander with blocker details', async () => {
+        const report = makeReport('BLOCKED', {
+            blockers: ['API rate limit', 'Missing credentials'],
+            summary: 'Cannot proceed',
+        });
+        const result = await handleTaskReport(tmpDir, report);
+        expect(result.status).toBe('BLOCKED');
+        expect(result.action).toBe('escalated');
+        expect(result.commandBeadPath).toBeDefined();
+        // Verify escalation file was written
+        const mails = await readBeads(result.commandBeadPath);
+        expect(mails).toHaveLength(1);
+        expect(mails[0].to).toBe('commander');
+        expect(mails[0].subject).toContain('BLOCKED');
+        const payload = mails[0].payload;
+        expect(payload.blockers).toEqual(['API rate limit', 'Missing credentials']);
+    });
+    it('escalates NEEDS_INPUT with questions', async () => {
+        const report = makeReport('NEEDS_INPUT', {
+            questions: ['Which database to use?', 'Preferred auth method?'],
+            summary: 'Need clarification',
+        });
+        const result = await handleTaskReport(tmpDir, report);
+        expect(result.status).toBe('NEEDS_INPUT');
+        expect(result.action).toBe('escalated');
+        const mails = await readBeads(result.commandBeadPath);
+        expect(mails).toHaveLength(1);
+        expect(mails[0].subject).toContain('NEEDS_INPUT');
+        const payload = mails[0].payload;
+        expect(payload.questions).toEqual(['Which database to use?', 'Preferred auth method?']);
+    });
+    it('logs COMPLETE without escalating', async () => {
+        const result = await handleTaskReport(tmpDir, makeReport('COMPLETE'));
+        expect(result.status).toBe('COMPLETE');
+        expect(result.action).toBe('logged');
+        expect(result.commandBeadPath).toBeUndefined();
+    });
+});
+//# sourceMappingURL=fo-task-report.test.js.map

package/dist/__tests__/fo-task-report.test.js.map

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

package/dist/__tests__/fo-webhook.test.d.ts

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

package/dist/__tests__/fo-webhook.test.d.ts.map

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

package/dist/__tests__/fo-webhook.test.js

@@ -0,0 +1,70 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { broadcastWebhook } from '../core/fo-webhook.js';
+describe('broadcastWebhook', () => {
+    const tribute = {
+        bead_id: 'tribute-1',
+        bead_type: 'TRIBUTE',
+        schema_version: '9.0',
+        created_at: '2026-01-01T01:00:00Z',
+        citizen_id: 'citizen-1',
+        task_id: 'task-1',
+        originating_mail_ref: 'bead-1',
+        archetype: 'software-engineer',
+        outpost: 'alpha',
+        worktree: 'worktrees/citizen/task-1',
+        attempt: 2,
+        status: 'SUCCESS',
+        pr_url: 'https://github.com/org/repo/pull/1',
+        summary: 'Feature complete',
+        artifacts: [],
+        acceptance_met: [true],
+        elapsed_seconds: 120,
+    };
+    let fetchSpy;
+    beforeEach(() => {
+        fetchSpy = vi.spyOn(globalThis, 'fetch');
+    });
+    afterEach(() => {
+        fetchSpy.mockRestore();
+    });
+    it('returns false when no webhook is configured', async () => {
+        const result = await broadcastWebhook(tribute, undefined);
+        expect(result).toBe(false);
+        expect(fetchSpy).not.toHaveBeenCalled();
+    });
+    it('returns false when webhook URL is empty', async () => {
+        const result = await broadcastWebhook(tribute, { url: '' });
+        expect(result).toBe(false);
+        expect(fetchSpy).not.toHaveBeenCalled();
+    });
+    it('POSTs tribute data to webhook URL', async () => {
+        fetchSpy.mockResolvedValue(new Response('OK', { status: 200 }));
+        const result = await broadcastWebhook(tribute, { url: 'https://hooks.example.com/citadel' });
+        expect(result).toBe(true);
+        expect(fetchSpy).toHaveBeenCalledOnce();
+        const [url, opts] = fetchSpy.mock.calls[0];
+        expect(url).toBe('https://hooks.example.com/citadel');
+        expect(opts.method).toBe('POST');
+        expect(opts.headers).toEqual({ 'Content-Type': 'application/json' });
+        const body = JSON.parse(opts.body);
+        expect(body.event).toBe('task.success');
+        expect(body.task_id).toBe('task-1');
+        expect(body.outpost).toBe('alpha');
+        expect(body.summary).toBe('Feature complete');
+        expect(body.pr_url).toBe('https://github.com/org/repo/pull/1');
+        expect(body.attempt).toBe(2);
+        expect(body.citizen_id).toBe('citizen-1');
+        expect(body.elapsed_seconds).toBe(120);
+    });
+    it('returns false on HTTP error status', async () => {
+        fetchSpy.mockResolvedValue(new Response('Server Error', { status: 500, statusText: 'Internal Server Error' }));
+        const result = await broadcastWebhook(tribute, { url: 'https://hooks.example.com/citadel' });
+        expect(result).toBe(false);
+    });
+    it('returns false on network error', async () => {
+        fetchSpy.mockRejectedValue(new Error('Connection refused'));
+        const result = await broadcastWebhook(tribute, { url: 'https://hooks.example.com/citadel' });
+        expect(result).toBe(false);
+    });
+});
+//# sourceMappingURL=fo-webhook.test.js.map

package/dist/__tests__/fo-webhook.test.js.map

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

package/dist/__tests__/integration.test.d.ts

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

package/dist/__tests__/integration.test.d.ts.map

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