@life-and-dev/mdsite 0.5.2 → 0.6.0

package/README.md

@@ -22,32 +22,28 @@ You write Markdown. For example, your content directory with a few pages and a l
 
 ```yaml
 my-docs/
-└── content
-    ├── index.md
-    ├── about.md
-    ├── blog/
-    │   ├── 2026-01-hello.md
-    │   └── 2026-03-release.md
-    └── logo.png
+├── index.md
+├── about.md
+├── blog/
+│   ├── 2026-01-hello.md
+│   └── 2026-03-release.md
+└── logo.png
 ```
 
 Run the `mdsite static` in your repo to generate the static pages:
 
 ```yaml
 my-docs/
-├── content
-│   ├── index.md
-│   ├── about.md
-│   ├── blog/
-│   │   ├── 2026-01-hello.md
-│   │   └── 2026-03-release.md
-│   └── logo.png
+├── index.md
+├── about.md
+├── blog/
+│   ├── 2026-01-hello.md
+│   └── 2026-03-release.md
+├── logo.png
 ├── mdsite.yml                  # site configuration
-├── package.json                # package configuration
-├── package-lock.json           # package lock
 ├── .mdsite/                    # renderer working dir (gitignored)
 │   ├── mdsite.log              # detached webserver logs
-│   └── ...                     # Other Nuxt render files
+│   └── ...                     # Other Node and Nuxt render files
 └── .output/                    # deployable static site
     └── public/
         ├── index.html          
@@ -63,9 +59,6 @@ my-docs/
         └── ...
 ```
 
-> [!NOTE]
-> You can technically mix your content and project files in the same directory, but it's easier to maintain content and generated files separately.
-
 ## Install
 
 Install the CLI globally from the npm registry on any machine with Node.js (>= 24.0.0) and npm:

package/dist/commands/clean.d.ts

@@ -0,0 +1 @@
+export declare function runCleanCommand(contentDir: string): Promise<string>;

package/dist/commands/clean.js

