bmad-studio 0.1.0 → 1.0.0

package/packages/server/dist/core/module-registry.js

@@ -0,0 +1,109 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import yaml from 'js-yaml';
+import { downloadGithubTarball, parseGithubSource } from './module-installer.js';
+import { parseModuleYaml } from '../parsers/module-yaml-parser.js';
+const CACHE_TTL_MS = 60 * 60 * 1000; // 1 hour
+function cacheFilePath(studioDir, owner, repo) {
+    return path.join(studioDir, 'cache', `registry-${owner}-${repo}.json`);
+}
+export function readCachedRegistryIndex(studioDir, owner, repo) {
+    const file = cacheFilePath(studioDir, owner, repo);
+    if (!fs.existsSync(file))
+        return null;
+    try {
+        return JSON.parse(fs.readFileSync(file, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+export function isRegistryCacheStale(index) {
+    const fetched = new Date(index.fetchedAt).getTime();
+    return Date.now() - fetched > CACHE_TTL_MS;
+}
+export async function fetchAndCacheRegistryIndex(studioDir, repoString, branch) {
+    const ghSource = parseGithubSource(`${repoString}@${branch}`);
+    const { extractedRoot, tmpDir } = await downloadGithubTarball(ghSource);
+    try {
+        // Optional index.yaml at the repo root
+        let indexMeta = null;
+        let indexYamlError;
+        const indexYamlPath = path.join(extractedRoot, 'index.yaml');
+        if (fs.existsSync(indexYamlPath)) {
+            try {
+                indexMeta = yaml.load(fs.readFileSync(indexYamlPath, 'utf-8'));
+            }
+            catch (err) {
+                indexYamlError = err instanceof Error ? err.message : String(err);
+            }
+        }
+        const modules = [];
+        for (const entry of fs.readdirSync(extractedRoot, { withFileTypes: true })) {
+            if (!entry.isDirectory())
+                continue;
+            if (entry.name.startsWith('.') || entry.name.startsWith('_'))
+                continue;
+            const moduleDir = path.join(extractedRoot, entry.name);
+            const hasModuleYaml = fs.existsSync(path.join(moduleDir, 'module.yaml'));
+            const hasEntities = ['agents', 'skills', 'workflows', 'tasks'].some((sub) => fs.existsSync(path.join(moduleDir, sub)));
+            if (!hasModuleYaml && !hasEntities)
+                continue;
+            const parsed = parseModuleYaml(moduleDir);
+            if (!parsed.ok)
+                continue;
+            const agentCount = fs.existsSync(path.join(moduleDir, 'agents'))
+                ? fs
+                    .readdirSync(path.join(moduleDir, 'agents'))
+                    .filter((f) => f.endsWith('.md') || f.endsWith('.yaml')).length
+                : 0;
+            const workflowCount = fs.existsSync(path.join(moduleDir, 'workflows'))
+                ? fs
+                    .readdirSync(path.join(moduleDir, 'workflows'), { withFileTypes: true })
+                    .filter((e) => e.isDirectory()).length
+                : 0;
+            const taskCount = fs.existsSync(path.join(moduleDir, 'tasks'))
+                ? fs
+                    .readdirSync(path.join(moduleDir, 'tasks'), { withFileTypes: true })
+                    .filter((e) => e.isDirectory()).length
+                : 0;
+            const indexEntry = indexMeta?.modules?.[parsed.data.code];
+            modules.push({
+                code: parsed.data.code,
+                name: parsed.data.name ?? parsed.data.code,
+                version: parsed.data.version ?? '1.0.0',
+                description: parsed.data.description ?? '',
+                agentCount,
+                workflowCount,
+                taskCount,
+                tags: indexEntry?.tags,
+                status: indexEntry?.status,
+                category: indexEntry?.category,
+                rawModuleYaml: hasModuleYaml ? parsed.data : null,
+            });
+        }
+        modules.sort((a, b) => a.name.localeCompare(b.name));
+        const index = {
+            owner: ghSource.owner,
+            repo: ghSource.repo,
+            branch: ghSource.branch ?? branch,
+            fetchedAt: new Date().toISOString(),
+            modules,
+            ...(indexYamlError !== undefined ? { indexYamlError } : {}),
+        };
+        // Write cache
+        const cacheFile = cacheFilePath(studioDir, ghSource.owner, ghSource.repo);
+        fs.mkdirSync(path.dirname(cacheFile), { recursive: true });
+        fs.writeFileSync(cacheFile, JSON.stringify(index, null, 2), 'utf-8');
+        return index;
+    }
+    finally {
+        try {
+            fs.rmSync(tmpDir, { recursive: true, force: true });
+        }
+        catch {
+            // ignore cleanup errors
+        }
+    }
+}
+//# sourceMappingURL=module-registry.js.map

package/packages/server/dist/core/module-registry.js.map

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

package/packages/server/dist/core/module-registry.test.d.ts

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

package/packages/server/dist/core/module-registry.test.d.ts.map

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

package/packages/server/dist/core/module-registry.test.js

@@ -0,0 +1,280 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { execSync } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import yaml from 'js-yaml';
+import { createApp } from '../app.js';
+import { fetchAndCacheRegistryIndex, isRegistryCacheStale, readCachedRegistryIndex, } from './module-registry.js';
+// ─── Fixture tarball helpers ────────────────────────────────────────────────
+/**
+ * Build a fixture tarball that mimics GitHub's tarball format. GitHub tarballs
+ * always extract to a single wrapper directory like {owner}-{repo}-{shortsha}/.
+ */
+function buildFixtureTarball(wrapperName, contentBuilder) {
+    const stagingRoot = fs.realpathSync(fs.mkdtempSync(path.join(os.tmpdir(), 'bmad-registry-fixture-')));
+    try {
+        const wrapperDir = path.join(stagingRoot, wrapperName);
+        fs.mkdirSync(wrapperDir, { recursive: true });
+        contentBuilder(wrapperDir);
+        const tarballPath = path.join(stagingRoot, 'fixture.tar.gz');
+        execSync(`tar -czf "${tarballPath}" -C "${stagingRoot}" "${wrapperName}"`, { stdio: 'pipe' });
+        return fs.readFileSync(tarballPath);
+    }
+    finally {
+        fs.rmSync(stagingRoot, { recursive: true, force: true });
+    }
+}
+function mockTarballResponse(bytes) {
+    return new Response(bytes, {
+        status: 200,
+        statusText: 'OK',
+        headers: { 'Content-Type': 'application/gzip' },
+    });
+}
+function mockUnauthorizedResponse() {
+    return new Response('Unauthorized', { status: 401, statusText: 'Unauthorized' });
+}
+// A registry with two modules and an index.yaml
+const REGISTRY_WITH_INDEX = buildFixtureTarball('owner-modules-abc1234', (wrapper) => {
+    // Module alpha
+    fs.mkdirSync(path.join(wrapper, 'alpha', 'agents'), { recursive: true });
+    fs.mkdirSync(path.join(wrapper, 'alpha', 'workflows'), { recursive: true });
+    fs.writeFileSync(path.join(wrapper, 'alpha', 'agents', 'agent.md'), '# Agent\n');
+    fs.writeFileSync(path.join(wrapper, 'alpha', 'module.yaml'), yaml.dump({
+        code: 'alpha',
+        name: 'Alpha Module',
+        version: '2.0.0',
+        description: 'An alpha module',
+    }));
+    // Module beta (tasks only)
+    fs.mkdirSync(path.join(wrapper, 'beta', 'tasks', 'my-task'), { recursive: true });
+    fs.writeFileSync(path.join(wrapper, 'beta', 'tasks', 'my-task', 'SKILL.md'), '# Task\n');
+    fs.writeFileSync(path.join(wrapper, 'beta', 'module.yaml'), yaml.dump({ code: 'beta', name: 'Beta Module', version: '1.5.0', description: 'A beta module' }));
+    // index.yaml with metadata for alpha
+    fs.writeFileSync(path.join(wrapper, 'index.yaml'), yaml.dump({
+        modules: {
+            alpha: { tags: ['analytics', 'reporting'], status: 'stable', category: 'data' },
+        },
+    }));
+    // Hidden dir and underscore dir — must be excluded
+    fs.mkdirSync(path.join(wrapper, '.hidden'), { recursive: true });
+    fs.mkdirSync(path.join(wrapper, '_internal'), { recursive: true });
+});
+// A registry with no index.yaml
+const REGISTRY_NO_INDEX = buildFixtureTarball('owner-modules-abc1234', (wrapper) => {
+    fs.mkdirSync(path.join(wrapper, 'gamma', 'agents'), { recursive: true });
+    fs.writeFileSync(path.join(wrapper, 'gamma', 'agents', 'g.md'), '# G\n');
+    fs.writeFileSync(path.join(wrapper, 'gamma', 'module.yaml'), yaml.dump({ code: 'gamma', name: 'Gamma Module', version: '0.9.0', description: '' }));
+});
+// A registry with malformed index.yaml
+const REGISTRY_BAD_INDEX = buildFixtureTarball('owner-modules-abc1234', (wrapper) => {
+    fs.mkdirSync(path.join(wrapper, 'delta', 'agents'), { recursive: true });
+    fs.writeFileSync(path.join(wrapper, 'delta', 'agents', 'd.md'), '# D\n');
+    fs.writeFileSync(path.join(wrapper, 'delta', 'module.yaml'), yaml.dump({ code: 'delta', name: 'Delta Module', version: '1.0.0', description: '' }));
+    // Malformed YAML
+    fs.writeFileSync(path.join(wrapper, 'index.yaml'), '{ not: valid: yaml: :::');
+});
+// ─── Unit tests for module-registry.ts ──────────────────────────────────────
+describe('module-registry — unit', () => {
+    let tmpDir;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let fetchSpy;
+    beforeEach(() => {
+        tmpDir = fs.realpathSync(fs.mkdtempSync(path.join(os.tmpdir(), 'module-registry-test-')));
+        fs.mkdirSync(path.join(tmpDir, '.bmad-studio'), { recursive: true });
+        fetchSpy = vi.spyOn(globalThis, 'fetch');
+    });
+    afterEach(() => {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+        vi.restoreAllMocks();
+    });
+    const studioDir = () => path.join(tmpDir, '.bmad-studio');
+    it('AC-16.2.2 — fetches index with two modules and applies index.yaml metadata', async () => {
+        fetchSpy.mockImplementationOnce(async () => mockTarballResponse(REGISTRY_WITH_INDEX));
+        const index = await fetchAndCacheRegistryIndex(studioDir(), 'owner/modules', 'main');
+        expect(index.owner).toBe('owner');
+        expect(index.repo).toBe('modules');
+        expect(index.branch).toBe('main');
+        expect(index.fetchedAt).toMatch(/^\d{4}-\d{2}-\d{2}/);
+        // AC-16.2.3, AC-16.2.4 — sorted alphabetically, metadata present
+        expect(index.modules).toHaveLength(2);
+        expect(index.modules[0].code).toBe('alpha');
+        expect(index.modules[1].code).toBe('beta');
+        const alpha = index.modules[0];
+        expect(alpha.name).toBe('Alpha Module');
+        expect(alpha.version).toBe('2.0.0');
+        expect(alpha.agentCount).toBe(1);
+        expect(alpha.workflowCount).toBe(0);
+        expect(alpha.tags).toEqual(['analytics', 'reporting']);
+        expect(alpha.status).toBe('stable');
+        expect(alpha.category).toBe('data');
+        expect(alpha.rawModuleYaml).not.toBeNull();
+        const beta = index.modules[1];
+        expect(beta.taskCount).toBe(1);
+        expect(beta.tags).toBeUndefined();
+    });
+    it('AC-16.2.5 — excludes dot and underscore directories', async () => {
+        fetchSpy.mockImplementationOnce(async () => mockTarballResponse(REGISTRY_WITH_INDEX));
+        const index = await fetchAndCacheRegistryIndex(studioDir(), 'owner/modules', 'main');
+        const codes = index.modules.map((m) => m.code);
+        expect(codes).not.toContain('.hidden');
+        expect(codes).not.toContain('_internal');
+    });
+    it('AC-16.2.6 — writes cache to .bmad-studio/cache/registry-{owner}-{repo}.json', async () => {
+        fetchSpy.mockImplementationOnce(async () => mockTarballResponse(REGISTRY_WITH_INDEX));
+        await fetchAndCacheRegistryIndex(studioDir(), 'owner/modules', 'main');
+        const cachePath = path.join(studioDir(), 'cache', 'registry-owner-modules.json');
+        expect(fs.existsSync(cachePath)).toBe(true);
+        const cached = JSON.parse(fs.readFileSync(cachePath, 'utf-8'));
+        expect(cached.modules).toHaveLength(2);
+    });
+    it('AC-16.2.7 — readCachedRegistryIndex returns null when no cache exists', () => {
+        const result = readCachedRegistryIndex(studioDir(), 'owner', 'modules');
+        expect(result).toBeNull();
+    });
+    it('AC-16.2.7 — readCachedRegistryIndex returns cached index', async () => {
+        fetchSpy.mockImplementationOnce(async () => mockTarballResponse(REGISTRY_WITH_INDEX));
+        await fetchAndCacheRegistryIndex(studioDir(), 'owner/modules', 'main');
+        const cached = readCachedRegistryIndex(studioDir(), 'owner', 'modules');
+        expect(cached).not.toBeNull();
+        expect(cached.modules).toHaveLength(2);
+    });
+    it('isRegistryCacheStale — false for fresh cache', () => {
+        const index = {
+            owner: 'o',
+            repo: 'r',
+            branch: 'main',
+            fetchedAt: new Date().toISOString(),
+            modules: [],
+        };
+        expect(isRegistryCacheStale(index)).toBe(false);
+    });
+    it('isRegistryCacheStale — true after 1 hour + 1ms', () => {
+        const index = {
+            owner: 'o',
+            repo: 'r',
+            branch: 'main',
+            fetchedAt: new Date(Date.now() - 60 * 60 * 1000 - 1).toISOString(),
+            modules: [],
+        };
+        expect(isRegistryCacheStale(index)).toBe(true);
+    });
+    it('without index.yaml — modules parsed, indexYamlError undefined', async () => {
+        fetchSpy.mockImplementationOnce(async () => mockTarballResponse(REGISTRY_NO_INDEX));
+        const index = await fetchAndCacheRegistryIndex(studioDir(), 'owner/modules', 'main');
+        expect(index.modules).toHaveLength(1);
+        expect(index.modules[0].code).toBe('gamma');
+        expect(index.indexYamlError).toBeUndefined();
+    });
+    it('AC-16.2.9 — malformed index.yaml sets indexYamlError, modules still returned', async () => {
+        fetchSpy.mockImplementationOnce(async () => mockTarballResponse(REGISTRY_BAD_INDEX));
+        const index = await fetchAndCacheRegistryIndex(studioDir(), 'owner/modules', 'main');
+        expect(index.modules).toHaveLength(1);
+        expect(index.modules[0].code).toBe('delta');
+        expect(index.indexYamlError).toBeDefined();
+        expect(typeof index.indexYamlError).toBe('string');
+    });
+});
+// ─── API endpoint tests (via modules-plugin) ────────────────────────────────
+function makeProject(tmpDir) {
+    return {
+        projectRoot: tmpDir,
+        bmadVersion: '6.2.0',
+        versionSupported: true,
+        modules: [],
+        ideDirectories: [],
+    };
+}
+describe('modules-plugin — Story 16.2 registry endpoints', () => {
+    let tmpDir;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let fetchSpy;
+    beforeEach(() => {
+        tmpDir = fs.realpathSync(fs.mkdtempSync(path.join(os.tmpdir(), 'registry-plugin-test-')));
+        const configDir = path.join(tmpDir, '_bmad', '_config');
+        fs.mkdirSync(configDir, { recursive: true });
+        fs.writeFileSync(path.join(configDir, 'manifest.yaml'), yaml.dump({
+            installation: {
+                version: '6.2.0',
+                installDate: '2026-01-01T00:00:00.000Z',
+                lastUpdated: '2026-01-01T00:00:00.000Z',
+            },
+            modules: [],
+        }));
+        fs.mkdirSync(path.join(tmpDir, '.bmad-studio'), { recursive: true });
+        fetchSpy = vi.spyOn(globalThis, 'fetch');
+    });
+    afterEach(() => {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+        vi.restoreAllMocks();
+    });
+    it('AC-16.2.1 — GET /api/registry returns configured:false when no settings file', async () => {
+        const app = await createApp({ logger: false, serveStatic: false, project: makeProject(tmpDir) });
+        const resp = await app.inject({ method: 'GET', url: '/api/registry' });
+        expect(resp.statusCode).toBe(200);
+        const body = JSON.parse(resp.body);
+        expect(body.ok).toBe(false);
+        expect(body.configured).toBe(false);
+        await app.close();
+    });
+    it('AC-16.2.1 — GET /api/registry returns configured:false when settings has no registry block', async () => {
+        fs.writeFileSync(path.join(tmpDir, '.bmad-studio', 'settings.json'), JSON.stringify({ port: 4040, theme: 'dark' }));
+        const app = await createApp({ logger: false, serveStatic: false, project: makeProject(tmpDir) });
+        const resp = await app.inject({ method: 'GET', url: '/api/registry' });
+        expect(resp.statusCode).toBe(200);
+        const body = JSON.parse(resp.body);
+        expect(body.ok).toBe(false);
+        expect(body.configured).toBe(false);
+        await app.close();
+    });
+    it('AC-16.2.2 — GET /api/registry fetches and returns index when configured', async () => {
+        fs.writeFileSync(path.join(tmpDir, '.bmad-studio', 'settings.json'), JSON.stringify({ registry: { repo: 'owner/modules', branch: 'main' } }));
+        fetchSpy.mockImplementationOnce(async () => mockTarballResponse(REGISTRY_WITH_INDEX));
+        const app = await createApp({ logger: false, serveStatic: false, project: makeProject(tmpDir) });
+        const resp = await app.inject({ method: 'GET', url: '/api/registry' });
+        expect(resp.statusCode).toBe(200);
+        const body = JSON.parse(resp.body);
+        expect(body.ok).toBe(true);
+        expect(body.configured).toBe(true);
+        expect(body.index.owner).toBe('owner');
+        expect(body.index.modules).toHaveLength(2);
+        await app.close();
+    });
+    it('AC-16.2.7 — second GET /api/registry within TTL uses cache, no second fetch', async () => {
+        fs.writeFileSync(path.join(tmpDir, '.bmad-studio', 'settings.json'), JSON.stringify({ registry: { repo: 'owner/modules', branch: 'main' } }));
+        fetchSpy.mockImplementation(async () => mockTarballResponse(REGISTRY_WITH_INDEX));
+        const app = await createApp({ logger: false, serveStatic: false, project: makeProject(tmpDir) });
+        await app.inject({ method: 'GET', url: '/api/registry' });
+        expect(fetchSpy).toHaveBeenCalledTimes(1);
+        await app.inject({ method: 'GET', url: '/api/registry' });
+        expect(fetchSpy).toHaveBeenCalledTimes(1); // still 1 — served from cache
+        await app.close();
+    });
+    it('AC-16.2.8 — POST /api/registry/refresh always re-fetches', async () => {
+        fs.writeFileSync(path.join(tmpDir, '.bmad-studio', 'settings.json'), JSON.stringify({ registry: { repo: 'owner/modules', branch: 'main' } }));
+        fetchSpy.mockImplementation(async () => mockTarballResponse(REGISTRY_WITH_INDEX));
+        const app = await createApp({ logger: false, serveStatic: false, project: makeProject(tmpDir) });
+        // First populate the cache
+        await app.inject({ method: 'GET', url: '/api/registry' });
+        expect(fetchSpy).toHaveBeenCalledTimes(1);
+        // Refresh should always re-fetch
+        const resp = await app.inject({ method: 'POST', url: '/api/registry/refresh' });
+        expect(resp.statusCode).toBe(200);
+        const body = JSON.parse(resp.body);
+        expect(body.ok).toBe(true);
+        expect(fetchSpy).toHaveBeenCalledTimes(2);
+        await app.close();
+    });
+    it('AC-16.2.10 — unauthorized GitHub repo surfaces error', async () => {
+        fs.writeFileSync(path.join(tmpDir, '.bmad-studio', 'settings.json'), JSON.stringify({ registry: { repo: 'private/repo', branch: 'main' } }));
+        fetchSpy.mockImplementationOnce(async () => mockUnauthorizedResponse());
+        const app = await createApp({ logger: false, serveStatic: false, project: makeProject(tmpDir) });
+        const resp = await app.inject({ method: 'GET', url: '/api/registry' });
+        expect(resp.statusCode).toBe(422);
+        const body = JSON.parse(resp.body);
+        expect(body.error.message).toContain('private/repo');
+        await app.close();
+    });
+});
+//# sourceMappingURL=module-registry.test.js.map

package/packages/server/dist/core/module-registry.test.js.map

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