@citadel-labs/citadel 0.1.0

package/dist/__tests__/cli-e2e/reset-stop-tribute-trace.test.js

@@ -0,0 +1,158 @@
+import { describe, it, expect, afterEach } from 'vitest';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { runCli, seedWorkspace, cleanupWorkspace } from './helpers.js';
+import { appendBead, mintBeadId } from '../../core/append-bead.js';
+import { SCHEMA_VERSION } from '../../types/index.js';
+describe('CLI e2e: reset, stop, tribute, trace', () => {
+    const dirs = [];
+    afterEach(async () => {
+        for (const d of dirs) {
+            await cleanupWorkspace(d);
+        }
+        dirs.length = 0;
+    });
+    it('citadel start writes identity bead and session.log', async () => {
+        const { workspace, outpostPath } = await seedWorkspace();
+        dirs.push(workspace, outpostPath);
+        const result = await runCli(['start'], workspace);
+        expect(result.exitCode).toBe(0);
+        expect(result.stdout).toContain('Citadel started');
+        // Verify identity.jsonl has content
+        const identity = await fs.readFile(path.join(workspace, '.citadel', 'identity.jsonl'), 'utf-8');
+        expect(identity.trim().length).toBeGreaterThan(0);
+        // Verify session.log
+        const log = await fs.readFile(path.join(workspace, '.citadel', 'logs', 'session.log'), 'utf-8');
+        expect(log).toContain('Session started');
+    });
+    it('citadel stop writes session.log and clears nudges', async () => {
+        const { workspace, outpostPath } = await seedWorkspace();
+        dirs.push(workspace, outpostPath);
+        // Start first to create identity
+        await runCli(['start'], workspace);
+        // Write an unprocessed nudge
+        const nudge = {
+            bead_id: mintBeadId('NUDGE'),
+            bead_type: 'NUDGE',
+            schema_version: SCHEMA_VERSION,
+            created_at: new Date().toISOString(),
+            signal_type: 'COMMAND_RECEIVED',
+            payload: { command_bead_id: 'cmd_test', command: 'dispatch' },
+            processed: false,
+        };
+        const nudgesPath = path.join(workspace, '.citadel', 'nudges.jsonl');
+        await fs.appendFile(nudgesPath, JSON.stringify(nudge) + '\n', 'utf-8');
+        const result = await runCli(['stop'], workspace);
+        expect(result.exitCode).toBe(0);
+        expect(result.stdout).toContain('Citadel stopped');
+        // Verify session.log has stop entry
+        const log = await fs.readFile(path.join(workspace, '.citadel', 'logs', 'session.log'), 'utf-8');
+        expect(log).toContain('Session stopped');
+    });
+    it('citadel reset clears unprocessed nudges and commands', async () => {
+        const { workspace, outpostPath } = await seedWorkspace();
+        dirs.push(workspace, outpostPath);
+        // Write some unprocessed nudges
+        const nudgesPath = path.join(workspace, '.citadel', 'nudges.jsonl');
+        for (let i = 0; i < 3; i++) {
+            await fs.appendFile(nudgesPath, JSON.stringify({
+                bead_id: mintBeadId('NUDGE'),
+                bead_type: 'NUDGE',
+                schema_version: SCHEMA_VERSION,
+                created_at: new Date().toISOString(),
+                signal_type: 'COMMAND_RECEIVED',
+                payload: { command_bead_id: `cmd_${i}`, command: 'dispatch' },
+                processed: false,
+            }) + '\n', 'utf-8');
+        }
+        const result = await runCli(['reset'], workspace);
+        expect(result.exitCode).toBe(0);
+        expect(result.stdout).toContain('reset');
+    });
+    it('citadel reset --hard removes .citadel/', async () => {
+        const { workspace, outpostPath } = await seedWorkspace();
+        dirs.push(workspace, outpostPath);
+        const result = await runCli(['reset', '--hard'], workspace);
+        expect(result.exitCode).toBe(0);
+        expect(result.stdout).toContain('hard reset');
+        // .citadel/ should be gone
+        try {
+            await fs.access(path.join(workspace, '.citadel'));
+            expect.fail('.citadel/ should not exist after hard reset');
+        }
+        catch {
+            // expected
+        }
+    });
+    it('citadel tribute shows tributes for a task', async () => {
+        const { workspace, outpostPath } = await seedWorkspace();
+        dirs.push(workspace, outpostPath);
+        // Write a tribute
+        const tribute = {
+            bead_id: mintBeadId('TRIBUTE'),
+            bead_type: 'TRIBUTE',
+            schema_version: SCHEMA_VERSION,
+            created_at: new Date().toISOString(),
+            citizen_id: 'citizen-test',
+            task_id: 'task-e2e',
+            originating_mail_ref: 'mail_ref',
+            archetype: 'software-engineer',
+            outpost: 'test-outpost',
+            worktree: '/tmp/wt',
+            attempt: 1,
+            status: 'SUCCESS',
+            summary: 'Feature implemented',
+            artifacts: ['src/feature.ts'],
+            acceptance_met: [true],
+            elapsed_seconds: 120,
+        };
+        await appendBead(path.join(outpostPath, '.beads', 'tribute', 'task-e2e_tribute.jsonl'), tribute);
+        const result = await runCli(['tribute', '--task', 'task-e2e'], workspace);
+        expect(result.exitCode).toBe(0);
+        expect(result.stdout).toContain('SUCCESS');
+        expect(result.stdout).toContain('Feature implemented');
+        expect(result.stdout).toContain('Attempt 1');
+    });
+    it('citadel tribute shows no results for unknown task', async () => {
+        const { workspace, outpostPath } = await seedWorkspace();
+        dirs.push(workspace, outpostPath);
+        const result = await runCli(['tribute', '--task', 'nonexistent'], workspace);
+        expect(result.exitCode).toBe(0);
+        expect(result.stdout).toContain('No tributes found');
+    });
+    it('citadel trace shows event timeline', async () => {
+        const { workspace, outpostPath } = await seedWorkspace();
+        dirs.push(workspace, outpostPath);
+        // Write a TASK_ASSIGNMENT mail
+        const mail = {
+            bead_id: mintBeadId('MAIL'),
+            bead_type: 'MAIL',
+            schema_version: SCHEMA_VERSION,
+            created_at: new Date().toISOString(),
+            task_id: 'task-trace',
+            mail_type: 'TASK_ASSIGNMENT',
+            from: 'citadel',
+            to: 'test-outpost',
+            subject: 'Test trace',
+            read: false,
+            retry_of: null,
+            payload: {
+                archetype: 'software-engineer',
+                citizen_id: 'citizen-1',
+                priority: 'MEDIUM',
+                title: 'Test',
+                description: 'Test',
+                acceptance_criteria: [],
+                context_refs: [],
+                dependencies: [],
+                timeout_seconds: 1800,
+            },
+        };
+        await appendBead(path.join(outpostPath, '.beads', 'mail', 'task-trace.jsonl'), mail);
+        const result = await runCli(['trace', '--task', 'task-trace'], workspace);
+        expect(result.exitCode).toBe(0);
+        expect(result.stdout).toContain('MAIL');
+        expect(result.stdout).toContain('TASK_ASSIGNMENT');
+    });
+});
+//# sourceMappingURL=reset-stop-tribute-trace.test.js.map