@@ -0,0 +1,52 @@
+import { access, rm } from 'node:fs/promises';
+import path from 'node:path';
+import { loadMdsiteConfig } from '../config/mdsite-config.js';
+import { isProcessRunning, readRuntimeState } from '../process/runtime-state.js';
+async function pathExists(targetPath) {
+    try {
+        await access(targetPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function runCleanCommand(contentDir) {
+    const loaded = await loadMdsiteConfig(contentDir);
+    const { config, configDir } = loaded;
+    // Refuse to wipe state while a tracked process is still pointing at it.
+    // Tracked PIDs live inside <server.path>, so the clean would orphan them.
+    const trackedStates = await Promise.all([
+        readRuntimeState(configDir, config, 'start'),
+        readRuntimeState(configDir, config, 'preview')
+    ]);
+    for (const state of trackedStates) {
+        if (state && isProcessRunning(state.pid)) {
+            const alias = state.kind === 'start' ? 'live' : 'static';
+            throw new Error(`mdsite ${alias} is running with PID ${state.pid}. Run \`mdsite stop\` before \`mdsite clean\`.`);
+        }
+    }
+    const rendererPath = path.resolve(configDir, config.server.path);
+    const outputPath = path.resolve(configDir, config.server.output);
+    const [rendererExists, outputExists] = await Promise.all([
+        pathExists(rendererPath),
+        pathExists(outputPath)
+    ]);
+    // `force: true` lets us skip non-existent paths without a separate branch.
+    await Promise.all([
+        rm(rendererPath, { recursive: true, force: true }),
+        rm(outputPath, { recursive: true, force: true })
+    ]);
+    const removed = [];
+    if (rendererExists) {
+        removed.push(config.server.path);
+    }
+    if (outputExists) {
+        removed.push(config.server.output);
+    }
+    if (removed.length === 0) {
+        return `Nothing to clean in ${contentDir}.`;
+    }
+    return `Removed ${removed.join(' and ')} from ${contentDir}.`;
+}
+//# sourceMappingURL=clean.js.map

package/dist/commands/clean.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.js","sourceRoot":"","sources":["../../src/commands/clean.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAC7D,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAEhF,KAAK,UAAU,UAAU,CAAC,UAAkB;IAC1C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,UAAU,CAAC,CAAA;QACxB,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,UAAkB;IACtD,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,UAAU,CAAC,CAAA;IACjD,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAA;IAEpC,wEAAwE;IACxE,0EAA0E;IAC1E,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACtC,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC;QAC5C,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC;KAC/C,CAAC,CAAA;IAEF,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,IAAI,KAAK,IAAI,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAA;YACxD,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,wBAAwB,KAAK,CAAC,GAAG,gDAAgD,CAAC,CAAA;QACnH,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAChE,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IAEhE,MAAM,CAAC,cAAc,EAAE,YAAY,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACvD,UAAU,CAAC,YAAY,CAAC;QACxB,UAAU,CAAC,UAAU,CAAC;KACvB,CAAC,CAAA;IAEF,2EAA2E;IAC3E,MAAM,OAAO,CAAC,GAAG,CAAC;QAChB,EAAE,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAClD,EAAE,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;KACjD,CAAC,CAAA;IAEF,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAClC,CAAC;IACD,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACpC,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,uBAAuB,UAAU,GAAG,CAAA;IAC7C,CAAC;IAED,OAAO,WAAW,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,UAAU,GAAG,CAAA;AAC/D,CAAC"}

package/dist/commands/commands.test.js

@@ -3,7 +3,6 @@ vi.mock('node:fs/promises', () => ({
     access: vi.fn(),
     copyFile: vi.fn(),
     cp: vi.fn(),
-    mkdir: vi.fn(),
     readFile: vi.fn(),
     rm: vi.fn(),
     writeFile: vi.fn()
@@ -40,11 +39,12 @@ vi.mock('../renderer/mdsite-nuxt.js', () => ({
     startRendererInBackground: vi.fn()
 }));
 import path from 'node:path';
-import { access, copyFile, cp, mkdir, readFile, rm, writeFile } from 'node:fs/promises';
+import { access, copyFile, cp, readFile, rm, writeFile } from 'node:fs/promises';
 import { buildDefaultMdsiteConfig, loadMdsiteConfig, resolveContentOutputPath, serializeMdsiteConfig } from '../config/mdsite-config.js';
 import { openUrlInBrowser, stopProcess, waitForTcpPort } from '../process/child-process.js';
 import { clearRuntimeState, getRuntimeLogPath, isProcessRunning, readRuntimeState, writeRuntimeState } from '../process/runtime-state.js';
 import { ensurePreviewArtifacts, ensureRendererDependencies, generateRenderer, getBundledRendererDir, getRendererGeneratedOutputPath, hasPreviewArtifacts, prepareRenderer, previewRendererForeground, previewRendererInBackground, startRendererForeground, startRendererInBackground } from '../renderer/mdsite-nuxt.js';
+import { runCleanCommand } from './clean.js';
 import { runGenerateCommand } from './generate.js';
 import { runInitCommand } from './init.js';
 import { runPreviewCommand } from './preview.js';
@@ -55,7 +55,6 @@ const cpMock = vi.mocked(cp);
 const rmMock = vi.mocked(rm);
 const writeFileMock = vi.mocked(writeFile);
 const copyFileMock = vi.mocked(copyFile);
-const mkdirMock = vi.mocked(mkdir);
 const readFileMock = vi.mocked(readFile);
 const getBundledRendererDirMock = vi.mocked(getBundledRendererDir);
 const buildDefaultConfigMock = vi.mocked(buildDefaultMdsiteConfig);
@@ -86,7 +85,7 @@ const loadedConfig = {
         features: { bibleTooltips: true, sourceEdit: true },
         menu: [],
         footer: [],
-        server: { output: '.output', path: '.renderer', repo: 'repo' },
+        server: { output: '.output', path: '.renderer', repo: 'repo', gitBranch: 'main' },
         site: { canonical: '', name: 'Docs' },
         themes: { light: { colors: {} }, dark: { colors: {} } }
     },
@@ -102,7 +101,8 @@ describe('command helpers', () => {
         hasPreviewArtifactsMock.mockResolvedValue(true);
         prepareRendererMock.mockResolvedValue({ rendererDir: '/renderer', rendererEnv: { TEST: '1' } });
         getRuntimeLogPathMock.mockImplementation((configDir, config, kind) => {
-            return `${configDir}/${config.server.path}/${kind}.log`;
+            const basename = kind === 'start' ? 'live' : 'static';
+            return `${configDir}/${config.server.path}/${basename}.log`;
         });
         resolveOutputMock.mockReturnValue('/content/.output/public');
         getRendererGeneratedOutputPathMock.mockReturnValue('/renderer/.output/public');
@@ -119,27 +119,16 @@ describe('command helpers', () => {
         });
         buildDefaultConfigMock.mockResolvedValue(loadedConfig.config);
         serializeConfigMock.mockReturnValue('serialized-config');
-        readFileMock.mockResolvedValueOnce(JSON.stringify({ name: 'mdsite-nuxt-renderer', version: '0.1.0', description: 'old', scripts: { dev: 'x' } }));
-        readFileMock.mockResolvedValueOnce(JSON.stringify({ name: 'mdsite-nuxt-renderer', version: '0.1.0', lockfileVersion: 3, packages: { '': { name: 'mdsite-nuxt-renderer', version: '0.1.0' } } }));
-        await expect(runInitCommand('/content')).resolves.toBe('Created mdsite.yml, .nvmrc, .renderer/package.json, .renderer/package-lock.json in /content.');
+        await expect(runInitCommand('/content')).resolves.toBe('Created mdsite.yml, .nvmrc in /content.');
         expect(buildDefaultConfigMock).toHaveBeenCalledWith('/content');
         expect(loadConfigMock).not.toHaveBeenCalled();
         expect(writeFileMock).toHaveBeenCalledWith('/content/mdsite.yml', 'serialized-config', 'utf8');
         expect(writeFileMock).toHaveBeenCalledWith('/content/.nvmrc', '24\n', 'utf8');
-        expect(mkdirMock).toHaveBeenCalledWith(path.join('/content', '.renderer'), { recursive: true });
-        expect(readFileMock).toHaveBeenCalledWith(path.join('/home/gizbar/git/mdsite/mdsite-nuxt', 'package.json'), 'utf8');
-        expect(readFileMock).toHaveBeenCalledWith(path.join('/home/gizbar/git/mdsite/mdsite-nuxt', 'package-lock.json'), 'utf8');
-        const writtenPkg = writeFileMock.mock.calls.find(([p]) => p === path.join('/content', '.renderer', 'package.json'));
-        expect(writtenPkg).toBeDefined();
-        expect(writtenPkg[1]).toBe(`${JSON.stringify({ name: 'content', version: '0.1.0', description: 'Docs', scripts: { dev: 'x' } }, null, 2)}\n`);
-        const writtenLock = writeFileMock.mock.calls.find(([p]) => p === path.join('/content', '.renderer', 'package-lock.json'));
-        expect(writtenLock).toBeDefined();
-        expect(writtenLock[1]).toBe(`${JSON.stringify({ name: 'content', version: '0.1.0', lockfileVersion: 3, packages: { '': { name: 'content', version: '0.1.0' } } }, null, 2)}\n`);
         expect(copyFileMock).not.toHaveBeenCalled();
         expect(writeFileMock).toHaveBeenCalledWith('/content/.gitignore', expect.stringContaining('.renderer/*'), 'utf8');
-        expect(writeFileMock).toHaveBeenCalledWith('/content/.gitignore', expect.stringContaining('!.renderer/package.json'), 'utf8');
-        expect(writeFileMock).toHaveBeenCalledWith('/content/.gitignore', expect.stringContaining('!.renderer/package-lock.json'), 'utf8');
         expect(writeFileMock).toHaveBeenCalledWith('/content/.gitignore', expect.stringContaining('.output/'), 'utf8');
+        expect(writeFileMock).not.toHaveBeenCalledWith('/content/.gitignore', expect.stringContaining('!.renderer/package.json'), 'utf8');
+        expect(writeFileMock).not.toHaveBeenCalledWith('/content/.gitignore', expect.stringContaining('!.renderer/package-lock.json'), 'utf8');
     });
     it('runInitCommand preserves an existing .nvmrc and only creates the rest', async () => {
         const existing = new Set(['/content/.nvmrc']);
@@ -150,33 +139,23 @@ describe('command helpers', () => {
         });
         buildDefaultConfigMock.mockResolvedValue(loadedConfig.config);
         serializeConfigMock.mockReturnValue('serialized-config');
-        readFileMock.mockResolvedValueOnce(JSON.stringify({ name: 'mdsite-nuxt-renderer', version: '0.1.0', description: 'old', scripts: { dev: 'x' } }));
-        readFileMock.mockResolvedValueOnce(JSON.stringify({ name: 'mdsite-nuxt-renderer', version: '0.1.0', lockfileVersion: 3, packages: { '': { name: 'mdsite-nuxt-renderer', version: '0.1.0' } } }));
-        await expect(runInitCommand('/content')).resolves.toBe('Created mdsite.yml, .renderer/package.json, .renderer/package-lock.json in /content.');
+        await expect(runInitCommand('/content')).resolves.toBe('Created mdsite.yml in /content.');
         expect(writeFileMock).not.toHaveBeenCalledWith('/content/.nvmrc', expect.anything(), expect.anything());
         expect(copyFileMock).not.toHaveBeenCalled();
     });
     it('runInitCommand loads an existing mdsite.yml to repair missing files without overwriting it', async () => {
         const existing = new Set([
-            '/content/mdsite.yml',
-            '/content/.nvmrc',
-            path.join('/content', '.renderer', 'package.json')
+            '/content/mdsite.yml'
         ]);
         accessMock.mockImplementation(async (p) => {
             if (typeof p === 'string' && existing.has(p))
                 return;
             throw new Error('missing');
         });
-        readFileMock.mockResolvedValueOnce(JSON.stringify({ name: 'mdsite-nuxt-renderer', version: '0.1.0', lockfileVersion: 3, packages: { '': { name: 'mdsite-nuxt-renderer', version: '0.1.0' } } }));
-        await expect(runInitCommand('/content')).resolves.toBe('Created .renderer/package-lock.json in /content.');
+        await expect(runInitCommand('/content')).resolves.toBe('Created .nvmrc in /content.');
         expect(loadConfigMock).toHaveBeenCalledWith('/content');
         expect(buildDefaultConfigMock).not.toHaveBeenCalled();
         expect(writeFileMock).not.toHaveBeenCalledWith('/content/mdsite.yml', expect.anything(), expect.anything());
-        const writeFileCallsForPkg = writeFileMock.mock.calls.filter(([p]) => typeof p === 'string' && p === path.join('/content', '.renderer', 'package.json'));
-        expect(writeFileCallsForPkg).toHaveLength(0);
-        const writtenLock = writeFileMock.mock.calls.find(([p]) => p === path.join('/content', '.renderer', 'package-lock.json'));
-        expect(writtenLock).toBeDefined();
-        expect(writtenLock[1]).toBe(`${JSON.stringify({ name: 'content', version: '0.1.0', lockfileVersion: 3, packages: { '': { name: 'content', version: '0.1.0' } } }, null, 2)}\n`);
         expect(copyFileMock).not.toHaveBeenCalled();
     });
     it('runInitCommand reports nothing to create when every file already exists', async () => {
@@ -218,7 +197,7 @@ describe('command helpers', () => {
         readRuntimeStateMock.mockResolvedValueOnce({ kind: 'start', pid: 44 });
         isProcessRunningMock.mockReturnValueOnce(false);
         startRendererInBackgroundMock.mockResolvedValueOnce(777);
-        await expect(runStartCommand('/content', { detached: true })).resolves.toBe('mdsite live running in background (PID 777). Log: /content/.renderer/start.log');
+        await expect(runStartCommand('/content', { detached: true })).resolves.toBe('mdsite live running in background (PID 777). Log: /content/.renderer/live.log');
         expect(ensureRendererDependenciesMock).toHaveBeenCalledWith('/renderer');
         expect(waitForTcpPortMock).toHaveBeenCalledWith('localhost', 3000);
         expect(waitForTcpPortMock.mock.invocationCallOrder[0]).toBeGreaterThan(writeRuntimeStateMock.mock.invocationCallOrder[0] ?? 0);
@@ -239,7 +218,7 @@ describe('command helpers', () => {
             rendererEnv: { HOST: '127.0.0.1', PORT: '4173', NUXT_HOST: 'start.local', NUXT_PORT: '4321' }
         });
         startRendererInBackgroundMock.mockResolvedValueOnce(778);
-        await expect(runStartCommand('/content', { detached: true })).resolves.toBe('mdsite live running in background (PID 778). Log: /content/.renderer/start.log');
+        await expect(runStartCommand('/content', { detached: true })).resolves.toBe('mdsite live running in background (PID 778). Log: /content/.renderer/live.log');
         expect(waitForTcpPortMock).toHaveBeenCalledWith('start.local', 4321);
         expect(openUrlInBrowserMock).toHaveBeenCalledWith('http://start.local:4321');
     });
@@ -247,7 +226,7 @@ describe('command helpers', () => {
         readRuntimeStateMock.mockResolvedValueOnce(null);
         startRendererInBackgroundMock.mockResolvedValueOnce(779);
         waitForTcpPortMock.mockResolvedValueOnce(false);
-        await expect(runStartCommand('/content', { detached: true })).resolves.toBe('mdsite live running in background (PID 779). Log: /content/.renderer/start.log');
+        await expect(runStartCommand('/content', { detached: true })).resolves.toBe('mdsite live running in background (PID 779). Log: /content/.renderer/live.log');
         expect(waitForTcpPortMock).toHaveBeenCalledWith('localhost', 3000);
         expect(openUrlInBrowserMock).not.toHaveBeenCalled();
     });
@@ -255,7 +234,7 @@ describe('command helpers', () => {
         readRuntimeStateMock.mockResolvedValueOnce(null);
         startRendererInBackgroundMock.mockResolvedValueOnce(780);
         waitForTcpPortMock.mockRejectedValueOnce(new Error('connect failed'));
-        await expect(runStartCommand('/content', { detached: true })).resolves.toBe('mdsite live running in background (PID 780). Log: /content/.renderer/start.log');
+        await expect(runStartCommand('/content', { detached: true })).resolves.toBe('mdsite live running in background (PID 780). Log: /content/.renderer/live.log');
         expect(openUrlInBrowserMock).not.toHaveBeenCalled();
     });
     it('runStartCommand exposes the foreground renderer on the network when host is set', async () => {
@@ -270,12 +249,12 @@ describe('command helpers', () => {
     it('runStartCommand binds the detached renderer to a custom host when host is set', async () => {
         readRuntimeStateMock.mockResolvedValueOnce(null);
         startRendererInBackgroundMock.mockResolvedValueOnce(781);
-        await expect(runStartCommand('/content', { detached: true, host: '0.0.0.0' })).resolves.toBe('mdsite live running in background (PID 781). Log: /content/.renderer/start.log');
+        await expect(runStartCommand('/content', { detached: true, host: '0.0.0.0' })).resolves.toBe('mdsite live running in background (PID 781). Log: /content/.renderer/live.log');
         expect(startRendererInBackgroundMock).toHaveBeenCalledWith('/renderer', expect.objectContaining({
             NUXT_HOST: '0.0.0.0',
             HOST: '0.0.0.0',
             NITRO_HOST: '0.0.0.0'
-        }), '/content/.renderer/start.log');
+        }), '/content/.renderer/live.log');
         expect(waitForTcpPortMock).toHaveBeenCalledWith('0.0.0.0', 3000);
         expect(openUrlInBrowserMock).toHaveBeenCalledWith('http://0.0.0.0:3000');
     });
@@ -309,7 +288,7 @@ describe('command helpers', () => {
         vi.setSystemTime(new Date('2026-04-10T13:00:00.000Z'));
         readRuntimeStateMock.mockResolvedValueOnce(null);
         previewRendererInBackgroundMock.mockResolvedValueOnce(888);
-        await expect(runPreviewCommand('/content', { detached: true })).resolves.toBe('mdsite static running in background (PID 888). URL: http://localhost:3000 Log: /content/.renderer/preview.log');
+        await expect(runPreviewCommand('/content', { detached: true })).resolves.toBe('mdsite static running in background (PID 888). URL: http://localhost:3000 Log: /content/.renderer/static.log');
         expect(ensurePreviewArtifactsMock).toHaveBeenCalledWith('/renderer');
         expect(ensurePreviewArtifactsMock.mock.invocationCallOrder[0]).toBeGreaterThan(ensureRendererDependenciesMock.mock.invocationCallOrder[0] ?? 0);
         expect(previewRendererInBackgroundMock).toHaveBeenCalledWith('/renderer', expect.objectContaining({
@@ -320,7 +299,7 @@ describe('command helpers', () => {
             PORT: '3000',
             NITRO_HOST: 'localhost',
             NITRO_PORT: '3000'
-        }), '/content/.renderer/preview.log');
+        }), '/content/.renderer/static.log');
         expect(waitForTcpPortMock).toHaveBeenCalledWith('localhost', 3000);
         expect(waitForTcpPortMock.mock.invocationCallOrder[0]).toBeGreaterThan(writeRuntimeStateMock.mock.invocationCallOrder[0] ?? 0);
         expect(openUrlInBrowserMock.mock.invocationCallOrder[0]).toBeGreaterThan(waitForTcpPortMock.mock.invocationCallOrder[0] ?? 0);
@@ -339,7 +318,7 @@ describe('command helpers', () => {
             rendererEnv: { HOST: '127.0.0.1', PORT: '4173', NUXT_HOST: 'preview.local', NUXT_PORT: '4321' }
         });
         previewRendererInBackgroundMock.mockResolvedValueOnce(999);
-        await expect(runPreviewCommand('/content', { detached: true })).resolves.toBe('mdsite static running in background (PID 999). URL: http://preview.local:4321 Log: /content/.renderer/preview.log');
+        await expect(runPreviewCommand('/content', { detached: true })).resolves.toBe('mdsite static running in background (PID 999). URL: http://preview.local:4321 Log: /content/.renderer/static.log');
         expect(previewRendererInBackgroundMock).toHaveBeenCalledWith('/renderer', expect.objectContaining({
             HOST: 'preview.local',
             PORT: '4321',
@@ -347,7 +326,7 @@ describe('command helpers', () => {
             NUXT_PORT: '4321',
             NITRO_HOST: 'preview.local',
             NITRO_PORT: '4321'
-        }), '/content/.renderer/preview.log');
+        }), '/content/.renderer/static.log');
         expect(waitForTcpPortMock).toHaveBeenCalledWith('preview.local', 4321);
         expect(openUrlInBrowserMock).toHaveBeenCalledWith('http://preview.local:4321');
     });
@@ -358,7 +337,7 @@ describe('command helpers', () => {
             rendererEnv: { HOST: '127.0.0.1', PORT: '4173' }
         });
         previewRendererInBackgroundMock.mockResolvedValueOnce(1000);
-        await expect(runPreviewCommand('/content', { detached: true })).resolves.toBe('mdsite static running in background (PID 1000). URL: http://127.0.0.1:4173 Log: /content/.renderer/preview.log');
+        await expect(runPreviewCommand('/content', { detached: true })).resolves.toBe('mdsite static running in background (PID 1000). URL: http://127.0.0.1:4173 Log: /content/.renderer/static.log');
         expect(previewRendererInBackgroundMock).toHaveBeenCalledWith('/renderer', expect.objectContaining({
             HOST: '127.0.0.1',
             PORT: '4173',
@@ -366,7 +345,7 @@ describe('command helpers', () => {
             NUXT_PORT: '4173',
             NITRO_HOST: '127.0.0.1',
             NITRO_PORT: '4173'
-        }), '/content/.renderer/preview.log');
+        }), '/content/.renderer/static.log');
         expect(waitForTcpPortMock).toHaveBeenCalledWith('127.0.0.1', 4173);
         expect(openUrlInBrowserMock).toHaveBeenCalledWith('http://127.0.0.1:4173');
     });
@@ -385,13 +364,13 @@ describe('command helpers', () => {
             rendererEnv: { HOST: '127.0.0.1', PORT: '4173', NUXT_HOST: 'preview.local', NUXT_PORT: '4321' }
         });
         previewRendererInBackgroundMock.mockResolvedValueOnce(1003);
-        await expect(runPreviewCommand('/content', { detached: true, host: '0.0.0.0' })).resolves.toBe('mdsite static running in background (PID 1003). URL: http://0.0.0.0:4321 Log: /content/.renderer/preview.log');
+        await expect(runPreviewCommand('/content', { detached: true, host: '0.0.0.0' })).resolves.toBe('mdsite static running in background (PID 1003). URL: http://0.0.0.0:4321 Log: /content/.renderer/static.log');
         expect(previewRendererInBackgroundMock).toHaveBeenCalledWith('/renderer', expect.objectContaining({
             NUXT_HOST: '0.0.0.0',
             HOST: '0.0.0.0',
             NITRO_HOST: '0.0.0.0',
             NUXT_PORT: '4321'
-        }), '/content/.renderer/preview.log');
+        }), '/content/.renderer/static.log');
         expect(waitForTcpPortMock).toHaveBeenCalledWith('0.0.0.0', 4321);
         expect(openUrlInBrowserMock).toHaveBeenCalledWith('http://0.0.0.0:4321');
     });
