bmad-studio 0.2.0 → 1.1.0

package/packages/server/dist/core/ide-skill-generator.test.js

@@ -0,0 +1,257 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { generateIdeSkillsForModule, removeIdeSkillsForModule, } from './ide-skill-generator.js';
+// Minimal FileStore stub — the generator only uses studioDir + the watcher hooks.
+function makeStubFileStore(studioDir) {
+    return {
+        studioDir,
+        markPendingWrite: () => { },
+        clearPendingWrite: () => { },
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    };
+}
+function makeManifest(ides) {
+    return {
+        installation: {
+            version: '6.2.0',
+            installDate: '2026-01-01T00:00:00.000Z',
+            lastUpdated: '2026-01-01T00:00:00.000Z',
+        },
+        modules: [],
+        ides,
+    };
+}
+describe('generateIdeSkillsForModule', () => {
+    let tmpDir;
+    let studioDir;
+    let fileStore;
+    beforeEach(() => {
+        tmpDir = fs.realpathSync(fs.mkdtempSync(path.join(os.tmpdir(), 'ide-skill-gen-')));
+        studioDir = path.join(tmpDir, '.bmad-studio');
+        fs.mkdirSync(studioDir, { recursive: true });
+        fileStore = makeStubFileStore(studioDir);
+        // Build a fixture module with one agent + one workflow + one task
+        const moduleDir = path.join(tmpDir, '_bmad', 'test-mod');
+        fs.mkdirSync(path.join(moduleDir, 'agents'), { recursive: true });
+        fs.mkdirSync(path.join(moduleDir, 'workflows', 'create-foo'), { recursive: true });
+        fs.mkdirSync(path.join(moduleDir, 'tasks', 'preflight'), { recursive: true });
+        fs.writeFileSync(path.join(moduleDir, 'agents', 'architect.md'), [
+            '<agent id="architect" name="architect" title="Test Architect" capabilities="design">',
+            '  <persona>',
+            '    <identity>I design systems</identity>',
+            '  </persona>',
+            '</agent>',
+        ].join('\n'));
+        fs.writeFileSync(path.join(moduleDir, 'workflows', 'create-foo', 'workflow.md'), '---\nname: create-foo\n---\n# Create Foo\n\n**Goal:** Creates a foo\n');
+        fs.writeFileSync(path.join(moduleDir, 'tasks', 'preflight', 'task.md'), '---\nname: preflight\n---\n# Preflight\n');
+    });
+    afterEach(() => {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+    // ─── AC-15.6.1 ───
+    it('AC-15.6.1: generates SKILL.md files for agents and workflows under .claude/skills/', () => {
+        const result = generateIdeSkillsForModule(tmpDir, 'test-mod', makeManifest(['claude-code']), studioDir, fileStore);
+        expect(result.ok).toBe(true);
+        if (!result.ok)
+            return;
+        const agentSkill = path.join(tmpDir, '.claude/skills/bmad-agent-test-mod-architect/SKILL.md');
+        const workflowSkill = path.join(tmpDir, '.claude/skills/bmad-test-mod-create-foo/SKILL.md');
+        const taskSkill = path.join(tmpDir, '.claude/skills/bmad-test-mod-preflight/SKILL.md');
+        expect(fs.existsSync(agentSkill)).toBe(true);
+        expect(fs.existsSync(workflowSkill)).toBe(true);
+        expect(fs.existsSync(taskSkill)).toBe(true);
+        // Per-IDE counts
+        expect(result.skillsByIde['claude-code']).toHaveLength(3);
+    });
+    // ─── AC-15.6.2 ───
+    it('AC-15.6.2: generates files under both .claude/skills/ and .antigravity/skills/', () => {
+        const result = generateIdeSkillsForModule(tmpDir, 'test-mod', makeManifest(['claude-code', 'antigravity']), studioDir, fileStore);
+        expect(result.ok).toBe(true);
+        if (!result.ok)
+            return;
+        expect(fs.existsSync(path.join(tmpDir, '.claude/skills/bmad-agent-test-mod-architect/SKILL.md'))).toBe(true);
+        expect(fs.existsSync(path.join(tmpDir, '.antigravity/skills/bmad-agent-test-mod-architect/SKILL.md'))).toBe(true);
+        expect(result.skillsByIde['claude-code']).toHaveLength(3);
+        expect(result.skillsByIde.antigravity).toHaveLength(3);
+    });
+    // ─── AC-15.6.3 ───
+    it('AC-15.6.3: agent description is extracted via parseAgent (XML title)', () => {
+        const result = generateIdeSkillsForModule(tmpDir, 'test-mod', makeManifest(['claude-code']), studioDir, fileStore);
+        expect(result.ok).toBe(true);
+        const skillContent = fs.readFileSync(path.join(tmpDir, '.claude/skills/bmad-agent-test-mod-architect/SKILL.md'), 'utf-8');
+        expect(skillContent).toContain('description: "Test Architect"');
+    });
+    // ─── AC-15.6.4 ───
+    it('AC-15.6.4: agent without a description falls back to "BMAD <name> agent from <module>"', () => {
+        // Replace the architect file with one that has no <agent> block
+        fs.writeFileSync(path.join(tmpDir, '_bmad', 'test-mod', 'agents', 'plain.md'), '# Just a plain agent\n');
+        // Remove the original architect to keep things clean
+        fs.unlinkSync(path.join(tmpDir, '_bmad', 'test-mod', 'agents', 'architect.md'));
+        const result = generateIdeSkillsForModule(tmpDir, 'test-mod', makeManifest(['claude-code']), studioDir, fileStore);
+        expect(result.ok).toBe(true);
+        const skillContent = fs.readFileSync(path.join(tmpDir, '.claude/skills/bmad-agent-test-mod-plain/SKILL.md'), 'utf-8');
+        expect(skillContent).toContain('description: "BMAD plain agent from test-mod"');
+    });
+    // ─── AC-15.6.5 ───
+    it('AC-15.6.5: SKILL.md body contains an absolute path to the source file', () => {
+        generateIdeSkillsForModule(tmpDir, 'test-mod', makeManifest(['claude-code']), studioDir, fileStore);
+        const skillContent = fs.readFileSync(path.join(tmpDir, '.claude/skills/bmad-agent-test-mod-architect/SKILL.md'), 'utf-8');
+        // The body should contain an absolute path (starts with / on Unix)
+        expect(skillContent).toContain(path.join(tmpDir, '_bmad', 'test-mod', 'agents', 'architect.md'));
+        // And the path is absolute
+        expect(skillContent).toMatch(/^\/.*architect\.md$/m);
+    });
+    // ─── AC-15.6.6 ───
+    it('AC-15.6.6: calling generator twice produces byte-identical files', () => {
+        const result1 = generateIdeSkillsForModule(tmpDir, 'test-mod', makeManifest(['claude-code']), studioDir, fileStore);
+        expect(result1.ok).toBe(true);
+        const skillPath = path.join(tmpDir, '.claude/skills/bmad-agent-test-mod-architect/SKILL.md');
+        const firstContent = fs.readFileSync(skillPath, 'utf-8');
+        // Snapshot history count BEFORE the second call
+        const historyDir = path.join(studioDir, 'history');
+        const historyBefore = fs.existsSync(historyDir) ? fs.readdirSync(historyDir).length : 0;
+        const result2 = generateIdeSkillsForModule(tmpDir, 'test-mod', makeManifest(['claude-code']), studioDir, fileStore);
+        expect(result2.ok).toBe(true);
+        const secondContent = fs.readFileSync(skillPath, 'utf-8');
+        expect(secondContent).toBe(firstContent);
+        // The idempotent early-exit means no new history entries on the second call
+        const historyAfter = fs.existsSync(historyDir) ? fs.readdirSync(historyDir).length : 0;
+        expect(historyAfter).toBe(historyBefore);
+    });
+    // ─── AC-15.6.7 ───
+    it('AC-15.6.7: unknown IDEs are silently filtered (cursor)', () => {
+        const result = generateIdeSkillsForModule(tmpDir, 'test-mod', makeManifest(['claude-code', 'cursor', 'antigravity']), studioDir, fileStore);
+        expect(result.ok).toBe(true);
+        if (!result.ok)
+            return;
+        // Both supported IDEs got launchers
+        expect(result.skillsByIde['claude-code']).toHaveLength(3);
+        expect(result.skillsByIde.antigravity).toHaveLength(3);
+        // The unknown IDE was silently dropped
+        expect(result.skillsByIde.cursor).toBeUndefined();
+        expect(fs.existsSync(path.join(tmpDir, '.cursor', 'skills'))).toBe(false);
+    });
+    // ─── AC-15.6.9 ───
+    it('AC-15.6.9: empty manifest.ides[] is a no-op', () => {
+        const result = generateIdeSkillsForModule(tmpDir, 'test-mod', makeManifest([]), studioDir, fileStore);
+        expect(result).toEqual({ ok: true, skillsByIde: {} });
+        expect(fs.existsSync(path.join(tmpDir, '.claude'))).toBe(false);
+        expect(fs.existsSync(path.join(tmpDir, '.antigravity'))).toBe(false);
+    });
+    // ─── AC-15.6.9 (b) ───
+    it('AC-15.6.9 (b): missing manifest.ides field is a no-op', () => {
+        const manifestNoIdes = {
+            installation: {
+                version: '6.2.0',
+                installDate: '2026-01-01',
+                lastUpdated: '2026-01-01',
+            },
+            modules: [],
+            // ides field intentionally omitted
+        };
+        const result = generateIdeSkillsForModule(tmpDir, 'test-mod', manifestNoIdes, studioDir, fileStore);
+        expect(result).toEqual({ ok: true, skillsByIde: {} });
+    });
+    // ─── workflow description extraction (AC-15.6.3 supporting case) ───
+    it('extracts workflow description via parseWorkflow', () => {
+        generateIdeSkillsForModule(tmpDir, 'test-mod', makeManifest(['claude-code']), studioDir, fileStore);
+        const skillContent = fs.readFileSync(path.join(tmpDir, '.claude/skills/bmad-test-mod-create-foo/SKILL.md'), 'utf-8');
+        // The fixture workflow has `description: Creates a foo` in the frontmatter
+        expect(skillContent).toContain('Creates a foo');
+    });
+    // ─── module with no entities is a no-op for that IDE ───
+    it('module with no agents/workflows/tasks generates an empty list per IDE', () => {
+        // Create an empty module
+        const emptyModuleDir = path.join(tmpDir, '_bmad', 'empty-mod');
+        fs.mkdirSync(emptyModuleDir, { recursive: true });
+        const result = generateIdeSkillsForModule(tmpDir, 'empty-mod', makeManifest(['claude-code']), studioDir, fileStore);
+        expect(result.ok).toBe(true);
+        if (!result.ok)
+            return;
+        expect(result.skillsByIde['claude-code']).toEqual([]);
+        // The output dir is created but is empty (no SKILL.md files written)
+        expect(fs.existsSync(path.join(tmpDir, '.claude/skills'))).toBe(true);
+    });
+});
+// ─────────────────────────────────────────────────────────────────────────────
+// removeIdeSkillsForModule — Story 15.7
+// ─────────────────────────────────────────────────────────────────────────────
+describe('removeIdeSkillsForModule', () => {
+    let tmpDir;
+    let studioDir;
+    let fileStore;
+    beforeEach(() => {
+        tmpDir = fs.realpathSync(fs.mkdtempSync(path.join(os.tmpdir(), 'ide-skill-remove-')));
+        studioDir = path.join(tmpDir, '.bmad-studio');
+        fs.mkdirSync(studioDir, { recursive: true });
+        fileStore = makeStubFileStore(studioDir);
+    });
+    afterEach(() => {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+    // ─── AC-15.7.3a ───
+    it('AC-15.7.3a: removes only prefix-matched directories, leaves others alone', () => {
+        // First, generate skills for two modules using generateIdeSkillsForModule so the
+        // fixture matches real usage.
+        const setupModule = (code) => {
+            const moduleDir = path.join(tmpDir, '_bmad', code);
+            fs.mkdirSync(path.join(moduleDir, 'agents'), { recursive: true });
+            fs.writeFileSync(path.join(moduleDir, 'agents', 'a.md'), `<agent id="a" name="a" title="${code} agent" capabilities="work"></agent>\n`);
+        };
+        setupModule('foo');
+        setupModule('bar');
+        generateIdeSkillsForModule(tmpDir, 'foo', makeManifest(['claude-code']), studioDir, fileStore);
+        generateIdeSkillsForModule(tmpDir, 'bar', makeManifest(['claude-code']), studioDir, fileStore);
+        // Both dirs exist before removal
+        expect(fs.existsSync(path.join(tmpDir, '.claude/skills/bmad-agent-foo-a'))).toBe(true);
+        expect(fs.existsSync(path.join(tmpDir, '.claude/skills/bmad-agent-bar-a'))).toBe(true);
+        // Remove foo — only foo's dirs should go
+        const result = removeIdeSkillsForModule(tmpDir, 'foo', makeManifest(['claude-code']), studioDir);
+        expect(result.ok).toBe(true);
+        if (!result.ok)
+            return;
+        expect(result.removedByIde['claude-code']).toEqual(['bmad-agent-foo-a']);
+        // foo removed, bar untouched
+        expect(fs.existsSync(path.join(tmpDir, '.claude/skills/bmad-agent-foo-a'))).toBe(false);
+        expect(fs.existsSync(path.join(tmpDir, '.claude/skills/bmad-agent-bar-a'))).toBe(true);
+    });
+    // ─── AC-15.7.3b ───
+    it('AC-15.7.3b: missing IDE dir returns empty list, no error', () => {
+        const result = removeIdeSkillsForModule(tmpDir, 'never-installed', makeManifest(['claude-code', 'antigravity']), studioDir);
+        expect(result.ok).toBe(true);
+        if (!result.ok)
+            return;
+        expect(result.removedByIde).toEqual({
+            'claude-code': [],
+            antigravity: [],
+        });
+    });
+    // ─── AC-15.7.3c ───
+    it('AC-15.7.3c: removed files are recoverable from .bmad-studio/history/', () => {
+        // Install a module
+        const moduleDir = path.join(tmpDir, '_bmad', 'recover-test');
+        fs.mkdirSync(path.join(moduleDir, 'agents'), { recursive: true });
+        fs.writeFileSync(path.join(moduleDir, 'agents', 'helper.md'), '<agent id="helper" name="helper" title="Helper" capabilities="help"></agent>\n');
+        generateIdeSkillsForModule(tmpDir, 'recover-test', makeManifest(['claude-code']), studioDir, fileStore);
+        // Remove
+        const result = removeIdeSkillsForModule(tmpDir, 'recover-test', makeManifest(['claude-code']), studioDir);
+        expect(result.ok).toBe(true);
+        // SKILL.md from the removed dir should have a snapshot in .bmad-studio/history/
+        const historyDir = path.join(studioDir, 'history');
+        expect(fs.existsSync(historyDir)).toBe(true);
+        const history = fs.readdirSync(historyDir);
+        expect(history.some((n) => n.endsWith('SKILL.md'))).toBe(true);
+    });
+    // Ignores unknown IDEs (parallel to AC-15.6.7)
+    it('ignores unknown IDE entries when scanning for removal', () => {
+        const result = removeIdeSkillsForModule(tmpDir, 'whatever', makeManifest(['claude-code', 'cursor']), studioDir);
+        expect(result.ok).toBe(true);
+        if (!result.ok)
+            return;
+        expect(result.removedByIde['claude-code']).toEqual([]);
+        expect(result.removedByIde.cursor).toBeUndefined();
+    });
+});
+//# sourceMappingURL=ide-skill-generator.test.js.map

package/packages/server/dist/core/ide-skill-generator.test.js.map

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

package/packages/server/dist/core/module-installer.d.ts

@@ -0,0 +1,165 @@
+import type { ModuleManifestFile } from '@bmad-studio/shared';
+import type { EntityIndex } from '../parsers/index-builder.js';
+import type { FileStore } from './file-store.js';
+export { TEXT_FILE_EXTENSIONS, isLikelyText } from './write-service.js';
+export type CopyDirResult = {
+    ok: true;
+    textCount: number;
+    binaryCount: number;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Walk a source directory and copy every file into a destination.
+ *
+ * Text files (per TEXT_FILE_EXTENSIONS) are routed through WriteService so snapshots are written.
+ * Binary files are copied via fs.copyFileSync — no snapshot, no corruption (see TD-16).
+ *
+ * Replaces the legacy fs.copyFileSync-based copyDirRecursive helper that lived in modules-plugin.ts.
+ */
+export declare function copyDirThroughWriteService(src: string, dest: string, studioDir: string, fileStore: FileStore): CopyDirResult;
+/**
+ * Read manifest.yaml; null-safe for missing files.
+ */
+export declare function readManifestSafe(manifestPath: string): ModuleManifestFile | null;
+/**
+ * Write manifest.yaml through WriteService so changes are snapshot.
+ */
+export declare function writeManifestThroughWriteService(manifestPath: string, manifest: ModuleManifestFile, studioDir: string, fileStore: FileStore): {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Verify a local path looks like a module — has a module.yaml OR contains at least
+ * one of the standard entity directories.
+ */
+export declare function isPlausibleModuleDir(dir: string): boolean;
+export type GithubSource = {
+    owner: string;
+    repo: string;
+    subpath: string | null;
+    branch: string | null;
+};
+/**
+ * Lenient parser for GitHub source strings. Accepts any of:
+ *   owner/repo
+ *   owner/repo/subpath
+ *   owner/repo/nested/subpath
+ *   owner/repo@branch
+ *   owner/repo/subpath@branch
+ *   https://github.com/owner/repo
+ *   https://github.com/owner/repo/tree/branch
+ *   https://github.com/owner/repo/tree/branch/subpath
+ *
+ * Throws plain Error on invalid input — the install handler is responsible for
+ * catching and converting to ValidationError.
+ */
+export declare function parseGithubSource(input: string): GithubSource;
+export type DownloadedTarball = {
+    extractedRoot: string;
+    tmpDir: string;
+    resolvedBranch: string;
+};
+/**
+ * Download a GitHub repo tarball into a temp dir, extract, and return the
+ * extracted root path along with the branch that was actually used.
+ *
+ * Tries `main` first then `master` if no branch is given (per Q5). Honours
+ * GITHUB_TOKEN / BMAD_GITHUB_TOKEN env vars for private repos. Throws
+ * immediately on 401/403 (token errors don't fix themselves on `master`).
+ *
+ * The caller is responsible for cleaning up `tmpDir` after consuming
+ * `extractedRoot` (typically in a `try { ... } finally { fs.rmSync(tmpDir) }`).
+ */
+export declare function downloadGithubTarball(source: GithubSource): Promise<DownloadedTarball>;
+export type ExtractedZip = {
+    extractedRoot: string;
+    tmpDir: string;
+};
+/**
+ * Extract a multipart-uploaded zip into a temp dir and return the module root.
+ *
+ * `adm-zip` is loaded via dynamic import (TD-5) so users who never upload a zip
+ * pay zero startup cost. The first call pays the ~10ms parse, subsequent calls
+ * hit the Node.js module cache for free.
+ *
+ * Includes inline zip-slip mitigation (finding #22): every entry in the zip is
+ * checked to ensure its resolved path stays inside extractDir BEFORE extraction.
+ * The entire upload is rejected on any escape attempt, and no file is written
+ * to disk.
+ *
+ * If the zip's top-level contains exactly one directory, that directory is
+ * returned as `extractedRoot` (the "wrapper dir" case — most zip exports include
+ * one). Otherwise the extract dir itself is returned.
+ *
+ * The caller is responsible for cleaning up `tmpDir` after consuming
+ * `extractedRoot` (typically in a `try { ... } finally { fs.rmSync(tmpDir) }`).
+ */
+export declare function extractZipUpload(zipBuffer: Buffer): Promise<ExtractedZip>;
+export declare const SUBSTITUTABLE_EXTENSIONS: ReadonlySet<string>;
+export type SubstitutionContext = {
+    moduleCode: string;
+    projectRoot: string;
+    outputFolder: string;
+    variables: Record<string, string>;
+};
+/**
+ * Validate that all variable values are safe to substitute into text/yaml/csv files.
+ * Returns the FIRST violation as an error message naming the offending variable.
+ */
+export declare function validateVariables(variables: Record<string, string>): {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Walk a destination directory and substitute placeholders in files matching
+ * SUBSTITUTABLE_EXTENSIONS. Files without any matching placeholder are left
+ * untouched (no spurious snapshots). Substitution writes go through WriteService.
+ *
+ * Returns the count of files actually patched (a no-placeholder file does not count).
+ */
+export declare function runVariableSubstitution(destDir: string, ctx: SubstitutionContext, studioDir: string, fileStore: FileStore): {
+    ok: true;
+    filesPatched: number;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Read the project's `output_folder` setting from `_bmad/_config/config.yaml`.
+ * Returns `<projectRoot>/_bmad-output` as the default if the file is missing,
+ * malformed, or doesn't declare the field.
+ */
+export declare function readOutputFolder(projectRoot: string): string;
+export type CrossReference = {
+    ownerModule: string;
+    reason: string;
+};
+/**
+ * Scan the FileStore entity index for cross-module references to a target
+ * module's agents. Used by the remove preview endpoint to warn users about
+ * broken references after removal.
+ *
+ * **TD-19 scope (v1):** only scans two signals:
+ *   1. Teams whose `agentIds[]` contains any target-module agent ID
+ *   2. Workflow steps whose `step.agent` matches a target-module agent ID
+ *
+ * **Explicitly NOT scanned in v1:**
+ *   - `agent.menu[].route` — holds a relative file path from the XML `exec=`
+ *     attribute, not a workflow ID. `Set<workflowId>.has(filepath)` always
+ *     returns false, so the check would be dead code.
+ *   - `agent.skills[]` — hardcoded to `[]` in `agent-parser.ts:93`. Dead field.
+ *
+ * Both will be revisited in v2 with proper graph extraction.
+ *
+ * Returns an array of `{ ownerModule, reason }` entries, deduplicated by
+ * owner+reason. The target module itself is never included. Unattributed
+ * entities (edge case) are reported under `"(unattributed)"`.
+ */
+export declare function findCrossReferences(index: EntityIndex, targetModule: string): CrossReference[];
+//# sourceMappingURL=module-installer.d.ts.map

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

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