bmad-studio 0.1.0 → 0.2.0

package/packages/server/dist/core/file-store.js

@@ -0,0 +1,160 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { watch } from 'chokidar';
+import { buildIndex } from '../parsers/index-builder.js';
+const BATCH_DELAY_MS = 100;
+const SUPPRESSION_TIMEOUT_MS = 5000;
+function categorizeFile(filePath) {
+    if (filePath.includes('/agents/'))
+        return 'agent';
+    if (filePath.includes('/skills/') || filePath.endsWith('SKILL.md'))
+        return 'skill';
+    if (filePath.includes('/workflows/') || filePath.includes('/tasks/'))
+        return 'workflow';
+    if (filePath.endsWith('config.yaml') || filePath.endsWith('manifest.yaml'))
+        return 'config';
+    if (filePath.includes('/ides/') || filePath.includes('/connections/'))
+        return 'connection';
+    return 'other';
+}
+export class FileStore {
+    index;
+    pendingWrites = new Set();
+    batchedEvents = [];
+    batchTimer = null;
+    watcher = null;
+    projectRoot;
+    studioDir;
+    onBatchUpdate;
+    constructor(options) {
+        this.projectRoot = options.projectRoot;
+        this.studioDir = options.studioDir;
+        this.onBatchUpdate = options.onBatchUpdate;
+        this.index = {
+            agents: [],
+            skills: [],
+            workflows: [],
+            teams: [],
+            configs: [],
+            packages: [],
+            ideConfigs: [],
+            manifests: [],
+            errors: [],
+        };
+    }
+    async initialize() {
+        const cacheFile = path.join(this.studioDir, 'cache', 'entities.json');
+        // Try loading from cache
+        if (fs.existsSync(cacheFile)) {
+            try {
+                const cached = JSON.parse(fs.readFileSync(cacheFile, 'utf-8'));
+                this.index = cached;
+            }
+            catch {
+                // Cache corrupt — rebuild
+                this.index = buildIndex(this.projectRoot);
+            }
+        }
+        else {
+            this.index = buildIndex(this.projectRoot);
+        }
+        this.saveCache();
+        this.startWatching();
+    }
+    saveCache() {
+        const cacheDir = path.join(this.studioDir, 'cache');
+        if (!fs.existsSync(cacheDir)) {
+            fs.mkdirSync(cacheDir, { recursive: true });
+        }
+        fs.writeFileSync(path.join(cacheDir, 'entities.json'), JSON.stringify(this.index, null, 2), 'utf-8');
+    }
+    startWatching() {
+        const bmadDir = path.join(this.projectRoot, '_bmad');
+        if (!fs.existsSync(bmadDir))
+            return;
+        this.watcher = watch(bmadDir, {
+            ignored: ['**/node_modules/**', '**/.git/**', '**/.bmad-studio/**', '**/dist/**'],
+            persistent: true,
+            ignoreInitial: true,
+        });
+        const handleChange = (eventType, filePath) => {
+            // Feedback loop suppression
+            if (this.pendingWrites.has(filePath)) {
+                return;
+            }
+            const category = categorizeFile(filePath);
+            this.batchedEvents.push({ type: eventType, path: filePath, category });
+            if (!this.batchTimer) {
+                this.batchTimer = setTimeout(() => {
+                    this.processBatch();
+                }, BATCH_DELAY_MS);
+            }
+        };
+        this.watcher
+            .on('add', (p) => handleChange('created', p))
+            .on('change', (p) => handleChange('modified', p))
+            .on('unlink', (p) => handleChange('deleted', p));
+    }
+    processBatch() {
+        const events = [...this.batchedEvents];
+        this.batchedEvents = [];
+        this.batchTimer = null;
+        // Rebuild index (incremental would be better, but full rebuild is simpler and fast enough for v1)
+        this.index = buildIndex(this.projectRoot);
+        this.saveCache();
+        if (this.onBatchUpdate && events.length > 0) {
+            this.onBatchUpdate(events);
+        }
+    }
+    markPendingWrite(filePath) {
+        this.pendingWrites.add(filePath);
+        setTimeout(() => {
+            this.pendingWrites.delete(filePath);
+        }, SUPPRESSION_TIMEOUT_MS);
+    }
+    clearPendingWrite(filePath) {
+        this.pendingWrites.delete(filePath);
+    }
+    getIndex() {
+        return this.index;
+    }
+    rebuild() {
+        this.index = buildIndex(this.projectRoot);
+        this.saveCache();
+    }
+    async close() {
+        if (this.watcher) {
+            await this.watcher.close();
+            this.watcher = null;
+        }
+        if (this.batchTimer) {
+            clearTimeout(this.batchTimer);
+            this.batchTimer = null;
+        }
+    }
+}
+export async function registerFileStore(app, projectRoot) {
+    const studioDir = path.join(projectRoot, '.bmad-studio');
+    const store = new FileStore({
+        projectRoot,
+        studioDir,
+        onBatchUpdate: (events) => {
+            app.log.info({ eventCount: events.length }, 'File store batch update');
+            if (app.ws) {
+                for (const event of events) {
+                    app.ws.broadcast({
+                        type: `file:${event.type === 'modified' ? 'changed' : event.type}`,
+                        path: event.path,
+                        category: event.category,
+                    });
+                }
+            }
+        },
+    });
+    await store.initialize();
+    app.decorate('fileStore', store);
+    app.addHook('onClose', async () => {
+        await store.close();
+    });
+}
+//# sourceMappingURL=file-store.js.map