package/dist/__tests__/cli-e2e/reset-stop-tribute-trace.test.js.map

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

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

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

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

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

package/dist/__tests__/courier.test.js

@@ -0,0 +1,97 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import os from 'node:os';
+import { Courier } from '../core/courier.js';
+describe('Courier', () => {
+    let tmpDir;
+    beforeEach(async () => {
+        tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'courier-'));
+        await fs.mkdir(path.join(tmpDir, '.citadel', 'commands'), { recursive: true });
+        await fs.writeFile(path.join(tmpDir, '.citadel', 'nudges.jsonl'), '', 'utf-8');
+        await fs.writeFile(path.join(tmpDir, '.citadel', 'outposts.json'), JSON.stringify({ schema_version: '1.0', outposts: [] }), 'utf-8');
+    });
+    afterEach(async () => {
+        await fs.rm(tmpDir, { recursive: true, force: true });
+    });
+    it('resolveConfig returns defaults when no config file exists', async () => {
+        const courier = new Courier({ citadelRoot: tmpDir });
+        const config = await courier.resolveConfig();
+        expect(config.poll_interval_ms).toBe(500);
+        expect(config.debounce_ms).toBe(200);
+        expect(config.default_max_citizens).toBe(3);
+        expect(config.citizen_timeout_seconds).toBe(1800);
+        expect(config.log_level).toBe('INFO');
+    });
+    it('resolveConfig reads courier.config.yaml when present', async () => {
+        const { stringify } = await import('yaml');
+        await fs.writeFile(path.join(tmpDir, 'courier.config.yaml'), stringify({
+            citadel_root: '.',
+            poll_interval_ms: 1000,
+            debounce_ms: 300,
+            default_max_citizens: 5,
+            citizen_timeout_seconds: 900,
+            log_level: 'DEBUG',
+            log_path: '.citadel/logs/courier.log',
+        }), 'utf-8');
+        const courier = new Courier({ citadelRoot: tmpDir });
+        const config = await courier.resolveConfig();
+        expect(config.poll_interval_ms).toBe(1000);
+        expect(config.default_max_citizens).toBe(5);
+        expect(config.citizen_timeout_seconds).toBe(900);
+    });
+    it('resolveConfig reads explicit config path', async () => {
+        const { stringify } = await import('yaml');
+        const customPath = path.join(tmpDir, 'custom.yaml');
+        await fs.writeFile(customPath, stringify({
+            citadel_root: '.',
+            poll_interval_ms: 2000,
+            debounce_ms: 100,
+            default_max_citizens: 1,
+            citizen_timeout_seconds: 600,
+            log_level: 'WARN',
+            log_path: '.citadel/logs/courier.log',
+        }), 'utf-8');
+        const courier = new Courier({ citadelRoot: tmpDir, configPath: customPath });
+        const config = await courier.resolveConfig();
+        expect(config.poll_interval_ms).toBe(2000);
+        expect(config.default_max_citizens).toBe(1);
+    });
+    it('getConfig returns the resolved config', async () => {
+        const courier = new Courier({ citadelRoot: tmpDir });
+        await courier.resolveConfig();
+        const config = courier.getConfig();
+        expect(config).toBeDefined();
+        expect(config.poll_interval_ms).toBe(500);
+    });
+    it('start and stop lifecycle works', async () => {
+        const courier = new Courier({ citadelRoot: tmpDir });
+        await courier.start();
+        await courier.stop();
+    });
+    it('classifyEvent correctly identifies command files', async () => {
+        const courier = new Courier({ citadelRoot: tmpDir });
+        await courier.resolveConfig();
+        // Access private method via casting
+        const classify = courier.classifyEvent.bind(courier);
+        const commandPath = path.resolve(tmpDir, '.citadel', 'commands', 'cmd_test.jsonl');
+        const result = classify(commandPath);
+        expect(result).toEqual({ type: 'command', filePath: commandPath });
+    });
+    it('classifyEvent correctly identifies nudges file', async () => {
+        const courier = new Courier({ citadelRoot: tmpDir });
+        await courier.resolveConfig();
+        const classify = courier.classifyEvent.bind(courier);
+        const nudgePath = path.resolve(tmpDir, '.citadel', 'nudges.jsonl');
+        const result = classify(nudgePath);
+        expect(result).toEqual({ type: 'nudge', filePath: nudgePath });
+    });
+    it('classifyEvent returns null for unrelated files', async () => {
+        const courier = new Courier({ citadelRoot: tmpDir });
+        await courier.resolveConfig();
+        const classify = courier.classifyEvent.bind(courier);
+        const result = classify(path.resolve(tmpDir, 'random.txt'));
+        expect(result).toBeNull();
+    });
+});
+//# sourceMappingURL=courier.test.js.map

