jamdesk 1.1.39 → 1.1.41

package/dist/__tests__/unit/clean.test.d.ts

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

package/dist/__tests__/unit/clean.test.d.ts.map

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

package/dist/__tests__/unit/clean.test.js

@@ -0,0 +1,59 @@
+/**
+ * @vitest-environment node
+ *
+ * Note: clean() takes both jamdeskDir and projectDir as parameters so we
+ * never have to mock os.homedir() — the production callsite passes
+ * getJamdeskDir() and process.cwd().
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import fs from 'fs-extra';
+import path from 'path';
+import { tmpdir } from 'os';
+import { clean } from '../../commands/clean.js';
+import { computeWorkspaceSlug } from '../../lib/workspace-paths.js';
+describe('clean', () => {
+    let tmpRoot;
+    let jamdeskDir;
+    let cwd;
+    beforeEach(() => {
+        tmpRoot = fs.mkdtempSync(path.join(tmpdir(), 'jam-clean-'));
+        jamdeskDir = path.join(tmpRoot, '.jamdesk');
+        cwd = path.join(tmpRoot, 'my-docs');
+        fs.mkdirpSync(cwd);
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+        fs.removeSync(tmpRoot);
+    });
+    it('default: removes only the current project workspace, leaves siblings', async () => {
+        const mySlug = computeWorkspaceSlug(fs.realpathSync(cwd));
+        fs.mkdirpSync(path.join(jamdeskDir, 'workspaces', mySlug, '.next'));
+        fs.mkdirpSync(path.join(jamdeskDir, 'workspaces', 'other-abc123', '.next'));
+        fs.mkdirpSync(path.join(jamdeskDir, 'node_modules', 'next'));
+        await clean({ all: false }, { jamdeskDir, projectDir: cwd });
+        expect(fs.existsSync(path.join(jamdeskDir, 'workspaces', mySlug))).toBe(false);
+        expect(fs.existsSync(path.join(jamdeskDir, 'workspaces', 'other-abc123'))).toBe(true);
+        expect(fs.existsSync(path.join(jamdeskDir, 'node_modules'))).toBe(true);
+    });
+    it('--all: removes the entire jamdeskDir', async () => {
+        fs.mkdirpSync(path.join(jamdeskDir, 'node_modules'));
+        fs.mkdirpSync(path.join(jamdeskDir, 'workspaces', 'a-1'));
+        await clean({ all: true }, { jamdeskDir, projectDir: cwd });
+        expect(fs.existsSync(jamdeskDir)).toBe(false);
+    });
+    it('--all: no-op when jamdeskDir does not exist', async () => {
+        await expect(clean({ all: true }, { jamdeskDir, projectDir: cwd }))
+            .resolves.toBeUndefined();
+        expect(fs.existsSync(jamdeskDir)).toBe(false);
+    });
+    it('default: no-op when current workspace does not exist', async () => {
+        await expect(clean({ all: false }, { jamdeskDir, projectDir: cwd }))
+            .resolves.toBeUndefined();
+    });
+    it('default: ENOENT projectDir falls back to path.resolve, no crash', async () => {
+        const ghost = path.join(tmpRoot, 'never-existed');
+        await expect(clean({ all: false }, { jamdeskDir, projectDir: ghost }))
+            .resolves.toBeUndefined();
+    });
+});
+//# sourceMappingURL=clean.test.js.map

package/dist/__tests__/unit/clean.test.js.map

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

package/dist/__tests__/unit/dev-cache-cleanup.test.d.ts

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

package/dist/__tests__/unit/dev-cache-cleanup.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-cache-cleanup.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/dev-cache-cleanup.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/unit/dev-cache-cleanup.test.js

@@ -0,0 +1,74 @@
+/**
+ * @vitest-environment node
+ *
+ * Unit tests for `safeRemoveCache` in `src/lib/safe-fs.ts`.
+ *
+ * Regression: previously the dev command crashed with an unhandled
+ * `ENOTEMPTY: directory not empty, rmdir '.../turbopack'` rejection when
+ * a concurrent `next dev` instance held files in the workspace cache
+ * during a CLI version bump. The handler must surface a clear message
+ * and `process.exit(1)` instead of stack-trace-crashing.
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import fs from 'fs-extra';
+import { safeRemoveCache } from '../../lib/safe-fs.js';
+import { output } from '../../lib/output.js';
+describe('safeRemoveCache', () => {
+    let exitSpy;
+    let errorSpy;
+    let rmSpy;
+    const lastErrorMsg = () => errorSpy.mock.calls[0]?.[0] ?? '';
+    beforeEach(() => {
+        exitSpy = vi.spyOn(process, 'exit').mockImplementation(((code) => {
+            throw new Error(`process.exit:${code}`);
+        }));
+        errorSpy = vi.spyOn(output, 'error').mockImplementation(() => undefined);
+        rmSpy = vi.spyOn(fs, 'rm');
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('resolves silently when fs.rm succeeds', async () => {
+        rmSpy.mockResolvedValueOnce(undefined);
+        await expect(safeRemoveCache('/tmp/jam-cache')).resolves.toBeUndefined();
+        expect(errorSpy).not.toHaveBeenCalled();
+        expect(exitSpy).not.toHaveBeenCalled();
+        expect(rmSpy).toHaveBeenCalledWith('/tmp/jam-cache', expect.objectContaining({ recursive: true, force: true, maxRetries: 2 }));
+    });
+    it('exits with friendly message on ENOTEMPTY (concurrent dev session)', async () => {
+        const err = Object.assign(new Error('ENOTEMPTY'), { code: 'ENOTEMPTY' });
+        rmSpy.mockRejectedValueOnce(err);
+        await expect(safeRemoveCache('/tmp/jam-cache')).rejects.toThrow('process.exit:1');
+        const msg = lastErrorMsg();
+        expect(msg).toContain('Could not clear cache');
+        expect(msg).toContain('ENOTEMPTY');
+        expect(msg).toContain('Another `jamdesk dev` instance');
+        expect(msg).toContain('pkill -f');
+        expect(exitSpy).toHaveBeenCalledWith(1);
+    });
+    it.each(['EBUSY', 'EPERM'])('treats %s as a concurrent-dev race (same friendly message)', async (code) => {
+        const err = Object.assign(new Error(code), { code });
+        rmSpy.mockRejectedValueOnce(err);
+        await expect(safeRemoveCache('/tmp/jam-cache')).rejects.toThrow('process.exit:1');
+        expect(lastErrorMsg()).toContain('Another `jamdesk dev` instance');
+        expect(exitSpy).toHaveBeenCalledWith(1);
+    });
+    it('on EACCES surfaces a permissions-specific message (not the pkill fix)', async () => {
+        const err = Object.assign(new Error('EACCES'), { code: 'EACCES' });
+        rmSpy.mockRejectedValueOnce(err);
+        await expect(safeRemoveCache('/tmp/jam-cache')).rejects.toThrow('process.exit:1');
+        const msg = lastErrorMsg();
+        expect(msg).toContain('Permission denied');
+        expect(msg).toContain('chown');
+        expect(msg).not.toContain('pkill');
+        expect(exitSpy).toHaveBeenCalledWith(1);
+    });
+    it('rethrows non-race errors so they surface through normal error handling', async () => {
+        const err = Object.assign(new Error('disk full'), { code: 'ENOSPC' });
+        rmSpy.mockRejectedValueOnce(err);
+        await expect(safeRemoveCache('/tmp/jam-cache')).rejects.toThrow('disk full');
+        expect(errorSpy).not.toHaveBeenCalled();
+        expect(exitSpy).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=dev-cache-cleanup.test.js.map

package/dist/__tests__/unit/dev-cache-cleanup.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-cache-cleanup.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/dev-cache-cleanup.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,IAAI,OAAoC,CAAC;IACzC,IAAI,QAAqC,CAAC;IAC1C,IAAI,KAAkC,CAAC;IAEvC,MAAM,YAAY,GAAG,GAAW,EAAE,CAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAY,IAAI,EAAE,CAAC;IAEjF,UAAU,CAAC,GAAG,EAAE;QACd,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAa,EAAE,EAAE;YACxE,MAAM,IAAI,KAAK,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC;QAC1C,CAAC,CAAU,CAAC,CAAC;QACb,QAAQ,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACzE,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;QACrD,KAAK,CAAC,qBAAqB,CAAC,SAAkB,CAAC,CAAC;QAChD,MAAM,MAAM,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;QACzE,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACxC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACvC,MAAM,CAAC,KAAK,CAAC,CAAC,oBAAoB,CAChC,gBAAgB,EAChB,MAAM,CAAC,gBAAgB,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CACzE,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;QACjF,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QACzE,KAAK,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;QAEjC,MAAM,MAAM,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAElF,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;QAC/C,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,gCAAgC,CAAC,CAAC;QACxD,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAClC,MAAM,CAAC,OAAO,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CACzB,4DAA4D,EAC5D,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,KAAK,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;QAEjC,MAAM,MAAM,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAClF,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,SAAS,CAAC,gCAAgC,CAAC,CAAC;QACnE,MAAM,CAAC,OAAO,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC,CACF,CAAC;IAEF,EAAE,CAAC,uEAAuE,EAAE,KAAK,IAAI,EAAE;QACrF,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnE,KAAK,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;QAEjC,MAAM,MAAM,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAClF,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;QAC3C,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC/B,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACnC,MAAM,CAAC,OAAO,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;QACtF,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QACtE,KAAK,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;QAEjC,MAAM,MAAM,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC7E,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACxC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/unit/dev-lock.test.d.ts

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

package/dist/__tests__/unit/dev-lock.test.d.ts.map

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

package/dist/__tests__/unit/dev-lock.test.js

@@ -0,0 +1,70 @@
+/**
+ * @vitest-environment node
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import fs from 'fs-extra';
+import path from 'path';
+import { tmpdir } from 'os';
+import { acquireDevLock, releaseDevLock } from '../../lib/dev-lock.js';
+describe('dev-lock', () => {
+    let tmpRoot;
+    let workspace;
+    beforeEach(() => {
+        tmpRoot = fs.mkdtempSync(path.join(tmpdir(), 'jam-lock-'));
+        workspace = path.join(tmpRoot, 'ws');
+        fs.mkdirpSync(workspace);
+    });
+    afterEach(() => {
+        fs.removeSync(tmpRoot);
+    });
+    it('acquires a fresh lock when no lockfile exists', () => {
+        const result = acquireDevLock(workspace);
+        expect(result.acquired).toBe(true);
+        expect(result.heldBy).toBe(process.pid);
+        expect(fs.existsSync(path.join(workspace, '.jamdesk-dev.lock'))).toBe(true);
+    });
+    it('refuses when an alive PID holds the lock', () => {
+        fs.writeFileSync(path.join(workspace, '.jamdesk-dev.lock'), String(process.pid));
+        const result = acquireDevLock(workspace);
+        expect(result.acquired).toBe(false);
+        expect(result.heldBy).toBe(process.pid);
+    });
+    it('reclaims a stale lock (PID dead)', () => {
+        // PID 999999 is "almost certainly dead"; verify it's not alive first.
+        const fakeDeadPid = 999999;
+        try {
+            process.kill(fakeDeadPid, 0);
+        }
+        catch {
+            // ESRCH or EPERM both fine — PID is not a target we can signal.
+        }
+        fs.writeFileSync(path.join(workspace, '.jamdesk-dev.lock'), String(fakeDeadPid));
+        const result = acquireDevLock(workspace);
+        expect(result.acquired).toBe(true);
+        expect(result.heldBy).toBe(process.pid);
+    });
+    it('releaseDevLock removes only our own lock, leaves stale ones', () => {
+        fs.writeFileSync(path.join(workspace, '.jamdesk-dev.lock'), String(process.pid));
+        releaseDevLock(workspace);
+        expect(fs.existsSync(path.join(workspace, '.jamdesk-dev.lock'))).toBe(false);
+    });
+    it('release is a no-op if lock is held by another PID', () => {
+        fs.writeFileSync(path.join(workspace, '.jamdesk-dev.lock'), String(process.pid + 1));
+        releaseDevLock(workspace);
+        expect(fs.existsSync(path.join(workspace, '.jamdesk-dev.lock'))).toBe(true);
+    });
+    it('treats a corrupted/non-positive lockfile as stale and reclaims it', () => {
+        fs.writeFileSync(path.join(workspace, '.jamdesk-dev.lock'), 'not-a-pid');
+        let result = acquireDevLock(workspace);
+        expect(result.acquired).toBe(true);
+        expect(result.heldBy).toBe(process.pid);
+        // Also covers: zero PID, negative PID, empty file
+        for (const garbage of ['0', '-1', '']) {
+            fs.writeFileSync(path.join(workspace, '.jamdesk-dev.lock'), garbage);
+            result = acquireDevLock(workspace);
+            expect(result.acquired).toBe(true);
+            expect(result.heldBy).toBe(process.pid);
+        }
+    });
+});
+//# sourceMappingURL=dev-lock.test.js.map

package/dist/__tests__/unit/dev-lock.test.js.map

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

package/dist/__tests__/unit/dev-sync-vendored.test.d.ts

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

package/dist/__tests__/unit/dev-sync-vendored.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-sync-vendored.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/dev-sync-vendored.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/unit/dev-sync-vendored.test.js

@@ -0,0 +1,58 @@
+/**
+ * @vitest-environment node
+ *
+ * Regression: syncVendoredFiles must NOT sweep CLI-managed dotfiles like the
+ * dev lockfile or content-hash. They are written to the workspace root before
+ * this runs, and prior to the fix the walkDest pass deleted them — silently
+ * defeating the concurrent-dev guard.
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import fs from 'fs-extra';
+import path from 'path';
+import { tmpdir } from 'os';
+import { syncVendoredFiles } from '../../commands/dev.js';
+describe('syncVendoredFiles', () => {
+    let tmpRoot;
+    let src;
+    let dest;
+    beforeEach(() => {
+        tmpRoot = fs.mkdtempSync(path.join(tmpdir(), 'jam-sync-'));
+        src = path.join(tmpRoot, 'src');
+        dest = path.join(tmpRoot, 'dest');
+        fs.mkdirpSync(src);
+        fs.mkdirpSync(dest);
+    });
+    afterEach(() => {
+        fs.removeSync(tmpRoot);
+    });
+    it('preserves .jamdesk-dev.lock and .content-hash in dest', async () => {
+        fs.writeFileSync(path.join(src, 'package.json'), '{"name":"vendored"}');
+        fs.writeFileSync(path.join(dest, '.jamdesk-dev.lock'), String(process.pid));
+        fs.writeFileSync(path.join(dest, '.content-hash'), 'abc123');
+        await syncVendoredFiles(src, dest, () => true);
+        expect(fs.readFileSync(path.join(dest, '.jamdesk-dev.lock'), 'utf-8')).toBe(String(process.pid));
+        expect(fs.readFileSync(path.join(dest, '.content-hash'), 'utf-8')).toBe('abc123');
+        expect(fs.existsSync(path.join(dest, 'package.json'))).toBe(true);
+    });
+    it('still removes other dest files not in source (sweep behavior intact)', async () => {
+        fs.writeFileSync(path.join(src, 'keep.txt'), 'kept');
+        fs.writeFileSync(path.join(dest, 'keep.txt'), 'kept');
+        fs.writeFileSync(path.join(dest, 'orphan.txt'), 'should be removed');
+        const stats = await syncVendoredFiles(src, dest, () => true);
+        expect(fs.existsSync(path.join(dest, 'keep.txt'))).toBe(true);
+        expect(fs.existsSync(path.join(dest, 'orphan.txt'))).toBe(false);
+        expect(stats.removed).toBe(1);
+    });
+    it('skips .next/, node_modules/, projects/, public/ dirs', async () => {
+        fs.writeFileSync(path.join(src, 'a.txt'), 'a');
+        for (const skipped of ['.next', 'node_modules', 'projects', 'public']) {
+            fs.mkdirpSync(path.join(dest, skipped));
+            fs.writeFileSync(path.join(dest, skipped, 'inner.txt'), 'inner');
+        }
+        await syncVendoredFiles(src, dest, () => true);
+        for (const skipped of ['.next', 'node_modules', 'projects', 'public']) {
+            expect(fs.existsSync(path.join(dest, skipped, 'inner.txt'))).toBe(true);
+        }
+    });
+});
+//# sourceMappingURL=dev-sync-vendored.test.js.map

package/dist/__tests__/unit/dev-sync-vendored.test.js.map

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

package/dist/__tests__/unit/run-build-script.test.d.ts

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

package/dist/__tests__/unit/run-build-script.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-build-script.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/run-build-script.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/unit/run-build-script.test.js

@@ -0,0 +1,58 @@
+/**
+ * @vitest-environment node
+ *
+ * Covers the runBuildScript helper extracted from dev.ts so we exercise:
+ * - the success path,
+ * - the failure path (stderr surfaced via result.stderr, not just thrown),
+ * - the maxBuffer ceiling (50MB absorbs >1MB stdout).
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import fs from 'fs-extra';
+import path from 'path';
+import { tmpdir } from 'os';
+import { runBuildScript } from '../../lib/run-build-script.js';
+describe('runBuildScript', () => {
+    let cwd;
+    let scriptsDir;
+    beforeEach(() => {
+        cwd = fs.mkdtempSync(path.join(tmpdir(), 'jam-runscript-'));
+        scriptsDir = path.join(cwd, 'scripts');
+        fs.mkdirpSync(scriptsDir);
+    });
+    afterEach(() => {
+        fs.removeSync(cwd);
+    });
+    it('returns success: true for a script that exits 0', async () => {
+        fs.writeFileSync(path.join(scriptsDir, 'ok.cjs'), `console.log('ran ok');`);
+        const result = await runBuildScript('ok.cjs', { cwd, env: process.env, verbose: false });
+        expect(result.success).toBe(true);
+        expect(result.script).toBe('ok.cjs');
+    });
+    it('returns success: false with stderr surfaced when the script exits non-zero', async () => {
+        fs.writeFileSync(path.join(scriptsDir, 'broken.cjs'), `console.error('something broke');\nprocess.exit(7);`);
+        const result = await runBuildScript('broken.cjs', { cwd, env: process.env, verbose: false });
+        expect(result.success).toBe(false);
+        expect(result.stderr).toContain('something broke');
+        // The error object must still be present so verbose mode can dump it.
+        expect(result.error).toBeDefined();
+    });
+    it('handles >1MB stdout without ERR_CHILD_PROCESS_STDIO_MAXBUFFER', async () => {
+        // ~2MB of stdout — would have failed with default 1MB buffer.
+        fs.writeFileSync(path.join(scriptsDir, 'noisy.cjs'), `const line = 'x'.repeat(1024); for (let i = 0; i < 2048; i++) console.log(line);`);
+        const result = await runBuildScript('noisy.cjs', { cwd, env: process.env, verbose: false });
+        expect(result.success).toBe(true);
+    });
+    it('captures stdout on failure too (some scripts log progress to stdout then exit non-zero)', async () => {
+        fs.writeFileSync(path.join(scriptsDir, 'mixed.cjs'), `console.log('progress: 50%');\nconsole.error('then it died');\nprocess.exit(1);`);
+        const result = await runBuildScript('mixed.cjs', { cwd, env: process.env, verbose: false });
+        expect(result.success).toBe(false);
+        expect(result.stdout).toContain('progress: 50%');
+        expect(result.stderr).toContain('then it died');
+    });
+    it('returns success: false when the script file is missing', async () => {
+        const result = await runBuildScript('missing.cjs', { cwd, env: process.env, verbose: false });
+        expect(result.success).toBe(false);
+        expect(result.error).toBeDefined();
+    });
+});
+//# sourceMappingURL=run-build-script.test.js.map

package/dist/__tests__/unit/run-build-script.test.js.map

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

package/dist/__tests__/unit/workspace-paths.test.d.ts

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

package/dist/__tests__/unit/workspace-paths.test.d.ts.map

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

package/dist/__tests__/unit/workspace-paths.test.js

@@ -0,0 +1,104 @@
+/**
+ * @vitest-environment node
+ */
+import { describe, it, expect, afterEach, beforeEach } from 'vitest';
+import path from 'path';
+import fs from 'fs-extra';
+import { tmpdir } from 'os';
+import { computeWorkspaceSlug, getProjectWorkspaceDir, migrateLegacyWorkspace } from '../../lib/workspace-paths.js';
+describe('computeWorkspaceSlug', () => {
+    it('returns <basename>-<6char-hash> for a normal path', () => {
+        expect(computeWorkspaceSlug('/Users/x/projects/jamdesk-docs'))
+            .toMatch(/^jamdesk-docs-[0-9a-f]{6}$/);
+    });
+    it('is deterministic', () => {
+        const a = computeWorkspaceSlug('/Users/x/projects/jamdesk-docs');
+        const b = computeWorkspaceSlug('/Users/x/projects/jamdesk-docs');
+        expect(a).toBe(b);
+    });
+    it('different paths with same basename → different slugs', () => {
+        expect(computeWorkspaceSlug('/clone-1/jamdesk-docs'))
+            .not.toBe(computeWorkspaceSlug('/clone-2/jamdesk-docs'));
+    });
+    it('sanitises unsafe basename characters to "-"', () => {
+        expect(computeWorkspaceSlug('/tmp/My Project (v2)'))
+            .toMatch(/^my-project-v2-[0-9a-f]{6}$/);
+    });
+    it('truncates very long basenames before appending hash (NAME_MAX safety)', () => {
+        const long = '/tmp/' + 'a'.repeat(300);
+        const slug = computeWorkspaceSlug(long);
+        // safe segment capped at 80 + "-" + 6 hash chars = 87
+        expect(slug.length).toBeLessThanOrEqual(87);
+        expect(slug).toMatch(/^a{80}-[0-9a-f]{6}$/);
+    });
+    it('falls back to "project" when sanitisation strips everything (non-ASCII)', () => {
+        expect(computeWorkspaceSlug('/tmp/プロジェクト'))
+            .toMatch(/^project-[0-9a-f]{6}$/);
+    });
+    it('handles trailing slashes and root paths', () => {
+        expect(computeWorkspaceSlug('/Users/x/foo/')).toMatch(/^foo-[0-9a-f]{6}$/);
+        expect(computeWorkspaceSlug('/')).toMatch(/^project-[0-9a-f]{6}$/);
+    });
+});
+describe('getProjectWorkspaceDir', () => {
+    let tmpRoot;
+    let fakeJamdeskDir;
+    beforeEach(() => {
+        tmpRoot = fs.mkdtempSync(path.join(tmpdir(), 'jam-ws-'));
+        fakeJamdeskDir = path.join(tmpRoot, '.jamdesk');
+    });
+    afterEach(() => {
+        fs.removeSync(tmpRoot);
+    });
+    it('returns <jamdeskDir>/workspaces/<slug> for an existing project dir', () => {
+        const projectDir = path.join(tmpRoot, 'my-docs');
+        fs.mkdirpSync(projectDir);
+        expect(getProjectWorkspaceDir(fakeJamdeskDir, projectDir))
+            .toMatch(new RegExp(`${fakeJamdeskDir}/workspaces/my-docs-[0-9a-f]{6}$`));
+    });
+    it('resolves symlinks before hashing (same workspace via symlink or real path)', () => {
+        const real = path.join(tmpRoot, 'real');
+        const link = path.join(tmpRoot, 'link');
+        fs.mkdirpSync(real);
+        fs.symlinkSync(real, link);
+        expect(getProjectWorkspaceDir(fakeJamdeskDir, real))
+            .toBe(getProjectWorkspaceDir(fakeJamdeskDir, link));
+    });
+    it('falls back to path.resolve when projectDir does not exist (no ENOENT)', () => {
+        const ghost = path.join(tmpRoot, 'never-existed');
+        expect(() => getProjectWorkspaceDir(fakeJamdeskDir, ghost)).not.toThrow();
+        const slug = getProjectWorkspaceDir(fakeJamdeskDir, ghost);
+        expect(slug).toMatch(new RegExp(`${fakeJamdeskDir}/workspaces/never-existed-[0-9a-f]{6}$`));
+    });
+});
+describe('migrateLegacyWorkspace', () => {
+    let tmpRoot;
+    beforeEach(() => {
+        tmpRoot = fs.mkdtempSync(path.join(tmpdir(), 'jam-mig-'));
+    });
+    afterEach(() => {
+        fs.removeSync(tmpRoot);
+    });
+    it('removes <jamdeskDir>/workspace when it exists', async () => {
+        const fakeJamdeskDir = path.join(tmpRoot, '.jamdesk');
+        const legacy = path.join(fakeJamdeskDir, 'workspace');
+        fs.mkdirpSync(path.join(legacy, '.next', 'cache'));
+        fs.writeFileSync(path.join(legacy, 'marker'), 'x');
+        const removed = await migrateLegacyWorkspace(fakeJamdeskDir);
+        expect(removed).toBe(true);
+        expect(fs.existsSync(legacy)).toBe(false);
+    });
+    it('returns false (no-op) when legacy workspace does not exist', async () => {
+        const fakeJamdeskDir = path.join(tmpRoot, '.jamdesk-empty');
+        fs.mkdirpSync(fakeJamdeskDir);
+        expect(await migrateLegacyWorkspace(fakeJamdeskDir)).toBe(false);
+    });
+    it('leaves <jamdeskDir>/workspaces/ untouched (singular vs plural)', async () => {
+        const fakeJamdeskDir = path.join(tmpRoot, '.jamdesk');
+        fs.mkdirpSync(path.join(fakeJamdeskDir, 'workspaces', 'foo-abc123'));
+        fs.writeFileSync(path.join(fakeJamdeskDir, 'workspaces', 'foo-abc123', 'marker'), 'x');
+        await migrateLegacyWorkspace(fakeJamdeskDir);
+        expect(fs.existsSync(path.join(fakeJamdeskDir, 'workspaces', 'foo-abc123', 'marker'))).toBe(true);
+    });
+});
+//# sourceMappingURL=workspace-paths.test.js.map