package/packages/server/dist/core/file-store.js.map

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

package/packages/server/dist/core/file-store.test.d.ts

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

package/packages/server/dist/core/file-store.test.d.ts.map

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

package/packages/server/dist/core/file-store.test.js

@@ -0,0 +1,75 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { FileStore } from './file-store.js';
+describe('FileStore', () => {
+    let tmpDir;
+    let studioDir;
+    beforeEach(() => {
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'filestore-test-'));
+        studioDir = path.join(tmpDir, '.bmad-studio');
+    });
+    afterEach(async () => {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+    it('initializes with empty index when no _bmad/ exists', async () => {
+        const store = new FileStore({ projectRoot: tmpDir, studioDir });
+        await store.initialize();
+        const index = store.getIndex();
+        expect(index.agents).toHaveLength(0);
+        expect(index.skills).toHaveLength(0);
+        await store.close();
+    });
+    it('builds index from _bmad/ on initialize', async () => {
+        const skillDir = path.join(tmpDir, '_bmad', 'core', 'skills', 'test');
+        fs.mkdirSync(skillDir, { recursive: true });
+        fs.writeFileSync(path.join(skillDir, 'SKILL.md'), '---\nname: test-skill\ndescription: A test\n---\nContent.\n');
+        const store = new FileStore({ projectRoot: tmpDir, studioDir });
+        await store.initialize();
+        const index = store.getIndex();
+        expect(index.skills).toHaveLength(1);
+        expect(index.skills[0].name).toBe('test-skill');
+        await store.close();
+    });
+    it('saves and loads cache', async () => {
+        const skillDir = path.join(tmpDir, '_bmad', 'core', 'skills', 'test');
+        fs.mkdirSync(skillDir, { recursive: true });
+        fs.writeFileSync(path.join(skillDir, 'SKILL.md'), '---\nname: cached-skill\ndescription: Cached\n---\nContent.\n');
+        // First init — builds index, saves cache
+        const store1 = new FileStore({ projectRoot: tmpDir, studioDir });
+        await store1.initialize();
+        await store1.close();
+        // Verify cache file exists
+        const cacheFile = path.join(studioDir, 'cache', 'entities.json');
+        expect(fs.existsSync(cacheFile)).toBe(true);
+        // Second init — loads from cache
+        const store2 = new FileStore({ projectRoot: tmpDir, studioDir });
+        await store2.initialize();
+        expect(store2.getIndex().skills).toHaveLength(1);
+        expect(store2.getIndex().skills[0].name).toBe('cached-skill');
+        await store2.close();
+    });
+    it('tracks pending writes for feedback loop suppression', async () => {
+        const store = new FileStore({ projectRoot: tmpDir, studioDir });
+        await store.initialize();
+        const testPath = '/some/file.yaml';
+        store.markPendingWrite(testPath);
+        // File is marked as pending
+        // (Internal state — we can verify by checking the suppression works)
+        store.clearPendingWrite(testPath);
+        await store.close();
+    });
+    it('handles corrupt cache gracefully', async () => {
+        const cacheDir = path.join(studioDir, 'cache');
+        fs.mkdirSync(cacheDir, { recursive: true });
+        fs.writeFileSync(path.join(cacheDir, 'entities.json'), 'NOT VALID JSON');
+        const store = new FileStore({ projectRoot: tmpDir, studioDir });
+        await store.initialize();
+        // Should rebuild index instead of crashing
+        expect(store.getIndex()).toBeDefined();
+        expect(store.getIndex().agents).toHaveLength(0);
+        await store.close();
+    });
+});
+//# sourceMappingURL=file-store.test.js.map

