bmad-studio 0.2.0 → 1.0.0

package/packages/server/dist/core/write-service.test.js

@@ -2,12 +2,12 @@ import { describe, it, expect, beforeEach, afterEach } from 'vitest';
 import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
-import { writeFile, getHistory } from './write-service.js';
+import { deleteDirectory, deleteFile, getHistory, writeFile } from './write-service.js';
 describe('write-service', () => {
     let tmpDir;
     let studioDir;
     beforeEach(() => {
-        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'write-test-'));
+        tmpDir = fs.realpathSync(fs.mkdtempSync(path.join(os.tmpdir(), 'write-test-')));
         studioDir = path.join(tmpDir, '.bmad-studio');
     });
     afterEach(() => {
@@ -38,18 +38,18 @@ describe('write-service', () => {
             expect(result.snapshotPath).toBeNull();
         }
     });
-    it('prunes history when exceeding 50 snapshots', () => {
+    it('prunes history when exceeding HISTORY_CAP (500 after TD-17)', () => {
         const historyDir = path.join(studioDir, 'history');
         fs.mkdirSync(historyDir, { recursive: true });
-        // Create 52 existing snapshots
-        for (let i = 0; i < 52; i++) {
+        // Create 502 existing snapshots
+        for (let i = 0; i < 502; i++) {
             fs.writeFileSync(path.join(historyDir, `${1000 + i}-old.md`), `snapshot ${i}`);
         }
         const filePath = path.join(tmpDir, 'test.md');
         fs.writeFileSync(filePath, 'existing');
         writeFile(filePath, 'updated', studioDir);
         const remaining = fs.readdirSync(historyDir);
-        expect(remaining.length).toBeLessThanOrEqual(50);
+        expect(remaining.length).toBeLessThanOrEqual(500);
     });
     it('getHistory returns sorted list of snapshots', () => {
         const historyDir = path.join(studioDir, 'history');
@@ -65,5 +65,92 @@ describe('write-service', () => {
         expect(result.ok).toBe(true); // ensureDir creates parents
         expect(fs.readFileSync(filePath, 'utf-8')).toBe('content');
     });
+    // ───────────────────────────────────────────────────────────────────────────
+    // Story 15.7 — deleteFile / deleteDirectory
+    // ───────────────────────────────────────────────────────────────────────────
+    describe('deleteFile', () => {
+        it('AC-15.7.1: snapshots a text file to history/ then unlinks', () => {
+            const filePath = path.join(tmpDir, 'doc.md');
+            fs.writeFileSync(filePath, '# Original content\n');
+            const result = deleteFile(filePath, studioDir);
+            expect(result.ok).toBe(true);
+            if (!result.ok)
+                return;
+            // File is gone
+            expect(fs.existsSync(filePath)).toBe(false);
+            // Snapshot exists in history/
+            expect(result.snapshotPath).not.toBeNull();
+            expect(result.snapshotPath).toBeTruthy();
+            const historyEntries = fs.readdirSync(path.join(studioDir, 'history'));
+            const snap = historyEntries.find((n) => n.endsWith('doc.md'));
+            expect(snap).toBeDefined();
+            expect(fs.readFileSync(path.join(studioDir, 'history', snap), 'utf-8')).toBe('# Original content\n');
+        });
+        it('TD-16: binary file unlinks without snapshot', () => {
+            const filePath = path.join(tmpDir, 'logo.png');
+            // PNG header bytes (intentionally invalid utf-8 so any accidental decode breaks)
+            fs.writeFileSync(filePath, Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a]));
+            const result = deleteFile(filePath, studioDir);
+            expect(result.ok).toBe(true);
+            if (!result.ok)
+                return;
+            // File is gone
+            expect(fs.existsSync(filePath)).toBe(false);
+            // snapshotPath is null (no snapshot for binaries)
+            expect(result.snapshotPath).toBeNull();
+            // No .png files in history/ at all
+            const historyDir = path.join(studioDir, 'history');
+            if (fs.existsSync(historyDir)) {
+                const entries = fs.readdirSync(historyDir);
+                expect(entries.some((n) => n.endsWith('.png'))).toBe(false);
+            }
+        });
+        it('AC-15.7.3: returns { ok: false } on missing path (does not throw)', () => {
+            const result = deleteFile(path.join(tmpDir, 'ghost.md'), studioDir);
+            expect(result.ok).toBe(false);
+            if (result.ok)
+                return;
+            expect(result.error).toBe('File does not exist');
+        });
+    });
+    describe('deleteDirectory', () => {
+        it('AC-15.7.2: snapshots text files before unlinking the tree', () => {
+            const dir = path.join(tmpDir, 'mod');
+            fs.mkdirSync(path.join(dir, 'agents'), { recursive: true });
+            fs.writeFileSync(path.join(dir, 'agents', 'a.md'), '# Agent A\n');
+            fs.writeFileSync(path.join(dir, 'agents', 'b.md'), '# Agent B\n');
+            fs.writeFileSync(path.join(dir, 'config.yaml'), 'key: value\n');
+            const result = deleteDirectory(dir, studioDir);
+            expect(result.ok).toBe(true);
+            // The directory is gone
+            expect(fs.existsSync(dir)).toBe(false);
+            // All three text files snapshotted
+            const history = fs.readdirSync(path.join(studioDir, 'history'));
+            expect(history.some((n) => n.endsWith('a.md'))).toBe(true);
+            expect(history.some((n) => n.endsWith('b.md'))).toBe(true);
+            expect(history.some((n) => n.endsWith('config.yaml'))).toBe(true);
+        });
+        it('TD-16: mixed text + binary dir snapshots only text', () => {
+            const dir = path.join(tmpDir, 'mod');
+            fs.mkdirSync(path.join(dir, 'assets'), { recursive: true });
+            fs.writeFileSync(path.join(dir, 'readme.md'), '# Readme\n');
+            fs.writeFileSync(path.join(dir, 'assets', 'icon.png'), Buffer.from([0x89, 0x50, 0x4e, 0x47]));
+            const result = deleteDirectory(dir, studioDir);
+            expect(result.ok).toBe(true);
+            // Directory is gone
+            expect(fs.existsSync(dir)).toBe(false);
+            // readme.md snapshotted, icon.png NOT
+            const history = fs.readdirSync(path.join(studioDir, 'history'));
+            expect(history.some((n) => n.endsWith('readme.md'))).toBe(true);
+            expect(history.some((n) => n.endsWith('.png'))).toBe(false);
+        });
+        it('AC-15.7.3: returns { ok: false } on missing directory', () => {
+            const result = deleteDirectory(path.join(tmpDir, 'ghost-dir'), studioDir);
+            expect(result.ok).toBe(false);
+            if (result.ok)
+                return;
+            expect(result.error).toBe('Directory does not exist');
+        });
+    });
 });
 //# sourceMappingURL=write-service.test.js.map

package/packages/server/dist/core/write-service.test.js.map

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

package/packages/server/dist/index.js

@@ -1,8 +1,50 @@
 import fs from 'node:fs';
+import path from 'node:path';
 import { createApp } from './app.js';
 import { detectProject } from './core/project-detector.js';
 const DEFAULT_PORT = 4040;
 const MAX_PORT_RETRIES = 10;
+/**
+ * Read the settings file from the studio directory.
+ * Returns null if the file doesn't exist or can't be parsed.
+ */
+function readSettingsFile(studioDir) {
+    if (!studioDir)
+        return null;
+    const settingsPath = path.join(studioDir, 'settings.json');
+    if (!fs.existsSync(settingsPath))
+        return null;
+    try {
+        return JSON.parse(fs.readFileSync(settingsPath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Build Fastify logger options. When file logging is enabled in settings,
+ * configures pino to write to both stdout and .bmad-studio/logs/studio.log.
+ */
+function buildLoggerOptions(settings, studioDir, verbose) {
+    const fileLogging = settings?.logging?.enabled && studioDir;
+    const level = verbose ? 'debug' : (settings?.logging?.level ?? 'info');
+    if (!fileLogging) {
+        // Default: stdout only (Fastify default behaviour)
+        return verbose ? { level: 'debug' } : true;
+    }
+    const logsDir = path.join(studioDir, 'logs');
+    const logFile = path.join(logsDir, 'studio.log');
+    console.log(`File logging enabled — writing to ${logFile}`);
+    return {
+        level,
+        transport: {
+            targets: [
+                { target: 'pino/file', level, options: { destination: 1 } }, // stdout (fd 1)
+                { target: 'pino/file', level, options: { destination: logFile, mkdir: true } },
+            ],
+        },
+    };
+}
 function parseArgs(args) {
     let port = DEFAULT_PORT;
     let dir;
@@ -56,8 +98,11 @@ async function main() {
         console.warn('No BMAD project found. Run from project root or use --dir /path');
         console.warn('Starting in setup mode...');
     }
+    const studioDir = project ? path.join(project.projectRoot, '.bmad-studio') : null;
+    const settings = readSettingsFile(studioDir);
+    const loggerOptions = buildLoggerOptions(settings, studioDir, verbose);
     const app = await createApp({
-        logger: verbose ? { level: 'debug' } : true,
+        logger: loggerOptions,
         project,
     });
     // Listen with port auto-increment on EADDRINUSE

package/packages/server/dist/index.js.map

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

package/packages/server/dist/parsers/module-yaml-parser.d.ts

@@ -0,0 +1,16 @@
+import type { ModuleYaml } from '@bmad-studio/shared';
+import type { ParseResult } from './config-parser.js';
+/**
+ * Parse a module's `module.yaml` metadata file.
+ *
+ * Takes a directory path (not a file path) because `module.yaml` is OPTIONAL.
+ * Legacy v6 modules like `dept-aem` ship without one — for these, the parser
+ * returns a graceful fallback derived from the directory basename. See TD-14
+ * in tech-spec-bmad-studio-module-manager-v1.md for the rationale.
+ *
+ * Returns:
+ *   - `{ ok: true, data }` when the file is absent (fallback) OR present and valid.
+ *   - `{ ok: false, error }` only when the file exists but is empty / not an object / malformed YAML.
+ */
+export declare function parseModuleYaml(moduleDir: string): ParseResult<ModuleYaml>;
+//# sourceMappingURL=module-yaml-parser.d.ts.map

package/packages/server/dist/parsers/module-yaml-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-yaml-parser.d.ts","sourceRoot":"","sources":["../../src/parsers/module-yaml-parser.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAErD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAErD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAAC,UAAU,CAAC,CAgD1E"}

package/packages/server/dist/parsers/module-yaml-parser.js

@@ -0,0 +1,62 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import yaml from 'js-yaml';
+/**
+ * Parse a module's `module.yaml` metadata file.
+ *
+ * Takes a directory path (not a file path) because `module.yaml` is OPTIONAL.
+ * Legacy v6 modules like `dept-aem` ship without one — for these, the parser
+ * returns a graceful fallback derived from the directory basename. See TD-14
+ * in tech-spec-bmad-studio-module-manager-v1.md for the rationale.
+ *
+ * Returns:
+ *   - `{ ok: true, data }` when the file is absent (fallback) OR present and valid.
+ *   - `{ ok: false, error }` only when the file exists but is empty / not an object / malformed YAML.
+ */
+export function parseModuleYaml(moduleDir) {
+    const yamlPath = path.join(moduleDir, 'module.yaml');
+    const fallbackCode = path.basename(moduleDir);
+    // Graceful fallback for the common case where module.yaml is absent.
+    if (!fs.existsSync(yamlPath)) {
+        return {
+            ok: true,
+            data: {
+                code: fallbackCode,
+                version: '1.0.0',
+                variables: {},
+                directories: [],
+            },
+        };
+    }
+    try {
+        const content = fs.readFileSync(yamlPath, 'utf-8');
+        const data = yaml.load(content);
+        if (!data || typeof data !== 'object') {
+            return {
+                ok: false,
+                error: 'module.yaml is empty or not an object',
+                filePath: yamlPath,
+            };
+        }
+        return {
+            ok: true,
+            data: {
+                code: (data.code ?? fallbackCode).toString(),
+                name: data.name,
+                version: data.version ?? '1.0.0',
+                description: data.description,
+                variables: data.variables ?? {},
+                directories: data.directories ?? [],
+            },
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            ok: false,
+            error: `module.yaml parse error: ${message}`,
+            filePath: yamlPath,
+        };
+    }
+}
+//# sourceMappingURL=module-yaml-parser.js.map

package/packages/server/dist/parsers/module-yaml-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-yaml-parser.js","sourceRoot":"","sources":["../../src/parsers/module-yaml-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,IAAI,MAAM,SAAS,CAAA;AAM1B;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAA;IACpD,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;IAE7C,qEAAqE;IACrE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO;YACL,EAAE,EAAE,IAAI;YACR,IAAI,EAAE;gBACJ,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,OAAO;gBAChB,SAAS,EAAE,EAAE;gBACb,WAAW,EAAE,EAAE;aAChB;SACF,CAAA;IACH,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QAClD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAA+B,CAAA;QAE7D,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtC,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,uCAAuC;gBAC9C,QAAQ,EAAE,QAAQ;aACnB,CAAA;QACH,CAAC;QAED,OAAO;YACL,EAAE,EAAE,IAAI;YACR,IAAI,EAAE;gBACJ,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,YAAY,CAAC,CAAC,QAAQ,EAAE;gBAC5C,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,OAAO;gBAChC,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,EAAE;gBAC/B,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;aACpC;SACF,CAAA;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAChE,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,4BAA4B,OAAO,EAAE;YAC5C,QAAQ,EAAE,QAAQ;SACnB,CAAA;IACH,CAAC;AACH,CAAC"}

package/packages/server/dist/parsers/module-yaml-parser.test.d.ts

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

package/packages/server/dist/parsers/module-yaml-parser.test.d.ts.map

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

package/packages/server/dist/parsers/module-yaml-parser.test.js

@@ -0,0 +1,156 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { parseModuleYaml } from './module-yaml-parser.js';
+describe('parseModuleYaml', () => {
+    let tmpDir;
+    beforeEach(() => {
+        // TD-20: realpathSync resolves the macOS /var → /private/var symlink so
+        // path comparisons against tmpDir are stable.
+        tmpDir = fs.realpathSync(fs.mkdtempSync(path.join(os.tmpdir(), 'module-yaml-parser-test-')));
+    });
+    afterEach(() => {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+    // AC-15.1.1
+    it('returns the fallback when module.yaml is absent', () => {
+        const moduleDir = path.join(tmpDir, 'dept-aem');
+        fs.mkdirSync(moduleDir);
+        const result = parseModuleYaml(moduleDir);
+        expect(result.ok).toBe(true);
+        if (!result.ok)
+            return;
+        expect(result.data).toEqual({
+            code: 'dept-aem',
+            version: '1.0.0',
+            variables: {},
+            directories: [],
+        });
+    });
+    // AC-15.1.2
+    it('parses a module.yaml with all fields populated, with no field loss', () => {
+        const moduleDir = path.join(tmpDir, 'full-module');
+        fs.mkdirSync(moduleDir);
+        fs.writeFileSync(path.join(moduleDir, 'module.yaml'), [
+            'code: full-module',
+            'name: "Full Featured Module"',
+            'version: "2.1.0"',
+            'description: "A module that exercises every field"',
+            'variables:',
+            '  project_name:',
+            '    prompt: "What is the project name?"',
+            '    default: "my-project"',
+            '  region:',
+            '    prompt: "Deployment region?"',
+            '    default: "us-east-1"',
+            'directories:',
+            '  - "_bmad-output/full-module-artifacts"',
+            '  - "_bmad-output/full-module-cache"',
+        ].join('\n'));
+        const result = parseModuleYaml(moduleDir);
+        expect(result.ok).toBe(true);
+        if (!result.ok)
+            return;
+        expect(result.data).toEqual({
+            code: 'full-module',
+            name: 'Full Featured Module',
+            version: '2.1.0',
+            description: 'A module that exercises every field',
+            variables: {
+                project_name: { prompt: 'What is the project name?', default: 'my-project' },
+                region: { prompt: 'Deployment region?', default: 'us-east-1' },
+            },
+            directories: [
+                '_bmad-output/full-module-artifacts',
+                '_bmad-output/full-module-cache',
+            ],
+        });
+    });
+    // AC-15.1.3
+    it('applies defaults when module.yaml only contains code', () => {
+        const moduleDir = path.join(tmpDir, 'minimal');
+        fs.mkdirSync(moduleDir);
+        fs.writeFileSync(path.join(moduleDir, 'module.yaml'), 'code: dept-aem\n');
+        const result = parseModuleYaml(moduleDir);
+        expect(result.ok).toBe(true);
+        if (!result.ok)
+            return;
+        expect(result.data.code).toBe('dept-aem');
+        expect(result.data.version).toBe('1.0.0');
+        expect(result.data.variables).toEqual({});
+        expect(result.data.directories).toEqual([]);
+        expect(result.data.name).toBeUndefined();
+        expect(result.data.description).toBeUndefined();
+    });
+    // AC-15.1.3 supporting case — variables block parses correctly
+    it('parses a variables block with one entry', () => {
+        const moduleDir = path.join(tmpDir, 'with-vars');
+        fs.mkdirSync(moduleDir);
+        fs.writeFileSync(path.join(moduleDir, 'module.yaml'), [
+            'code: with-vars',
+            'variables:',
+            '  aem_project_name:',
+            '    prompt: "What is the AEM project name?"',
+            '    default: "my-aem-project"',
+        ].join('\n'));
+        const result = parseModuleYaml(moduleDir);
+        expect(result.ok).toBe(true);
+        if (!result.ok)
+            return;
+        expect(result.data.variables).toEqual({
+            aem_project_name: { prompt: 'What is the AEM project name?', default: 'my-aem-project' },
+        });
+    });
+    // AC-15.1.3 supporting case — directories array parses correctly
+    it('parses a directories array', () => {
+        const moduleDir = path.join(tmpDir, 'with-dirs');
+        fs.mkdirSync(moduleDir);
+        fs.writeFileSync(path.join(moduleDir, 'module.yaml'), [
+            'code: with-dirs',
+            'directories:',
+            '  - "_bmad-output/aem-artifacts"',
+        ].join('\n'));
+        const result = parseModuleYaml(moduleDir);
+        expect(result.ok).toBe(true);
+        if (!result.ok)
+            return;
+        expect(result.data.directories).toEqual(['_bmad-output/aem-artifacts']);
+    });
+    // AC-15.1.4
+    it('returns ok:false when module.yaml is empty', () => {
+        const moduleDir = path.join(tmpDir, 'empty-yaml');
+        fs.mkdirSync(moduleDir);
+        fs.writeFileSync(path.join(moduleDir, 'module.yaml'), '');
+        const result = parseModuleYaml(moduleDir);
+        expect(result.ok).toBe(false);
+        if (result.ok)
+            return;
+        expect(result.error).toBe('module.yaml is empty or not an object');
+        expect(result.filePath).toBe(path.join(moduleDir, 'module.yaml'));
+    });
+    // AC-15.1.4 supporting case — whitespace-only file
+    it('returns ok:false when module.yaml contains only whitespace', () => {
+        const moduleDir = path.join(tmpDir, 'whitespace-yaml');
+        fs.mkdirSync(moduleDir);
+        fs.writeFileSync(path.join(moduleDir, 'module.yaml'), '   \n  \n');
+        const result = parseModuleYaml(moduleDir);
+        expect(result.ok).toBe(false);
+        if (result.ok)
+            return;
+        expect(result.error).toBe('module.yaml is empty or not an object');
+    });
+    // AC-15.1.5
+    it('returns ok:false with a parse error message when YAML is malformed', () => {
+        const moduleDir = path.join(tmpDir, 'broken-yaml');
+        fs.mkdirSync(moduleDir);
+        fs.writeFileSync(path.join(moduleDir, 'module.yaml'), 'code: [unclosed\n');
+        const result = parseModuleYaml(moduleDir);
+        expect(result.ok).toBe(false);
+        if (result.ok)
+            return;
+        expect(result.error.startsWith('module.yaml parse error')).toBe(true);
+        expect(result.filePath).toBe(path.join(moduleDir, 'module.yaml'));
+    });
+});
+//# sourceMappingURL=module-yaml-parser.test.js.map

package/packages/server/dist/parsers/module-yaml-parser.test.js.map

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

package/packages/server/dist/parsers/skill-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-parser.d.ts","sourceRoot":"","sources":["../../src/parsers/skill-parser.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAEhD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAErD,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAmBhF"}
+{"version":3,"file":"skill-parser.d.ts","sourceRoot":"","sources":["../../src/parsers/skill-parser.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAEhD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAuBrD,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CA0ChF"}

package/packages/server/dist/parsers/skill-parser.js

@@ -1,12 +1,49 @@
+import fs from 'node:fs';
+import path from 'node:path';
 import matter from 'gray-matter';
+import yaml from 'js-yaml';
+function readSiblingManifest(skillFilePath) {
+    const dir = path.dirname(skillFilePath);
+    const manifestPath = path.join(dir, 'bmad-skill-manifest.yaml');
+    if (!fs.existsSync(manifestPath))
+        return null;
+    try {
+        const content = fs.readFileSync(manifestPath, 'utf-8');
+        return yaml.load(content);
+    }
+    catch {
+        return null;
+    }
+}
 export function parseSkill(filePath, content) {
     try {
         const { data: frontmatter, content: body } = matter(content);
+        let id = frontmatter.name || '';
+        let name = frontmatter.name || '';
+        let description = frontmatter.description || '';
+        let bestFor = frontmatter.best_for;
+        // Fall back to sibling manifest when frontmatter is missing or has no name
+        if (!name) {
+            const manifest = readSiblingManifest(filePath);
+            if (manifest?.skill) {
+                id = manifest.skill.canonicalId || manifest.skill.name || '';
+                name = manifest.skill.name || '';
+                description = manifest.skill.description || '';
+            }
+            if (!bestFor && manifest?.topics) {
+                bestFor = manifest.topics;
+            }
+            // Last resort: derive name from directory
+            if (!name) {
+                name = path.basename(path.dirname(filePath));
+                id = id || name;
+            }
+        }
         const skill = {
-            id: frontmatter.name || '',
-            name: frontmatter.name || '',
-            description: frontmatter.description || '',
-            bestFor: frontmatter.best_for,
+            id,
+            name,
+            description,
+            bestFor,
             content: body.trim(),
             filePath,
             module: undefined,

package/packages/server/dist/parsers/skill-parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-parser.js","sourceRoot":"","sources":["../../src/parsers/skill-parser.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAA;AAMhC,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,OAAe;IAC1D,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;QAE5D,MAAM,KAAK,GAAU;YACnB,EAAE,EAAG,WAAW,CAAC,IAAe,IAAI,EAAE;YACtC,IAAI,EAAG,WAAW,CAAC,IAAe,IAAI,EAAE;YACxC,WAAW,EAAG,WAAW,CAAC,WAAsB,IAAI,EAAE;YACtD,OAAO,EAAE,WAAW,CAAC,QAAgC;YACrD,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE;YACpB,QAAQ;YACR,MAAM,EAAE,SAAS;SAClB,CAAA;QAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;IAClC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAChE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,sBAAsB,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAA;IACxE,CAAC;AACH,CAAC"}
+{"version":3,"file":"skill-parser.js","sourceRoot":"","sources":["../../src/parsers/skill-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,MAAM,MAAM,aAAa,CAAA;AAChC,OAAO,IAAI,MAAM,SAAS,CAAA;AAe1B,SAAS,mBAAmB,CAAC,aAAqB;IAChD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAA;IACvC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,0BAA0B,CAAC,CAAA;IAC/D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAA;IAC7C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;QACtD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAkB,CAAA;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,OAAe;IAC1D,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;QAE5D,IAAI,EAAE,GAAI,WAAW,CAAC,IAAe,IAAI,EAAE,CAAA;QAC3C,IAAI,IAAI,GAAI,WAAW,CAAC,IAAe,IAAI,EAAE,CAAA;QAC7C,IAAI,WAAW,GAAI,WAAW,CAAC,WAAsB,IAAI,EAAE,CAAA;QAC3D,IAAI,OAAO,GAAG,WAAW,CAAC,QAAgC,CAAA;QAE1D,2EAA2E;QAC3E,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,QAAQ,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAA;YAC9C,IAAI,QAAQ,EAAE,KAAK,EAAE,CAAC;gBACpB,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,WAAW,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAA;gBAC5D,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAA;gBAChC,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAA;YAChD,CAAC;YACD,IAAI,CAAC,OAAO,IAAI,QAAQ,EAAE,MAAM,EAAE,CAAC;gBACjC,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAA;YAC3B,CAAC;YACD,0CAA0C;YAC1C,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAA;gBAC5C,EAAE,GAAG,EAAE,IAAI,IAAI,CAAA;YACjB,CAAC;QACH,CAAC;QAED,MAAM,KAAK,GAAU;YACnB,EAAE;YACF,IAAI;YACJ,WAAW;YACX,OAAO;YACP,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE;YACpB,QAAQ;YACR,MAAM,EAAE,SAAS;SAClB,CAAA;QAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;IAClC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAChE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,sBAAsB,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAA;IACxE,CAAC;AACH,CAAC"}

package/packages/server/dist/parsers/skill-parser.test.js

@@ -36,11 +36,12 @@ Content here.
             expect(result.data.bestFor).toEqual(['pm', 'analyst']);
         }
     });
-    it('handles missing frontmatter gracefully', () => {
-        const result = parseSkill('plain.md', 'Just plain markdown without frontmatter.');
+    it('handles missing frontmatter by falling back to directory name', () => {
+        const result = parseSkill('/projects/test/_bmad/core/skills/my-skill/SKILL.md', 'Just plain markdown without frontmatter.');
         expect(result.ok).toBe(true);
         if (result.ok) {
-            expect(result.data.id).toBe('');
+            expect(result.data.id).toBe('my-skill');
+            expect(result.data.name).toBe('my-skill');
             expect(result.data.content).toBe('Just plain markdown without frontmatter.');
         }
     });

package/packages/server/dist/parsers/skill-parser.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-parser.test.js","sourceRoot":"","sources":["../../src/parsers/skill-parser.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,OAAO,GAAG;;;;;;CAMnB,CAAA;QACG,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;QAC9C,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC5B,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACd,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;YAC9C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;YAChD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAA;YAClE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAA;YAC7E,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QAC/C,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,OAAO,GAAG;;;;;;;;;CASnB,CAAA;QACG,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;QAC7C,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC5B,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACd,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAA;QACxD,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,EAAE,0CAA0C,CAAC,CAAA;QACjF,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC5B,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACd,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAC/B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAA;QAC9E,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}
+{"version":3,"file":"skill-parser.test.js","sourceRoot":"","sources":["../../src/parsers/skill-parser.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,OAAO,GAAG;;;;;;CAMnB,CAAA;QACG,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;QAC9C,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC5B,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACd,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;YAC9C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;YAChD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAA;YAClE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAA;YAC7E,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QAC/C,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,OAAO,GAAG;;;;;;;;;CASnB,CAAA;QACG,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;QAC7C,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC5B,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACd,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAA;QACxD,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,MAAM,GAAG,UAAU,CAAC,oDAAoD,EAAE,0CAA0C,CAAC,CAAA;QAC3H,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC5B,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACd,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;YACvC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;YACzC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAA;QAC9E,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/packages/server/dist/plugins/agents-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents-plugin.d.ts","sourceRoot":"","sources":["../../src/plugins/agents-plugin.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAqB9C,wBAAsB,YAAY,CAAC,GAAG,EAAE,eAAe,iBA4ItD"}
+{"version":3,"file":"agents-plugin.d.ts","sourceRoot":"","sources":["../../src/plugins/agents-plugin.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAqB9C,wBAAsB,YAAY,CAAC,GAAG,EAAE,eAAe,iBAmJtD"}

package/packages/server/dist/plugins/agents-plugin.js

@@ -107,7 +107,15 @@ export async function agentsPlugin(app) {
         const skillsYaml = skills.map((s) => `  - ${s}`).join('\n');
         const skillsPattern = /^(skills:\s*\n)((?:\s+-\s+.+\n)*)/m;
         if (skillsPattern.test(source)) {
-            source = source.replace(skillsPattern, `$1${skillsYaml}\n`);
+            source = source.replace(skillsPattern, `$1${skillsYaml ? skillsYaml + '\n' : ''}`);
+        }
+        else {
+            // No skills: block in frontmatter — insert before the closing ---
+            const closingFm = source.indexOf('\n---');
+            if (closingFm !== -1) {
+                const block = skillsYaml ? `\nskills:\n${skillsYaml}` : `\nskills:`;
+                source = source.slice(0, closingFm) + block + source.slice(closingFm);
+            }
         }
         app.fileStore.markPendingWrite(agent.filePath);
         const result = writeFile(agent.filePath, source, app.fileStore.studioDir);