@xopcai/xopcbot 0.1.0

package/dist/channels/update-offset-store.js

@@ -0,0 +1,165 @@
+/**
+ * Update Offset Store for Telegram Polling
+ *
+ * Persists last processed update ID to avoid duplicate message processing
+ * Inspired by openclaw's update-offset-store.ts
+ */
+import { promises as fs } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { createLogger } from '../utils/logger.js';
+const log = createLogger('UpdateOffsetStore');
+const OFFSET_STORE_DIR = join(homedir(), '.xopcbot', 'state');
+const OFFSET_STORE_FILE = 'telegram-offsets.json';
+/**
+ * Get path to offset store file
+ */
+function getOffsetStorePath() {
+    return join(OFFSET_STORE_DIR, OFFSET_STORE_FILE);
+}
+/**
+ * Ensure offset store directory exists
+ */
+async function ensureStoreDir() {
+    await fs.mkdir(OFFSET_STORE_DIR, { recursive: true });
+}
+/**
+ * Load offset store from disk
+ */
+async function loadOffsetStore() {
+    try {
+        const filePath = getOffsetStorePath();
+        const content = await fs.readFile(filePath, 'utf-8');
+        const data = JSON.parse(content);
+        return {
+            offsets: data.offsets ?? {},
+            lastUpdated: data.lastUpdated ?? Date.now(),
+        };
+    }
+    catch {
+        // File doesn't exist or is corrupted, return empty store
+        return {
+            offsets: {},
+            lastUpdated: Date.now(),
+        };
+    }
+}
+/**
+ * Save offset store to disk
+ */
+async function saveOffsetStore(data) {
+    try {
+        await ensureStoreDir();
+        const filePath = getOffsetStorePath();
+        const content = JSON.stringify({
+            ...data,
+            lastUpdated: Date.now(),
+        }, null, 2);
+        await fs.writeFile(filePath, content, 'utf-8');
+    }
+    catch (err) {
+        log.error({ err }, 'Failed to save offset store');
+    }
+}
+/**
+ * Read update offset for an account
+ */
+export async function readUpdateOffset(accountId) {
+    try {
+        const store = await loadOffsetStore();
+        const offset = store.offsets[accountId];
+        return typeof offset === 'number' ? offset : null;
+    }
+    catch (err) {
+        log.error({ err, accountId }, 'Failed to read update offset');
+        return null;
+    }
+}
+/**
+ * Write update offset for an account
+ */
+export async function writeUpdateOffset(accountId, offset) {
+    try {
+        const store = await loadOffsetStore();
+        // Only update if offset is greater than current
+        const currentOffset = store.offsets[accountId] ?? 0;
+        if (offset <= currentOffset) {
+            return;
+        }
+        store.offsets[accountId] = offset;
+        await saveOffsetStore(store);
+        log.debug({ accountId, offset }, 'Update offset persisted');
+    }
+    catch (err) {
+        log.error({ err, accountId, offset }, 'Failed to write update offset');
+    }
+}
+/**
+ * Clear update offset for an account
+ */
+export async function clearUpdateOffset(accountId) {
+    try {
+        const store = await loadOffsetStore();
+        delete store.offsets[accountId];
+        await saveOffsetStore(store);
+        log.debug({ accountId }, 'Update offset cleared');
+    }
+    catch (err) {
+        log.error({ err, accountId }, 'Failed to clear update offset');
+    }
+}
+/**
+ * Get all account offsets
+ */
+export async function getAllOffsets() {
+    const store = await loadOffsetStore();
+    return { ...store.offsets };
+}
+/**
+ * In-memory cache for offset store (reduces disk I/O)
+ */
+class OffsetStoreCache {
+    cache = new Map();
+    lastSync = 0;
+    syncInterval = 5000; // 5 seconds
+    async get(accountId) {
+        // Check cache first
+        if (this.cache.has(accountId)) {
+            return this.cache.get(accountId);
+        }
+        // Sync from disk if cache miss
+        await this.syncFromDisk();
+        return this.cache.get(accountId) ?? null;
+    }
+    async set(accountId, offset) {
+        const current = this.cache.get(accountId) ?? 0;
+        if (offset <= current) {
+            return;
+        }
+        this.cache.set(accountId, offset);
+        // Debounced write to disk
+        const now = Date.now();
+        if (now - this.lastSync > this.syncInterval) {
+            await this.syncToDisk();
+        }
+    }
+    async syncFromDisk() {
+        const store = await loadOffsetStore();
+        this.cache = new Map(Object.entries(store.offsets));
+        this.lastSync = Date.now();
+    }
+    async syncToDisk() {
+        const offsets = Object.fromEntries(this.cache);
+        await saveOffsetStore({
+            offsets,
+            lastUpdated: Date.now(),
+        });
+        this.lastSync = Date.now();
+    }
+    async flush() {
+        await this.syncToDisk();
+    }
+}
+// Export singleton instance for use across the application
+export const offsetStoreCache = new OffsetStoreCache();
+//# sourceMappingURL=update-offset-store.js.map