package/packages/server/dist/core/file-store.test.js.map

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

package/packages/server/dist/core/project-detector.d.ts

@@ -0,0 +1,14 @@
+export type DetectedModule = {
+    name: string;
+    version: string;
+    source: string;
+};
+export type ProjectDetectionResult = {
+    projectRoot: string;
+    bmadVersion: string | null;
+    versionSupported: boolean;
+    modules: DetectedModule[];
+    ideDirectories: string[];
+};
+export declare function detectProject(startDir: string): ProjectDetectionResult | null;
+//# sourceMappingURL=project-detector.d.ts.map

package/packages/server/dist/core/project-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-detector.d.ts","sourceRoot":"","sources":["../../src/core/project-detector.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,gBAAgB,EAAE,OAAO,CAAA;IACzB,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,cAAc,EAAE,MAAM,EAAE,CAAA;CACzB,CAAA;AA+CD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI,CA8B7E"}

package/packages/server/dist/core/project-detector.js

@@ -0,0 +1,67 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import yaml from 'js-yaml';
+const SUPPORTED_VERSIONS = ['6'];
+function readManifest(bmadDir) {
+    const manifestPath = path.join(bmadDir, '_config', 'manifest.yaml');
+    if (!fs.existsSync(manifestPath)) {
+        return { version: null, modules: [], ides: [] };
+    }
+    try {
+        const content = fs.readFileSync(manifestPath, 'utf-8');
+        const manifest = yaml.load(content);
+        const installation = manifest.installation;
+        const version = installation?.version;
+        const rawModules = manifest.modules || [];
+        const modules = rawModules.map((m) => ({
+            name: m.name || '',
+            version: m.version || '',
+            source: m.source || 'unknown',
+        }));
+        const ides = manifest.ides || [];
+        return { version: version ?? null, modules, ides };
+    }
+    catch {
+        return { version: null, modules: [], ides: [] };
+    }
+}
+function hasModuleWithConfig(bmadDir) {
+    if (!fs.existsSync(bmadDir))
+        return false;
+    const entries = fs.readdirSync(bmadDir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.isDirectory() && !entry.name.startsWith('_') && !entry.name.startsWith('.')) {
+            const configPath = path.join(bmadDir, entry.name, 'config.yaml');
+            if (fs.existsSync(configPath))
+                return true;
+        }
+    }
+    return false;
+}
+export function detectProject(startDir) {
+    let currentDir = path.resolve(startDir);
+    const root = path.parse(currentDir).root;
+    while (currentDir !== root) {
+        const bmadDir = path.join(currentDir, '_bmad');
+        if (fs.existsSync(bmadDir) && fs.statSync(bmadDir).isDirectory()) {
+            if (hasModuleWithConfig(bmadDir)) {
+                const { version, modules, ides } = readManifest(bmadDir);
+                const majorVersion = version?.split('.')[0] ?? null;
+                const versionSupported = majorVersion !== null && SUPPORTED_VERSIONS.includes(majorVersion);
+                return {
+                    projectRoot: currentDir,
+                    bmadVersion: version,
+                    versionSupported,
+                    modules,
+                    ideDirectories: ides,
+                };
+            }
+        }
+        const parentDir = path.dirname(currentDir);
+        if (parentDir === currentDir)
+            break;
+        currentDir = parentDir;
+    }
+    return null;
+}
+//# sourceMappingURL=project-detector.js.map