package/dist/__tests__/courier.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"courier.test.js","sourceRoot":"","sources":["../../src/__tests__/courier.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;IACvB,IAAI,MAAc,CAAC;IAEnB,UAAU,CAAC,KAAK,IAAI,EAAE;QACpB,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC;QAC9D,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/E,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,cAAc,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;QAC/E,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,eAAe,CAAC,EAC9C,IAAI,CAAC,SAAS,CAAC,EAAE,cAAc,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,EACvD,OAAO,CACR,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,MAAM,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;QAE7C,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,qBAAqB,CAAC,EACxC,SAAS,CAAC;YACR,YAAY,EAAE,GAAG;YACjB,gBAAgB,EAAE,IAAI;YACtB,WAAW,EAAE,GAAG;YAChB,oBAAoB,EAAE,CAAC;YACvB,uBAAuB,EAAE,GAAG;YAC5B,SAAS,EAAE,OAAO;YAClB,QAAQ,EAAE,2BAA2B;SACtC,CAAC,EACF,OAAO,CACR,CAAC;QAEF,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;QAE7C,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;QACpD,MAAM,EAAE,CAAC,SAAS,CAChB,UAAU,EACV,SAAS,CAAC;YACR,YAAY,EAAE,GAAG;YACjB,gBAAgB,EAAE,IAAI;YACtB,WAAW,EAAE,GAAG;YAChB,oBAAoB,EAAE,CAAC;YACvB,uBAAuB,EAAE,GAAG;YAC5B,SAAS,EAAE,MAAM;YACjB,QAAQ,EAAE,2BAA2B;SACtC,CAAC,EACF,OAAO,CACR,CAAC;QAEF,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;QAC7E,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;QAE7C,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;QACrD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;QACrD,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;QAC9C,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;QACrD,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACtB,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;QACrD,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;QAE9B,oCAAoC;QACpC,MAAM,QAAQ,GAAI,OAAgE,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/G,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC;QACnF,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;QACrD,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;QAE9B,MAAM,QAAQ,GAAI,OAAgE,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/G,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;QACrD,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;QAE9B,MAAM,QAAQ,GAAI,OAAgE,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/G,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;QAC5D,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/e2e-smoke.test.d.ts

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

package/dist/__tests__/e2e-smoke.test.d.ts.map

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

package/dist/__tests__/e2e-smoke.test.js

@@ -0,0 +1,137 @@
+import { describe, it, expect, afterEach } from 'vitest';
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { execFile as execFileCb } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFile = promisify(execFileCb);
+/**
+ * E2E smoke test: simulates the critical user path
+ *   npm install -> citadel init -> citadel start
+ *
+ * Since we can't actually run the CLI binary in tests easily,
+ * we test the same code paths programmatically.
+ */
+describe('E2E smoke test (citadel-d60)', () => {
+    let tmpDir;
+    afterEach(async () => {
+        if (tmpDir)
+            await fs.rm(tmpDir, { recursive: true, force: true });
+    });
+    it('init -> register outpost -> start -> status flow works end-to-end', async () => {
+        tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'citadel-e2e-'));
+        // Initialize git in tmpDir so appendBead git commits work
+        await execFile('git', ['init'], { cwd: tmpDir });
+        await execFile('git', ['config', 'user.email', 'test@citadel.dev'], { cwd: tmpDir });
+        await execFile('git', ['config', 'user.name', 'Citadel E2E'], { cwd: tmpDir });
+        await fs.writeFile(path.join(tmpDir, '.gitkeep'), '');
+        await execFile('git', ['add', '.'], { cwd: tmpDir });
+        await execFile('git', ['commit', '-m', 'init'], { cwd: tmpDir });
+        // 1. Init: create .citadel/ structure
+        const citadelDir = path.join(tmpDir, '.citadel');
+        await fs.mkdir(path.join(citadelDir, 'commands'), { recursive: true });
+        await fs.mkdir(path.join(citadelDir, 'logs'), { recursive: true });
+        await fs.writeFile(path.join(citadelDir, 'identity.jsonl'), '');
+        await fs.writeFile(path.join(citadelDir, 'nudges.jsonl'), '');
+        await fs.writeFile(path.join(citadelDir, 'outposts.json'), JSON.stringify({ schema_version: '1.0', outposts: [] }));
+        // Create grand-archives
+        const gaDir = path.join(tmpDir, 'grand-archives');
+        await fs.mkdir(path.join(gaDir, 'archetypes', 'software-engineer'), { recursive: true });
+        await fs.mkdir(path.join(gaDir, 'first-officer'), { recursive: true });
+        await fs.mkdir(path.join(gaDir, 'shared'), { recursive: true });
+        await fs.writeFile(path.join(gaDir, 'registry.json'), JSON.stringify({ schema_version: '1.0', archetypes: [{ key: 'software-engineer', description: 'SE', status: 'active' }] }));
+        await fs.writeFile(path.join(gaDir, 'first-officer', 'config.json'), JSON.stringify({
+            schema_version: '1.0', display_name: 'FO', singleton: true, assignable: false,
+            agent: 'claude-code', system_prompt_ref: 'first-officer/system-prompt.md',
+            toolset_ref: 'first-officer/toolset.json', model: 'claude-opus-4',
+            constraints: { temperature: 0.2, max_tokens_per_turn: 8192 },
+            retry_policy: { max_retries: 3, retry_on: ['PARTIAL'], partial_strategy: 'remaining_criteria_only', on_ceiling_reached: 'ESCALATE_TO_COMMANDER' },
+            nudge_retention: 500,
+        }));
+        await fs.writeFile(path.join(gaDir, 'shared', 'base-prompt-preamble.md'), '# Preamble\n');
+        await fs.writeFile(path.join(gaDir, 'archetypes', 'software-engineer', 'system-prompt.md'), '# SE Prompt\n');
+        await fs.writeFile(path.join(gaDir, 'archetypes', 'software-engineer', 'archetype.json'), JSON.stringify({
+            key: 'software-engineer', schema_version: '1.0', display_name: 'SE',
+            system_prompt: { preamble_ref: 'shared/base-prompt-preamble.md', body_ref: 'archetypes/software-engineer/system-prompt.md' },
+            toolset: { base_ref: 'shared/base-tools.json', override_ref: 'archetypes/software-engineer/toolset.json' },
+            constraints: { max_tokens_per_turn: 8192, temperature: 0.2, model: 'claude-opus-4' },
+        }));
+        await fs.writeFile(path.join(gaDir, 'archetypes', 'software-engineer', 'toolset.json'), JSON.stringify({ schema_version: '1.0', description: 'SE tools', tools: [] }));
+        // Commit the init
+        await execFile('git', ['add', '.'], { cwd: tmpDir });
+        await execFile('git', ['commit', '-m', 'citadel init'], { cwd: tmpDir });
+        // Verify .citadel/ exists
+        const stat = await fs.stat(citadelDir);
+        expect(stat.isDirectory()).toBe(true);
+        // 2. Register an outpost
+        const outpostPath = path.join(tmpDir, 'my-outpost');
+        await fs.mkdir(outpostPath, { recursive: true });
+        await execFile('git', ['init'], { cwd: outpostPath });
+        await execFile('git', ['config', 'user.email', 'test@citadel.dev'], { cwd: outpostPath });
+        await execFile('git', ['config', 'user.name', 'E2E'], { cwd: outpostPath });
+        await fs.writeFile(path.join(outpostPath, '.gitkeep'), '');
+        await execFile('git', ['add', '.'], { cwd: outpostPath });
+        await execFile('git', ['commit', '-m', 'init'], { cwd: outpostPath });
+        // Simulate outpost register
+        await fs.mkdir(path.join(outpostPath, '.beads', 'mail'), { recursive: true });
+        await fs.mkdir(path.join(outpostPath, '.beads', 'tribute'), { recursive: true });
+        await fs.mkdir(path.join(outpostPath, 'worktrees', 'citizen'), { recursive: true });
+        await fs.writeFile(path.join(outpostPath, '.beads', 'mail', '.gitignore'), '*.jsonl.lock\n');
+        await fs.writeFile(path.join(outpostPath, '.beads', 'tribute', '.gitignore'), '*.jsonl.lock\n');
+        const registry = {
+            schema_version: '1.0',
+            outposts: [{
+                    slug: 'my-outpost', path: outpostPath, status: 'ACTIVE',
+                    registered_at: new Date().toISOString(), default_archetype: 'software-engineer', max_citizens: 3,
+                }],
+        };
+        await fs.writeFile(path.join(citadelDir, 'outposts.json'), JSON.stringify(registry));
+        await execFile('git', ['add', '.'], { cwd: outpostPath });
+        await execFile('git', ['commit', '-m', 'register outpost'], { cwd: outpostPath });
+        // 3. Start: write identity bead, rotate nudges
+        const { appendBead, mintBeadId, readBeads } = await import('../core/append-bead.js');
+        const { SCHEMA_VERSION } = await import('../types/index.js');
+        await execFile('git', ['add', '.'], { cwd: tmpDir });
+        await execFile('git', ['commit', '-m', 'pre-start'], { cwd: tmpDir });
+        const identityBead = {
+            bead_id: mintBeadId('IDENTITY'),
+            bead_type: 'IDENTITY',
+            schema_version: SCHEMA_VERSION,
+            created_at: new Date().toISOString(),
+            role: 'first-officer',
+            display_name: 'First Officer',
+            agent: 'claude-code',
+            citadel_root: tmpDir,
+            last_session_at: new Date().toISOString(),
+        };
+        await appendBead(path.join(citadelDir, 'identity.jsonl'), identityBead);
+        // Verify identity bead
+        const identityBeads = await readBeads(path.join(citadelDir, 'identity.jsonl'));
+        expect(identityBeads.length).toBeGreaterThanOrEqual(1);
+        expect(identityBeads[0].bead_id).toMatch(/^identity_/);
+        // 4. Dispatch a task
+        const { dispatch } = await import('../core/fo-dispatch.js');
+        const { ProcessRegistry } = await import('../core/process-registry.js');
+        const processRegistry = new ProcessRegistry();
+        const mail = await dispatch({
+            citadelRoot: tmpDir,
+            outpostSlug: 'my-outpost',
+            task: { title: 'E2E Test Feature', description: 'Build it', acceptanceCriteria: ['It works'] },
+            processRegistry,
+        });
+        expect(mail.bead_id).toMatch(/^mail_/);
+        expect(mail.mail_type).toBe('TASK_ASSIGNMENT');
+        expect(mail.spawn_hint).toBeDefined();
+        expect(mail.spawn_hint.citizen_id).toMatch(/^citizen-/);
+        // 5. Verify .gitignore exists
+        const gitignoreContent = await fs.readFile(path.join(outpostPath, '.beads', 'mail', '.gitignore'), 'utf-8');
+        expect(gitignoreContent).toContain('*.jsonl.lock');
+        // 6. Verify the full composed prompt
+        const { GrandArchives } = await import('../core/grand-archives.js');
+        const archives = new GrandArchives(tmpDir);
+        const composed = await archives.resolveComposedPrompt('software-engineer');
+        expect(composed).toContain('Preamble');
+        expect(composed).toContain('SE Prompt');
+    });
+});
+//# sourceMappingURL=e2e-smoke.test.js.map

