bmad-studio 0.2.0 → 1.1.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/write-service.d.ts

@@ -1,3 +1,5 @@
+export declare const TEXT_FILE_EXTENSIONS: ReadonlySet<string>;
+export declare function isLikelyText(filePath: string): boolean;
 export type WriteResult = {
     ok: true;
     filePath: string;
@@ -8,5 +10,23 @@ export type WriteResult = {
     filePath: string;
 };
 export declare function writeFile(filePath: string, content: string, studioDir: string): WriteResult;
+/**
+ * Delete a single file. Snapshots TEXT content to history/ before unlink.
+ * Binary files (per `isLikelyText`) are unlinked directly without a snapshot —
+ * recovery for binary content is "re-install the module" per TD-16.
+ *
+ * Returns `{ ok: false }` (does NOT throw) on missing paths so callers can
+ * handle absence gracefully.
+ */
+export declare function deleteFile(filePath: string, studioDir: string): WriteResult;
+/**
+ * Recursively delete a directory. Walks the tree, deletes each file via
+ * `deleteFile` (which snapshots text files), then unlinks the (now-empty)
+ * directory tree.
+ *
+ * On partial failure mid-walk, the directory is left in its current state —
+ * some files deleted, some not. The caller decides whether to retry.
+ */
+export declare function deleteDirectory(dirPath: 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

@@ -1 +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"}
+{"version":3,"file":"write-service.d.ts","sourceRoot":"","sources":["../../src/core/write-service.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAyBnD,CAAA;AAEF,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEtD;AAmBD,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;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,CAwB3E;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,CA8B/E;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAItD"}

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

@@ -1,6 +1,45 @@
 import fs from 'node:fs';
 import path from 'node:path';
-const HISTORY_CAP = 50;
+// Sized for module-scale operations (one install can write 60+ files).
+// Average snapshot ~5KB → ~2.5MB max disk budget. Raised from 50 in Story 15.7
+// (TD-17) so module installs/removes don't prune themselves mid-operation.
+const HISTORY_CAP = 500;
+// Files with these extensions are routed through WriteService snapshots
+// (text content). Binary files bypass snapshots — recovery for binaries is
+// "re-install the module" per TD-16.
+//
+// CONSERVATIVE list — false positives (treating binary as text) corrupt the
+// file via utf-8 round-trip; false negatives (text as binary) just skip the
+// snapshot. When in doubt, leave OFF the list.
+export const TEXT_FILE_EXTENSIONS = new Set([
+    '.md',
+    '.markdown',
+    '.yaml',
+    '.yml',
+    '.json',
+    '.csv',
+    '.txt',
+    '.ts',
+    '.tsx',
+    '.js',
+    '.jsx',
+    '.mjs',
+    '.cjs',
+    '.html',
+    '.htm',
+    '.css',
+    '.scss',
+    '.toml',
+    '.xml',
+    '.svg',
+    '.sh',
+    '.bash',
+    '.zsh',
+    '.fish',
+]);
+export function isLikelyText(filePath) {
+    return TEXT_FILE_EXTENSIONS.has(path.extname(filePath).toLowerCase());
+}
 function ensureDir(dir) {
     if (!fs.existsSync(dir)) {
         fs.mkdirSync(dir, { recursive: true });
@@ -52,6 +91,79 @@ export function writeFile(filePath, content, studioDir) {
         return { ok: false, error: `Write failed: ${message}`, filePath };
     }
 }
+/**
+ * Delete a single file. Snapshots TEXT content to history/ before unlink.
+ * Binary files (per `isLikelyText`) are unlinked directly without a snapshot —
+ * recovery for binary content is "re-install the module" per TD-16.
+ *
+ * Returns `{ ok: false }` (does NOT throw) on missing paths so callers can
+ * handle absence gracefully.
+ */
+export function deleteFile(filePath, studioDir) {
+    const historyDir = path.join(studioDir, 'history');
+    try {
+        if (!fs.existsSync(filePath)) {
+            return { ok: false, error: 'File does not exist', filePath };
+        }
+        let snapshotPath = null;
+        if (isLikelyText(filePath)) {
+            const previousContent = fs.readFileSync(filePath, 'utf-8');
+            ensureDir(historyDir);
+            const timestamp = Date.now();
+            const basename = path.basename(filePath);
+            snapshotPath = path.join(historyDir, `${timestamp}-${basename}`);
+            fs.writeFileSync(snapshotPath, previousContent, 'utf-8');
+        }
+        fs.unlinkSync(filePath);
+        pruneHistory(historyDir);
+        return { ok: true, filePath, snapshotPath };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { ok: false, error: `Delete failed: ${message}`, filePath };
+    }
+}
+/**
+ * Recursively delete a directory. Walks the tree, deletes each file via
+ * `deleteFile` (which snapshots text files), then unlinks the (now-empty)
+ * directory tree.
+ *
+ * On partial failure mid-walk, the directory is left in its current state —
+ * some files deleted, some not. The caller decides whether to retry.
+ */
+export function deleteDirectory(dirPath, studioDir) {
+    try {
+        if (!fs.existsSync(dirPath)) {
+            return { ok: false, error: 'Directory does not exist', filePath: dirPath };
+        }
+        const walk = (dir) => {
+            for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+                const full = path.join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    walk(full);
+                }
+                else if (entry.isSymbolicLink()) {
+                    // Symlinks (dangling or otherwise) are unlinked directly — no content to snapshot.
+                    // fs.existsSync follows symlinks, so a dangling symlink would fool deleteFile into
+                    // returning { ok: false, 'File does not exist' } and aborting the entire walk.
+                    fs.unlinkSync(full);
+                }
+                else {
+                    const result = deleteFile(full, studioDir);
+                    if (!result.ok)
+                        throw new Error(result.error);
+                }
+            }
+        };
+        walk(dirPath);
+        fs.rmSync(dirPath, { recursive: true, force: true });
+        return { ok: true, filePath: dirPath, snapshotPath: null };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { ok: false, error: `Directory delete failed: ${message}`, filePath: dirPath };
+    }
+}
 export function getHistory(studioDir) {
     const historyDir = path.join(studioDir, 'history');
     if (!fs.existsSync(historyDir))

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

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