package/packages/server/dist/core/project-detector.js.map

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

package/packages/server/dist/core/project-detector.test.d.ts

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

package/packages/server/dist/core/project-detector.test.d.ts.map

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

package/packages/server/dist/core/project-detector.test.js

@@ -0,0 +1,73 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { detectProject } from './project-detector.js';
+describe('project-detector', () => {
+    let tmpDir;
+    beforeEach(() => {
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'detect-test-'));
+    });
+    afterEach(() => {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+    it('detects project with _bmad/ and module config', () => {
+        const bmadDir = path.join(tmpDir, '_bmad', 'core');
+        fs.mkdirSync(bmadDir, { recursive: true });
+        fs.writeFileSync(path.join(bmadDir, 'config.yaml'), 'user_name: Test\n');
+        const result = detectProject(tmpDir);
+        expect(result).not.toBeNull();
+        expect(result.projectRoot).toBe(tmpDir);
+    });
+    it('reads manifest for version and modules', () => {
+        const bmadDir = path.join(tmpDir, '_bmad');
+        const coreDir = path.join(bmadDir, 'core');
+        const configDir = path.join(bmadDir, '_config');
+        fs.mkdirSync(coreDir, { recursive: true });
+        fs.mkdirSync(configDir, { recursive: true });
+        fs.writeFileSync(path.join(coreDir, 'config.yaml'), 'user_name: Test\n');
+        fs.writeFileSync(path.join(configDir, 'manifest.yaml'), `installation:\n  version: 6.2.0\nmodules:\n  - name: core\n    version: 6.2.0\n    source: built-in\nides:\n  - claude-code\n`);
+        const result = detectProject(tmpDir);
+        expect(result).not.toBeNull();
+        expect(result.bmadVersion).toBe('6.2.0');
+        expect(result.versionSupported).toBe(true);
+        expect(result.modules).toHaveLength(1);
+        expect(result.modules[0].name).toBe('core');
+        expect(result.ideDirectories).toEqual(['claude-code']);
+    });
+    it('scans upward from subdirectory', () => {
+        const bmadDir = path.join(tmpDir, '_bmad', 'core');
+        fs.mkdirSync(bmadDir, { recursive: true });
+        fs.writeFileSync(path.join(bmadDir, 'config.yaml'), 'user_name: Test\n');
+        const subDir = path.join(tmpDir, 'deep', 'nested', 'dir');
+        fs.mkdirSync(subDir, { recursive: true });
+        const result = detectProject(subDir);
+        expect(result).not.toBeNull();
+        expect(result.projectRoot).toBe(tmpDir);
+    });
+    it('returns null when no _bmad/ found', () => {
+        const result = detectProject(tmpDir);
+        expect(result).toBeNull();
+    });
+    it('returns null when _bmad/ exists but no module with config', () => {
+        const bmadDir = path.join(tmpDir, '_bmad');
+        fs.mkdirSync(bmadDir, { recursive: true });
+        // _bmad/ exists but no module subdirectory with config.yaml
+        const result = detectProject(tmpDir);
+        expect(result).toBeNull();
+    });
+    it('warns about unsupported version', () => {
+        const bmadDir = path.join(tmpDir, '_bmad');
+        const coreDir = path.join(bmadDir, 'core');
+        const configDir = path.join(bmadDir, '_config');
+        fs.mkdirSync(coreDir, { recursive: true });
+        fs.mkdirSync(configDir, { recursive: true });
+        fs.writeFileSync(path.join(coreDir, 'config.yaml'), 'user_name: Test\n');
+        fs.writeFileSync(path.join(configDir, 'manifest.yaml'), `installation:\n  version: 5.0.0\nmodules:\n  - name: core\n    version: 5.0.0\n    source: built-in\n`);
+        const result = detectProject(tmpDir);
+        expect(result).not.toBeNull();
+        expect(result.bmadVersion).toBe('5.0.0');
+        expect(result.versionSupported).toBe(false);
+    });
+});
+//# sourceMappingURL=project-detector.test.js.map