package/dist/__tests__/e2e-smoke.test.js.map

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

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

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

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

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

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

@@ -0,0 +1,134 @@
+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 { broadcastDependencyResolved } from '../core/fo-broadcast.js';
+import { readBeads } from '../core/append-bead.js';
+describe('broadcastDependencyResolved', () => {
+    let tmpDir;
+    let alphaPath;
+    let betaPath;
+    beforeEach(async () => {
+        tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'citadel-broadcast-'));
+        alphaPath = path.join(tmpDir, 'outposts', 'alpha');
+        betaPath = path.join(tmpDir, 'outposts', 'beta');
+        await fs.mkdir(path.join(tmpDir, '.citadel'), { recursive: true });
+        await fs.mkdir(path.join(alphaPath, '.beads', 'mail'), { recursive: true });
+        await fs.mkdir(path.join(alphaPath, '.beads', 'tribute'), { recursive: true });
+        await fs.mkdir(path.join(betaPath, '.beads', 'mail'), { recursive: true });
+        await fs.mkdir(path.join(betaPath, '.beads', 'tribute'), { recursive: true });
+        const registry = {
+            schema_version: '1.0',
+            outposts: [
+                { slug: 'alpha', path: alphaPath, status: 'ACTIVE', registered_at: '2026-01-01T00:00:00Z' },
+                { slug: 'beta', path: betaPath, status: 'ACTIVE', registered_at: '2026-01-02T00:00:00Z' },
+            ],
+        };
+        await fs.writeFile(path.join(tmpDir, '.citadel', 'outposts.json'), JSON.stringify(registry));
+    });
+    afterEach(async () => {
+        await fs.rm(tmpDir, { recursive: true, force: true });
+    });
+    const makeAssignmentMail = (taskId, to, deps) => ({
+        bead_id: `bead-${taskId}`,
+        bead_type: 'MAIL',
+        schema_version: '9.0',
+        created_at: '2026-01-01T00:00:00Z',
+        task_id: taskId,
+        mail_type: 'TASK_ASSIGNMENT',
+        from: 'citadel',
+        to,
+        subject: `Task ${taskId}`,
+        read: false,
+        retry_of: null,
+        payload: {
+            archetype: 'software-engineer',
+            citizen_id: `citizen-${taskId}`,
+            priority: 'MEDIUM',
+            title: `Task ${taskId}`,
+            description: 'test',
+            acceptance_criteria: [],
+            context_refs: [],
+            dependencies: deps,
+            timeout_seconds: 1800,
+        },
+    });
+    const successTribute = {
+        bead_id: 'tribute-task-X',
+        bead_type: 'TRIBUTE',
+        schema_version: '9.0',
+        created_at: '2026-01-01T01:00:00Z',
+        citizen_id: 'citizen-X',
+        task_id: 'task-X',
+        originating_mail_ref: 'bead-task-X',
+        archetype: 'software-engineer',
+        outpost: 'alpha',
+        worktree: 'worktrees/citizen/task-X',
+        attempt: 1,
+        status: 'SUCCESS',
+        pr_url: 'https://github.com/org/repo/pull/42',
+        summary: 'Implemented feature X',
+        artifacts: ['src/feature-x.ts'],
+        acceptance_met: [true],
+        elapsed_seconds: 300,
+    };
+    it('sends DEPENDENCY_RESOLVED to all blocked tasks', async () => {
+        // alpha task-A depends on task-X
+        const mailA = makeAssignmentMail('task-A', 'alpha', ['task-X']);
+        await fs.writeFile(path.join(alphaPath, '.beads', 'mail', 'task-A.jsonl'), JSON.stringify(mailA) + '\n');
+        // beta task-B depends on task-X
+        const mailB = makeAssignmentMail('task-B', 'beta', ['task-X']);
+        await fs.writeFile(path.join(betaPath, '.beads', 'mail', 'task-B.jsonl'), JSON.stringify(mailB) + '\n');
+        const result = await broadcastDependencyResolved(tmpDir, successTribute);
+        expect(result.sent).toBe(2);
+        expect(result.recipients.map(r => r.outpost).sort()).toEqual(['alpha', 'beta']);
+        // Verify DEPENDENCY_RESOLVED mail was written to alpha
+        const alphaFiles = await fs.readdir(path.join(alphaPath, '.beads', 'mail'));
+        const depResFiles = alphaFiles.filter(f => f.startsWith('depres-'));
+        expect(depResFiles).toHaveLength(1);
+        const mails = await readBeads(path.join(alphaPath, '.beads', 'mail', depResFiles[0]));
+        expect(mails).toHaveLength(1);
+        expect(mails[0].mail_type).toBe('DEPENDENCY_RESOLVED');
+        expect(mails[0].task_id).toBe('task-A');
+        expect(mails[0].to).toBe('alpha');
+        const payload = mails[0].payload;
+        expect(payload.resolved_task_id).toBe('task-X');
+        expect(payload.resolved_by_outpost).toBe('alpha');
+        expect(payload.tribute_ref).toBe('tribute-task-X');
+        expect(payload.pr_url).toBe('https://github.com/org/repo/pull/42');
+        expect(payload.summary).toBe('Implemented feature X');
+    });
+    it('returns empty result when no tasks are blocked', async () => {
+        // No tasks depend on task-X
+        const result = await broadcastDependencyResolved(tmpDir, successTribute);
+        expect(result.sent).toBe(0);
+        expect(result.recipients).toEqual([]);
+    });
+    it('skips tasks that already succeeded', async () => {
+        // alpha task-A depends on task-X but already succeeded
+        const mailA = makeAssignmentMail('task-A', 'alpha', ['task-X']);
+        await fs.writeFile(path.join(alphaPath, '.beads', 'mail', 'task-A.jsonl'), JSON.stringify(mailA) + '\n');
+        const tribute = {
+            bead_id: 'tribute-task-A',
+            bead_type: 'TRIBUTE',
+            schema_version: '9.0',
+            created_at: '2026-01-01T00:30:00Z',
+            citizen_id: 'citizen-A',
+            task_id: 'task-A',
+            originating_mail_ref: 'bead-task-A',
+            archetype: 'software-engineer',
+            outpost: 'alpha',
+            worktree: 'worktrees/citizen/task-A',
+            attempt: 1,
+            status: 'SUCCESS',
+            summary: 'done',
+            artifacts: [],
+            acceptance_met: [],
+            elapsed_seconds: 60,
+        };
+        await fs.writeFile(path.join(alphaPath, '.beads', 'tribute', 'task-A.jsonl'), JSON.stringify(tribute) + '\n');
+        const result = await broadcastDependencyResolved(tmpDir, successTribute);
+        expect(result.sent).toBe(0);
+    });
+});
+//# sourceMappingURL=fo-broadcast.test.js.map

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

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

package/dist/__tests__/fo-command-processor.test.d.ts

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

package/dist/__tests__/fo-command-processor.test.d.ts.map

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