@@ -399,7 +378,7 @@ describe('command helpers', () => {
         readRuntimeStateMock.mockResolvedValueOnce(null);
         previewRendererInBackgroundMock.mockResolvedValueOnce(1001);
         waitForTcpPortMock.mockResolvedValueOnce(false);
-        await expect(runPreviewCommand('/content', { detached: true })).resolves.toBe('mdsite static running in background (PID 1001). URL: http://localhost:3000 Log: /content/.renderer/preview.log');
+        await expect(runPreviewCommand('/content', { detached: true })).resolves.toBe('mdsite static running in background (PID 1001). URL: http://localhost:3000 Log: /content/.renderer/static.log');
         expect(waitForTcpPortMock).toHaveBeenCalledWith('localhost', 3000);
         expect(openUrlInBrowserMock).not.toHaveBeenCalled();
     });
@@ -407,7 +386,7 @@ describe('command helpers', () => {
         readRuntimeStateMock.mockResolvedValueOnce(null);
         previewRendererInBackgroundMock.mockResolvedValueOnce(1002);
         waitForTcpPortMock.mockRejectedValueOnce(new Error('connect failed'));
-        await expect(runPreviewCommand('/content', { detached: true })).resolves.toBe('mdsite static running in background (PID 1002). URL: http://localhost:3000 Log: /content/.renderer/preview.log');
+        await expect(runPreviewCommand('/content', { detached: true })).resolves.toBe('mdsite static running in background (PID 1002). URL: http://localhost:3000 Log: /content/.renderer/static.log');
         expect(openUrlInBrowserMock).not.toHaveBeenCalled();
     });
     it('runStartCommand auto-runs mdsite init when mdsite.yml is missing', async () => {
@@ -416,7 +395,7 @@ describe('command helpers', () => {
         });
         buildDefaultConfigMock.mockResolvedValue(loadedConfig.config);
         serializeConfigMock.mockReturnValue('serialized-config');
-        readFileMock.mockResolvedValueOnce('{}').mockResolvedValueOnce('{}');
+        readFileMock.mockResolvedValueOnce('{}');
         const consoleSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
         await expect(runStartCommand('/content')).resolves.toBeUndefined();
         expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('No mdsite.yml found'));
@@ -431,7 +410,7 @@ describe('command helpers', () => {
         });
         buildDefaultConfigMock.mockResolvedValue(loadedConfig.config);
         serializeConfigMock.mockReturnValue('serialized-config');
-        readFileMock.mockResolvedValueOnce('{}').mockResolvedValueOnce('{}');
+        readFileMock.mockResolvedValueOnce('{}');
         const consoleSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
         await expect(runPreviewCommand('/content')).resolves.toBeUndefined();
         expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('No mdsite.yml found'));