package/packages/server/dist/core/project-detector.test.js.map

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

package/packages/server/dist/core/websocket.d.ts

@@ -0,0 +1,16 @@
+import type { FastifyInstance } from 'fastify';
+import type { WebSocket } from 'ws';
+import type { WebSocketEvent } from '@bmad-studio/shared';
+export declare class WebSocketManager {
+    private clients;
+    addClient(socket: WebSocket): void;
+    broadcast(event: WebSocketEvent): void;
+    get clientCount(): number;
+}
+export declare function registerWebSocket(app: FastifyInstance): Promise<void>;
+declare module 'fastify' {
+    interface FastifyInstance {
+        ws: WebSocketManager;
+    }
+}
+//# sourceMappingURL=websocket.d.ts.map

package/packages/server/dist/core/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../src/core/websocket.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAA;AACnC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEzD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAuB;IAEtC,SAAS,CAAC,MAAM,EAAE,SAAS;IAO3B,SAAS,CAAC,KAAK,EAAE,cAAc;IAS/B,IAAI,WAAW,WAEd;CACF;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,eAAe,iBAU3D;AAED,OAAO,QAAQ,SAAS,CAAC;IACvB,UAAU,eAAe;QACvB,EAAE,EAAE,gBAAgB,CAAA;KACrB;CACF"}

package/packages/server/dist/core/websocket.js

@@ -0,0 +1,30 @@
+import websocket from '@fastify/websocket';
+export class WebSocketManager {
+    clients = new Set();
+    addClient(socket) {
+        this.clients.add(socket);
+        socket.on('close', () => {
+            this.clients.delete(socket);
+        });
+    }
+    broadcast(event) {
+        const data = JSON.stringify(event);
+        for (const client of this.clients) {
+            if (client.readyState === 1) {
+                client.send(data);
+            }
+        }
+    }
+    get clientCount() {
+        return this.clients.size;
+    }
+}
+export async function registerWebSocket(app) {
+    const manager = new WebSocketManager();
+    await app.register(websocket);
+    app.get('/ws', { websocket: true }, (socket) => {
+        manager.addClient(socket);
+    });
+    app.decorate('ws', manager);
+}
+//# sourceMappingURL=websocket.js.map

package/packages/server/dist/core/websocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.js","sourceRoot":"","sources":["../../src/core/websocket.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,oBAAoB,CAAA;AAM1C,MAAM,OAAO,gBAAgB;IACnB,OAAO,GAAG,IAAI,GAAG,EAAa,CAAA;IAEtC,SAAS,CAAC,MAAiB;QACzB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QACxB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACtB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QAC7B,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,SAAS,CAAC,KAAqB;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;QAClC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,IAAI,MAAM,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;gBAC5B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACnB,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAA;IAC1B,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAoB;IAC1D,MAAM,OAAO,GAAG,IAAI,gBAAgB,EAAE,CAAA;IAEtC,MAAM,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;IAE7B,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,EAAE,EAAE;QAC7C,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IAC3B,CAAC,CAAC,CAAA;IAEF,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;AAC7B,CAAC"}