package/dist/channels/update-offset-store.js.map

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

package/dist/channels/whatsapp/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * WhatsApp Channel Module
+ */
+export { whatsappPlugin } from './plugin.js';

package/dist/channels/whatsapp/index.js

@@ -0,0 +1,5 @@
+/**
+ * WhatsApp Channel Module
+ */
+export { whatsappPlugin } from './plugin.js';
+//# sourceMappingURL=index.js.map

package/dist/channels/whatsapp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/channels/whatsapp/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/channels/whatsapp/plugin.d.ts

@@ -0,0 +1,27 @@
+/**
+ * WhatsApp Channel Plugin
+ *
+ * 插件模式实现（未来）
+ *
+ * TODO: 实现完整的 WhatsApp 插件支持
+ * - 多账户支持
+ * - 群组管理
+ * - 媒体处理
+ * - 消息加密
+ */
+import type { ChannelPlugin, ChannelInitOptions, ChannelStartOptions, ChannelSendOptions, ChannelSendStreamOptions, ChannelSendResult, ChannelStatus, ChannelMetadata } from '../types.js';
+export declare class WhatsAppChannelPlugin implements ChannelPlugin {
+    id: "whatsapp";
+    meta: ChannelMetadata;
+    init(options: ChannelInitOptions): Promise<void>;
+    start(_options?: ChannelStartOptions): Promise<void>;
+    stop(_accountId?: string): Promise<void>;
+    send(_options: ChannelSendOptions): Promise<ChannelSendResult>;
+    startStream(_options: ChannelSendStreamOptions): ReturnType<ChannelPlugin['startStream']>;
+    getStatus(_accountId?: string): ChannelStatus;
+    testConnection(): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+}
+export declare const whatsappPlugin: WhatsAppChannelPlugin;

package/dist/channels/whatsapp/plugin.js

@@ -0,0 +1,66 @@
+/**
+ * WhatsApp Channel Plugin
+ *
+ * 插件模式实现（未来）
+ *
+ * TODO: 实现完整的 WhatsApp 插件支持
+ * - 多账户支持
+ * - 群组管理
+ * - 媒体处理
+ * - 消息加密
+ */
+import { createLogger } from '../../utils/logger.js';
+const log = createLogger('WhatsAppPlugin');
+export class WhatsAppChannelPlugin {
+    id = 'whatsapp';
+    meta = {
+        id: 'whatsapp',
+        name: 'WhatsApp',
+        description: 'WhatsApp messaging channel',
+        capabilities: {
+            chatTypes: ['direct', 'group'],
+            reactions: true,
+            threads: false,
+            media: true,
+            polls: false,
+            nativeCommands: false,
+            blockStreaming: false,
+        },
+    };
+    async init(options) {
+        const whatsappConfig = options.config.channels?.whatsapp;
+        if (!whatsappConfig?.enabled) {
+            log.info('WhatsApp channel disabled in config');
+            return;
+        }
+        log.warn('WhatsApp plugin not yet implemented');
+        log.info('Install @whiskeysockets/baileys to enable WhatsApp support');
+    }
+    async start(_options) {
+        log.warn('WhatsApp plugin start not implemented');
+    }
+    async stop(_accountId) {
+        log.warn('WhatsApp plugin stop not implemented');
+    }
+    async send(_options) {
+        log.warn('WhatsApp send not implemented');
+        return { messageId: '', chatId: '', success: false, error: 'WhatsApp not implemented' };
+    }
+    startStream(_options) {
+        log.warn('WhatsApp streaming not implemented');
+        return {
+            update: () => { },
+            end: async () => { },
+            abort: async () => { },
+            messageId: () => undefined,
+        };
+    }
+    getStatus(_accountId) {
+        return { accountId: 'default', running: false, mode: 'stopped' };
+    }
+    async testConnection() {
+        return { success: false, error: 'WhatsApp not implemented' };
+    }
+}
+export const whatsappPlugin = new WhatsAppChannelPlugin();
+//# sourceMappingURL=plugin.js.map