package/dist/__tests__/unit/workspace-paths.test.js.map

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

package/dist/commands/clean.d.ts

@@ -1,7 +1,22 @@
 /**
  * Clean Command
  *
- * Clears the ~/.jamdesk cache directory.
+ * Default: clears the current project's workspace
+ * (`<jamdeskDir>/workspaces/<slug>/`).
+ *
+ * `--all`: clears everything under `<jamdeskDir>/`, including shared
+ * `node_modules` (next dev will reinstall on first run).
+ *
+ * Both modes use safeRemoveCache so a still-running dev session in the
+ * target tree surfaces a clear "another dev is running" message rather
+ * than crashing ENOTEMPTY.
  */
-export declare function clean(): Promise<void>;
+export interface CleanOptions {
+    all?: boolean;
+}
+export interface CleanContext {
+    jamdeskDir: string;
+    projectDir: string;
+}
+export declare function clean(options?: CleanOptions, ctx?: CleanContext): Promise<void>;
 //# sourceMappingURL=clean.d.ts.map

package/dist/commands/clean.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clean.d.ts","sourceRoot":"","sources":["../../src/commands/clean.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,wBAAsB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAyB3C"}
+{"version":3,"file":"clean.d.ts","sourceRoot":"","sources":["../../src/commands/clean.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AASH,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,KAAK,CACzB,OAAO,GAAE,YAAiB,EAC1B,GAAG,GAAE,YAAyE,GAC7E,OAAO,CAAC,IAAI,CAAC,CAmCf"}