package/packages/server/dist/core/websocket.test.d.ts

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

package/packages/server/dist/core/websocket.test.d.ts.map

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

package/packages/server/dist/core/websocket.test.js

@@ -0,0 +1,64 @@
+import { describe, it, expect } from 'vitest';
+import { WebSocketManager } from './websocket.js';
+function createMockSocket(readyState = 1) {
+    const sent = [];
+    const handlers = {};
+    return {
+        readyState,
+        send: (data) => sent.push(data),
+        on: (event, handler) => {
+            handlers[event] = handlers[event] || [];
+            handlers[event].push(handler);
+        },
+        triggerClose: () => handlers['close']?.forEach((h) => h()),
+        sent,
+    };
+}
+describe('WebSocketManager', () => {
+    it('tracks connected clients', () => {
+        const manager = new WebSocketManager();
+        const socket = createMockSocket();
+        manager.addClient(socket);
+        expect(manager.clientCount).toBe(1);
+    });
+    it('removes client on close', () => {
+        const manager = new WebSocketManager();
+        const socket = createMockSocket();
+        manager.addClient(socket);
+        socket.triggerClose();
+        expect(manager.clientCount).toBe(0);
+    });
+    it('broadcasts event to all connected clients', () => {
+        const manager = new WebSocketManager();
+        const socket1 = createMockSocket();
+        const socket2 = createMockSocket();
+        manager.addClient(socket1);
+        manager.addClient(socket2);
+        const event = { type: 'file:changed', path: '/test.yaml', category: 'agent' };
+        manager.broadcast(event);
+        expect(socket1.sent).toHaveLength(1);
+        expect(JSON.parse(socket1.sent[0])).toEqual(event);
+        expect(socket2.sent).toHaveLength(1);
+    });
+    it('skips clients that are not in OPEN state', () => {
+        const manager = new WebSocketManager();
+        const openSocket = createMockSocket(1);
+        const closedSocket = createMockSocket(3); // CLOSED
+        manager.addClient(openSocket);
+        manager.addClient(closedSocket);
+        manager.broadcast({ type: 'project:reloaded' });
+        expect(openSocket.sent).toHaveLength(1);
+        expect(closedSocket.sent).toHaveLength(0);
+    });
+    it('broadcasts compile:needed with agent names', () => {
+        const manager = new WebSocketManager();
+        const socket = createMockSocket();
+        manager.addClient(socket);
+        const event = { type: 'compile:needed', agents: ['pm', 'analyst'] };
+        manager.broadcast(event);
+        const received = JSON.parse(socket.sent[0]);
+        expect(received.type).toBe('compile:needed');
+        expect(received.agents).toEqual(['pm', 'analyst']);
+    });
+});
+//# sourceMappingURL=websocket.test.js.map

package/packages/server/dist/core/websocket.test.js.map

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

package/packages/server/dist/core/write-service.d.ts

@@ -0,0 +1,12 @@
+export type WriteResult = {
+    ok: true;
+    filePath: string;
+    snapshotPath: string | null;
+} | {
+    ok: false;
+    error: string;
+    filePath: string;
+};
+export declare function writeFile(filePath: string, content: string, studioDir: string): WriteResult;
+export declare function getHistory(studioDir: string): string[];
+//# sourceMappingURL=write-service.d.ts.map

package/packages/server/dist/core/write-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-service.d.ts","sourceRoot":"","sources":["../../src/core/write-service.ts"],"names":[],"mappings":"AAsBA,MAAM,MAAM,WAAW,GACnB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC3D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAA;AAElD,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,CA0C3F;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAItD"}