package/dist/channels/whatsapp/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../src/channels/whatsapp/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAYH,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,MAAM,GAAG,GAAG,YAAY,CAAC,gBAAgB,CAAC,CAAC;AAE3C,MAAM,OAAO,qBAAqB;IAChC,EAAE,GAAG,UAAmB,CAAC;IAEzB,IAAI,GAAoB;QACtB,EAAE,EAAE,UAAU;QACd,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,4BAA4B;QACzC,YAAY,EAAE;YACZ,SAAS,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;YAC9B,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,IAAI;YACX,KAAK,EAAE,KAAK;YACZ,cAAc,EAAE,KAAK;YACrB,cAAc,EAAE,KAAK;SACtB;KACF,CAAC;IAEF,KAAK,CAAC,IAAI,CAAC,OAA2B;QACpC,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC;QACzD,IAAI,CAAC,cAAc,EAAE,OAAO,EAAE,CAAC;YAC7B,GAAG,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;YAChD,OAAO;QACT,CAAC;QAED,GAAG,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;QAChD,GAAG,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,QAA8B;QACxC,GAAG,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,UAAmB;QAC5B,GAAG,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAA4B;QACrC,GAAG,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC1C,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,0BAA0B,EAAE,CAAC;IAC1F,CAAC;IAED,WAAW,CAAC,QAAkC;QAC5C,GAAG,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;QAC/C,OAAO;YACL,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC;YAChB,GAAG,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;YACnB,KAAK,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;YACrB,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS;SAC3B,CAAC;IACJ,CAAC;IAED,SAAS,CAAC,UAAmB;QAC3B,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,0BAA0B,EAAE,CAAC;IAC/D,CAAC;CACF;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,qBAAqB,EAAE,CAAC"}

package/dist/cli/__tests__/registry.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli/__tests__/registry.test.js