@@ -447,13 +426,13 @@ describe('command helpers', () => {
         });
         buildDefaultConfigMock.mockResolvedValue(loadedConfig.config);
         serializeConfigMock.mockReturnValue('serialized-config');
-        readFileMock.mockResolvedValueOnce('{}').mockResolvedValueOnce('{}');
+        readFileMock.mockResolvedValueOnce('{}');
         previewRendererInBackgroundMock.mockResolvedValueOnce(5555);
         const consoleSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
-        await expect(runPreviewCommand('/content', { detached: true })).resolves.toBe('mdsite static running in background (PID 5555). URL: http://localhost:3000 Log: /content/.renderer/preview.log');
+        await expect(runPreviewCommand('/content', { detached: true })).resolves.toBe('mdsite static running in background (PID 5555). URL: http://localhost:3000 Log: /content/.renderer/static.log');
         expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('No mdsite.yml found'));
         expect(writeFileMock).toHaveBeenCalledWith('/content/mdsite.yml', 'serialized-config', 'utf8');
-        expect(previewRendererInBackgroundMock).toHaveBeenCalledWith('/renderer', expect.objectContaining({ TEST: '1' }), '/content/.renderer/preview.log');
+        expect(previewRendererInBackgroundMock).toHaveBeenCalledWith('/renderer', expect.objectContaining({ TEST: '1' }), '/content/.renderer/static.log');
         consoleSpy.mockRestore();
     });
     it('runGenerateCommand auto-runs mdsite init when mdsite.yml is missing', async () => {
@@ -462,7 +441,7 @@ describe('command helpers', () => {
         });
         buildDefaultConfigMock.mockResolvedValue(loadedConfig.config);
         serializeConfigMock.mockReturnValue('serialized-config');
-        readFileMock.mockResolvedValueOnce('{}').mockResolvedValueOnce('{}');
+        readFileMock.mockResolvedValueOnce('{}');
         const consoleSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
         await expect(runGenerateCommand('/content')).resolves.toBe('Generated site synced to /content/.output/public');
         expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('No mdsite.yml found'));
@@ -487,10 +466,10 @@ describe('command helpers', () => {
         hasPreviewArtifactsMock.mockResolvedValueOnce(false);
         previewRendererInBackgroundMock.mockResolvedValueOnce(1234);
         const consoleSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
-        await expect(runPreviewCommand('/content', { detached: true })).resolves.toBe('mdsite static running in background (PID 1234). URL: http://localhost:3000 Log: /content/.renderer/preview.log');
+        await expect(runPreviewCommand('/content', { detached: true })).resolves.toBe('mdsite static running in background (PID 1234). URL: http://localhost:3000 Log: /content/.renderer/static.log');
         expect(hasPreviewArtifactsMock).toHaveBeenCalledWith('/renderer');
         expect(generateRendererMock).toHaveBeenCalledWith('/renderer', { TEST: '1' });
-        expect(previewRendererInBackgroundMock).toHaveBeenCalledWith('/renderer', expect.objectContaining({ TEST: '1' }), '/content/.renderer/preview.log');
+        expect(previewRendererInBackgroundMock).toHaveBeenCalledWith('/renderer', expect.objectContaining({ TEST: '1' }), '/content/.renderer/static.log');
         consoleSpy.mockRestore();
     });
     it('runGenerateCommand syncs renderer output to the configured destination', async () => {
@@ -514,5 +493,80 @@ describe('command helpers', () => {
         expect(clearRuntimeStateMock).toHaveBeenNthCalledWith(1, '/content', loadedConfig.config, 'start');
         expect(clearRuntimeStateMock).toHaveBeenNthCalledWith(2, '/content', loadedConfig.config, 'preview');
     });
+    it('runCleanCommand removes both configured working dirs and reports both removals', async () => {
+        // `.renderer` and `.output` are reported as existing; everything else throws on access().
+        const existing = new Set(['/content/.renderer', '/content/.output']);
+        accessMock.mockImplementation(async (p) => {
+            if (typeof p === 'string' && existing.has(p))
+                return;
+            throw new Error('missing');
+        });
+        // No active tracked start or preview processes.
+        readRuntimeStateMock.mockResolvedValueOnce(null).mockResolvedValueOnce(null);
+        await expect(runCleanCommand('/content')).resolves.toBe('Removed .renderer and .output from /content.');
+        expect(rmMock).toHaveBeenCalledWith('/content/.renderer', { recursive: true, force: true });
+        expect(rmMock).toHaveBeenCalledWith('/content/.output', { recursive: true, force: true });
+    });
+    it('runCleanCommand reports the single existing directory when only one of the two is present', async () => {
+        const existing = new Set(['/content/.output']);
+        accessMock.mockImplementation(async (p) => {
+            if (typeof p === 'string' && existing.has(p))
+                return;
+            throw new Error('missing');
+        });
+        readRuntimeStateMock.mockResolvedValueOnce(null).mockResolvedValueOnce(null);
+        await expect(runCleanCommand('/content')).resolves.toBe('Removed .output from /content.');
+        expect(rmMock).toHaveBeenCalledTimes(2);
+        expect(rmMock).toHaveBeenCalledWith('/content/.renderer', { recursive: true, force: true });
+        expect(rmMock).toHaveBeenCalledWith('/content/.output', { recursive: true, force: true });
+    });
+    it('runCleanCommand is a no-op when neither configured working dir exists', async () => {
+        const existing = new Set();
+        accessMock.mockImplementation(async (p) => {
+            if (typeof p === 'string' && existing.has(p))
+                return;
+            throw new Error('missing');
+        });
+        readRuntimeStateMock.mockResolvedValueOnce(null).mockResolvedValueOnce(null);
+        await expect(runCleanCommand('/content')).resolves.toBe('Nothing to clean in /content.');
+        // rm() is still called on both paths so force:true silently ignores missing dirs.
+        expect(rmMock).toHaveBeenCalledTimes(2);
+    });
+    it('runCleanCommand refuses to delete the working dirs while a tracked start process is alive', async () => {
+        readRuntimeStateMock
+            .mockResolvedValueOnce({ kind: 'start', pid: 44 })
+            .mockResolvedValueOnce(null);
+        isProcessRunningMock.mockReturnValueOnce(true);
+        await expect(runCleanCommand('/content')).rejects.toThrow('mdsite live is running with PID 44. Run `mdsite stop` before `mdsite clean`.');
+        expect(rmMock).not.toHaveBeenCalled();
+    });
+    it('runCleanCommand refuses to delete the working dirs while a tracked preview process is alive', async () => {
+        readRuntimeStateMock
+            .mockResolvedValueOnce(null)
+            .mockResolvedValueOnce({ kind: 'preview', pid: 55 });
+        isProcessRunningMock.mockReturnValueOnce(true);
+        await expect(runCleanCommand('/content')).rejects.toThrow('mdsite static is running with PID 55. Run `mdsite stop` before `mdsite clean`.');
+        expect(rmMock).not.toHaveBeenCalled();
+    });
+    it('runCleanCommand ignores stale tracked state whose PID is no longer alive', async () => {
+        const existing = new Set(['/content/.renderer', '/content/.output']);
+        accessMock.mockImplementation(async (p) => {
+            if (typeof p === 'string' && existing.has(p))
+                return;
+            throw new Error('missing');
+        });
+        readRuntimeStateMock
+            .mockResolvedValueOnce({ kind: 'start', pid: 44 })
+            .mockResolvedValueOnce({ kind: 'preview', pid: 55 });
+        isProcessRunningMock.mockReturnValue(false);
+        await expect(runCleanCommand('/content')).resolves.toBe('Removed .renderer and .output from /content.');
+        expect(rmMock).toHaveBeenCalledWith('/content/.renderer', { recursive: true, force: true });
+        expect(rmMock).toHaveBeenCalledWith('/content/.output', { recursive: true, force: true });
+    });
+    it('runCleanCommand surfaces the missing-config error from loadMdsiteConfig', async () => {
+        loadConfigMock.mockRejectedValueOnce(new Error('Missing mdsite.yml in /content. Run `mdsite init` first.'));
+        await expect(runCleanCommand('/content')).rejects.toThrow('Missing mdsite.yml in /content. Run `mdsite init` first.');
+        expect(rmMock).not.toHaveBeenCalled();
+    });
 });
 //# sourceMappingURL=commands.test.js.map