@@ -0,0 +1,366 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { CommandRegistry, register, formatExamples, createDefaultContext } from '../registry.js';
+import { Command } from 'commander';
+describe('CommandRegistry', () => {
+    let registry;
+    beforeEach(() => {
+        registry = new CommandRegistry();
+    });
+    describe('register', () => {
+        it('should register a command successfully', () => {
+            const factory = (_ctx) => new Command('test');
+            registry.register({
+                id: 'test-cmd',
+                name: 'test',
+                description: 'Test command',
+                factory,
+            });
+            expect(registry.getCommands()).toHaveLength(1);
+            expect(registry.findById('test-cmd')).toBeDefined();
+        });
+        it('should throw on duplicate id', () => {
+            const factory = (_ctx) => new Command('test');
+            registry.register({
+                id: 'test-cmd',
+                name: 'test',
+                description: 'Test command',
+                factory,
+            });
+            expect(() => {
+                registry.register({
+                    id: 'test-cmd',
+                    name: 'test2',
+                    description: 'Another test',
+                    factory,
+                });
+            }).toThrow('Command with id "test-cmd" already registered');
+        });
+        it('should throw on duplicate name', () => {
+            const factory = (_ctx) => new Command('test');
+            registry.register({
+                id: 'test-cmd-1',
+                name: 'test',
+                description: 'Test command',
+                factory,
+            });
+            expect(() => {
+                registry.register({
+                    id: 'test-cmd-2',
+                    name: 'test',
+                    description: 'Another test',
+                    factory,
+                });
+            }).toThrow('Command with name "test" already registered');
+        });
+        it('should allow registering commands with different ids and names', () => {
+            registry.register({
+                id: 'cmd-1',
+                name: 'cmd1',
+                description: 'Command 1',
+                factory: () => new Command('cmd1'),
+            });
+            registry.register({
+                id: 'cmd-2',
+                name: 'cmd2',
+                description: 'Command 2',
+                factory: () => new Command('cmd2'),
+            });
+            expect(registry.getCommands()).toHaveLength(2);
+        });
+    });
+    describe('getCommands', () => {
+        it('should return empty array when no commands registered', () => {
+            expect(registry.getCommands()).toEqual([]);
+        });
+        it('should return all registered commands', () => {
+            registry.register({
+                id: 'cmd-1',
+                name: 'cmd1',
+                description: 'Command 1',
+                factory: () => new Command('cmd1'),
+            });
+            registry.register({
+                id: 'cmd-2',
+                name: 'cmd2',
+                description: 'Command 2',
+                factory: () => new Command('cmd2'),
+            });
+            const commands = registry.getCommands();
+            expect(commands).toHaveLength(2);
+            expect(commands.map(c => c.id)).toContain('cmd-1');
+            expect(commands.map(c => c.id)).toContain('cmd-2');
+        });
+        it('should return readonly array', () => {
+            registry.register({
+                id: 'cmd-1',
+                name: 'cmd1',
+                description: 'Command 1',
+                factory: () => new Command('cmd1'),
+            });
+            const commands = registry.getCommands();
+            // Type check: should be ReadonlyArray
+            expect(Array.isArray(commands)).toBe(true);
+            // At runtime, we can't prevent push in JS, but the type system prevents it
+            // @ts-expect-error Testing readonly at type level
+            expect(() => commands.push({ id: 'test', name: 'test', description: 'test', factory: () => new Command('test') })).not.toThrow();
+        });
+    });
+    describe('getCommandsByCategory', () => {
+        it('should return commands filtered by category', () => {
+            registry.register({
+                id: 'setup-cmd',
+                name: 'setup',
+                description: 'Setup command',
+                factory: () => new Command('setup'),
+                metadata: { category: 'setup' },
+            });
+            registry.register({
+                id: 'runtime-cmd',
+                name: 'runtime',
+                description: 'Runtime command',
+                factory: () => new Command('runtime'),
+                metadata: { category: 'runtime' },
+            });
+            registry.register({
+                id: 'another-setup',
+                name: 'another-setup',
+                description: 'Another setup',
+                factory: () => new Command('another-setup'),
+                metadata: { category: 'setup' },
+            });
+            const setupCommands = registry.getCommandsByCategory('setup');
+            expect(setupCommands).toHaveLength(2);
+            expect(setupCommands.map(c => c.id)).toContain('setup-cmd');
+            expect(setupCommands.map(c => c.id)).toContain('another-setup');
+        });
+        it('should return empty array when no commands in category', () => {
+            registry.register({
+                id: 'cmd',
+                name: 'cmd',
+                description: 'Command',
+                factory: () => new Command('cmd'),
+                metadata: { category: 'runtime' },
+            });
+            const setupCommands = registry.getCommandsByCategory('setup');
+            expect(setupCommands).toHaveLength(0);
+        });
+    });
+    describe('findById', () => {
+        it('should find command by id', () => {
+            registry.register({
+                id: 'test-cmd',
+                name: 'test',
+                description: 'Test command',
+                factory: () => new Command('test'),
+            });
+            const found = registry.findById('test-cmd');
+            expect(found).toBeDefined();
+            expect(found?.name).toBe('test');
+        });
+        it('should return undefined for non-existent id', () => {
+            const found = registry.findById('non-existent');
+            expect(found).toBeUndefined();
+        });
+    });
+    describe('findByName', () => {
+        it('should find command by name', () => {
+            registry.register({
+                id: 'test-cmd',
+                name: 'test',
+                description: 'Test command',
+                factory: () => new Command('test'),
+            });
+            const found = registry.findByName('test');
+            expect(found).toBeDefined();
+            expect(found?.id).toBe('test-cmd');
+        });
+        it('should return undefined for non-existent name', () => {
+            const found = registry.findByName('non-existent');
+            expect(found).toBeUndefined();
+        });
+    });
+    describe('install', () => {
+        it('should install commands to commander program', () => {
+            const program = new Command();
+            const ctx = createDefaultContext();
+            registry.register({
+                id: 'test-cmd',
+                name: 'test',
+                description: 'Test command',
+                factory: () => new Command('test').description('Test'),
+            });
+            registry.install(program, ctx);
+            // Check if command was added
+            const commands = program.commands;
+            expect(commands.some(cmd => cmd.name() === 'test')).toBe(true);
+        });
+        it('should skip hidden commands', () => {
+            const program = new Command();
+            const ctx = createDefaultContext();
+            registry.register({
+                id: 'visible-cmd',
+                name: 'visible',
+                description: 'Visible command',
+                factory: () => new Command('visible'),
+            });
+            registry.register({
+                id: 'hidden-cmd',
+                name: 'hidden',
+                description: 'Hidden command',
+                factory: () => new Command('hidden'),
+                metadata: { hidden: true },
+            });
+            registry.install(program, ctx);
+            const commandNames = program.commands.map(cmd => cmd.name());
+            expect(commandNames).toContain('visible');
+            expect(commandNames).not.toContain('hidden');
+        });
+        it('should pass context to factory', () => {
+            const program = new Command();
+            const ctx = createDefaultContext(['node', 'xopcbot', '--verbose']);
+            const factorySpy = vi.fn(() => new Command('test'));
+            registry.register({
+                id: 'test-cmd',
+                name: 'test',
+                description: 'Test command',
+                factory: factorySpy,
+            });
+            registry.install(program, ctx, () => ctx);
+            expect(factorySpy).toHaveBeenCalledWith(ctx, expect.any(Function));
+            expect(ctx.isVerbose).toBe(true);
+        });
+        it('should sort commands by category', () => {
+            const program = new Command();
+            const ctx = createDefaultContext();
+            const installOrder = [];
+            registry.register({
+                id: 'utility-cmd',
+                name: 'utility',
+                description: 'Utility command',
+                factory: () => {
+                    installOrder.push('utility');
+                    return new Command('utility');
+                },
+                metadata: { category: 'utility' },
+            });
+            registry.register({
+                id: 'setup-cmd',
+                name: 'setup',
+                description: 'Setup command',
+                factory: () => {
+                    installOrder.push('setup');
+                    return new Command('setup');
+                },
+                metadata: { category: 'setup' },
+            });
+            registry.register({
+                id: 'runtime-cmd',
+                name: 'runtime',
+                description: 'Runtime command',
+                factory: () => {
+                    installOrder.push('runtime');
+                    return new Command('runtime');
+                },
+                metadata: { category: 'runtime' },
+            });
+            registry.install(program, ctx);
+            // Should be sorted: setup, runtime, utility
+            expect(installOrder).toEqual(['setup', 'runtime', 'utility']);
+        });
+    });
+    describe('getStats', () => {
+        it('should return correct statistics', () => {
+            registry.register({
+                id: 'setup-cmd',
+                name: 'setup',
+                description: 'Setup command',
+                factory: () => new Command('setup'),
+                metadata: { category: 'setup' },
+            });
+            registry.register({
+                id: 'runtime-cmd',
+                name: 'runtime',
+                description: 'Runtime command',
+                factory: () => new Command('runtime'),
+                metadata: { category: 'runtime' },
+            });
+            registry.register({
+                id: 'no-category',
+                name: 'nocat',
+                description: 'No category',
+                factory: () => new Command('nocat'),
+            });
+            const stats = registry.getStats();
+            expect(stats.total).toBe(3);
+            expect(stats.byCategory).toEqual({
+                setup: 1,
+                runtime: 1,
+                uncategorized: 1,
+            });
+        });
+        it('should return zero stats when empty', () => {
+            const stats = registry.getStats();
+            expect(stats.total).toBe(0);
+            expect(stats.byCategory).toEqual({});
+        });
+    });
+});
+describe('register helper', () => {
+    it('should register to global registry', async () => {
+        // Clear any previous registrations
+        const { registry: globalRegistry } = await import('../registry.js');
+        register({
+            id: 'global-test',
+            name: 'global-test',
+            description: 'Global test',
+            factory: () => new Command('global-test'),
+        });
+        expect(globalRegistry.findById('global-test')).toBeDefined();
+    });
+});
+describe('formatExamples', () => {
+    it('should format single example', () => {
+        const result = formatExamples(['xopcbot test']);
+        expect(result).toContain('Examples:');
+        expect(result).toContain('$ xopcbot test');
+    });
+    it('should format multiple examples', () => {
+        const result = formatExamples([
+            'xopcbot test',
+            'xopcbot test --option',
+        ]);
+        expect(result).toContain('$ xopcbot test');
+        expect(result).toContain('$ xopcbot test --option');
+    });
+    it('should return empty string for empty array', () => {
+        const result = formatExamples([]);
+        expect(result).toBe('');
+    });
+});
+describe('createDefaultContext', () => {
+    it('should create context with defaults', () => {
+        const ctx = createDefaultContext();
+        expect(ctx.configPath).toContain('.xopcbot/config.json');
+        expect(ctx.workspacePath).toContain('.xopcbot/workspace');
+        expect(ctx.isVerbose).toBe(false);
+        expect(ctx.argv).toEqual(process.argv);
+    });
+    it('should detect verbose flag', () => {
+        const ctx = createDefaultContext(['node', 'xopcbot', '--verbose']);
+        expect(ctx.isVerbose).toBe(true);
+    });
+    it('should detect short verbose flag', () => {
+        const ctx = createDefaultContext(['node', 'xopcbot', '-v']);
+        expect(ctx.isVerbose).toBe(true);
+    });
+    it('should use env vars when set', () => {
+        process.env.XOPCBOT_CONFIG = '/custom/config.json';
+        process.env.XOPCBOT_WORKSPACE = '/custom/workspace';
+        const ctx = createDefaultContext();
+        expect(ctx.configPath).toBe('/custom/config.json');
+        expect(ctx.workspacePath).toBe('/custom/workspace');
+        delete process.env.XOPCBOT_CONFIG;
+        delete process.env.XOPCBOT_WORKSPACE;
+    });
+});
+//# sourceMappingURL=registry.test.js.map