@life-and-dev/mdsite 0.0.3

package/dist/commands/prepare.js

@@ -0,0 +1,111 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { loadMdsiteConfig } from '../config/mdsite-config.js';
+import { ensureConfiguredRendererInstalled, ensureRendererDependencies, prepareConfiguredRenderer, prepareRendererBackend } from '../renderer/mdsite-nuxt.js';
+export async function runPrepareGithubCommand(contentDir) {
+    const loaded = await loadMdsiteConfig(contentDir);
+    await ensureConfiguredRendererInstalled(loaded.contentDir, loaded.config, loaded);
+    const { rendererDir, rendererEnv } = await prepareConfiguredRenderer(loaded.contentDir, loaded.config, loaded);
+    await ensureRendererDependencies(rendererDir);
+    await prepareRendererBackend(rendererDir, rendererEnv);
+    const workflowPath = path.join(contentDir, '.github', 'workflows', 'deploy.yml');
+    await mkdir(path.dirname(workflowPath), { recursive: true });
+    await writeFile(workflowPath, buildGithubWorkflow(loaded.config), 'utf8');
+    return `Generated GitHub Pages workflow at ${workflowPath}`;
+}
+function buildGithubWorkflow(config) {
+    const rendererPath = path.posix.normalize(config.server.path.replace(/\\/g, '/'));
+    const outputPath = path.posix.join(rendererPath, path.posix.normalize(config.server.output.replace(/\\/g, '/')));
+    const workflowName = `Deploy ${config.site.name} to GitHub Pages`;
+    const artifactPath = `./${outputPath}/public`;
+    const workspaceContentPath = config.content?.path ? `\${{ github.workspace }}/${path.posix.normalize(config.content.path.replace(/\\/g, '/'))}` : '${{ github.workspace }}';
+    return [
+        `name: ${JSON.stringify(workflowName)}`,
+        '',
+        'on:',
+        '  push:',
+        '    branches: ["main"]',
+        '  workflow_dispatch:',
+        '',
+        'permissions:',
+        '  contents: read',
+        '  pages: write',
+        '  id-token: write',
+        '',
+        'concurrency:',
+        '  group: "pages"',
+        '  cancel-in-progress: false',
+        '',
+        'jobs:',
+        '  build:',
+        '    runs-on: ubuntu-latest',
+        '    env:',
+        `      NUXT_CONTENT_PATH: "${workspaceContentPath}"`,
+        `      CONTENT_DIR: "${workspaceContentPath}"`,
+        '      MDSITE_CONFIG_PATH: "${{ github.workspace }}/mdsite.yml"',
+        '    steps:',
+        '      - name: Checkout',
+        '        uses: actions/checkout@v4',
+        '',
+        '      - name: Setup mdsite renderer',
+        '        run: |',
+        '          npm install --no-save mdsite',
+        "          node <<'NODE'",
+        "          const fs = require('node:fs')",
+        "          const path = require('node:path')",
+        "          const ignored = new Set(['node_modules', '.nuxt', '.output', 'dist', '.cache'])",
+        "          const source = path.join(process.cwd(), 'node_modules', 'mdsite', 'mdsite-nuxt')",
+        `          const target = path.join(process.cwd(), ${JSON.stringify(rendererPath)})`,
+        '          fs.cpSync(source, target, { recursive: true, force: true, filter: (sourcePath) => !ignored.has(path.basename(sourcePath)) })',
+        '          NODE',
+        '',
+        '      - name: Setup Node',
+        '        uses: actions/setup-node@v4',
+        '        with:',
+        '          node-version: "24"',
+        '          cache: npm',
+        `          cache-dependency-path: ${JSON.stringify(`${rendererPath}/package-lock.json`)}`,
+        '',
+        '      - name: Setup Pages',
+        '        id: pages',
+        '        uses: actions/configure-pages@v5',
+        '',
+        '      - name: Restore cache',
+        '        uses: actions/cache@v4',
+        '        with:',
+        '          path: |',
+        `            ${rendererPath}/node_modules`,
+        `            ${rendererPath}/.nuxt`,
+        `            ${outputPath}`,
+        "          key: ${{ runner.os }}-nuxt-build-${{ hashFiles('" + rendererPath + "/package-lock.json') }}",
+        '          restore-keys: |',
+        '            ${{ runner.os }}-nuxt-build-',
+        '',
+        '      - name: Install dependencies',
+        `        working-directory: ${rendererPath}`,
+        '        run: npm install',
+        '',
+        '      - name: Generate static site',
+        `        working-directory: ${rendererPath}`,
+        '        run: npm run generate',
+        '        env:',
+        '          NUXT_APP_BASE_URL: ${{ steps.pages.outputs.base_path }}',
+        '',
+        '      - name: Upload artifact',
+        '        uses: actions/upload-pages-artifact@v3',
+        '        with:',
+        `          path: ${JSON.stringify(artifactPath)}`,
+        '',
+        '  deploy:',
+        '    environment:',
+        '      name: github-pages',
+        '      url: ${{ steps.deployment.outputs.page_url }}',
+        '    runs-on: ubuntu-latest',
+        '    needs: build',
+        '    steps:',
+        '      - name: Deploy to GitHub Pages',
+        '        id: deployment',
+        '        uses: actions/deploy-pages@v4'
+    ].join('\n') + '\n';
+}
+//# sourceMappingURL=prepare.js.map

package/dist/commands/prepare.js.map

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

package/dist/commands/prepare.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commands/prepare.test.js

@@ -0,0 +1,131 @@
+import os from 'node:os';
+import path from 'node:path';
+import { mkdtemp, mkdir, readFile, rm, writeFile } from 'node:fs/promises';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+vi.mock('../process/child-process.js', () => ({
+    runBackground: vi.fn(),
+    runForeground: vi.fn()
+}));
+import { runForeground } from '../process/child-process.js';
+import { runPrepareGithubCommand } from './prepare.js';
+const runForegroundMock = vi.mocked(runForeground);
+describe('runPrepareGithubCommand', () => {
+    const tempDirs = [];
+    beforeEach(() => {
+        vi.clearAllMocks();
+        runForegroundMock.mockResolvedValue(undefined);
+    });
+    afterEach(async () => {
+        for (const tempDir of tempDirs.splice(0)) {
+            await rm(tempDir, { force: true, recursive: true });
+        }
+    });
+    it('reads mdsite.yml, generates in the configured renderer path, and writes the GitHub Pages workflow', async () => {
+        const contentDir = await mkdtemp(path.join(os.tmpdir(), 'mdsite-prepare-'));
+        tempDirs.push(contentDir);
+        const rendererDir = path.join(contentDir, 'renderer');
+        await mkdir(path.join(rendererDir, 'node_modules'), { recursive: true });
+        await writeFile(path.join(contentDir, 'mdsite.yml'), [
+            'site:',
+            '  name: Example Docs',
+            'server:',
+            '  path: renderer',
+            '  output: build/site',
+            ''
+        ].join('\n'), 'utf8');
+        await writeFile(path.join(contentDir, 'index.md'), '# Example Docs\n', 'utf8');
+        await writeFile(path.join(contentDir, 'guide.md'), '# Guide\n', 'utf8');
+        const result = await runPrepareGithubCommand(contentDir);
+        const workflowPath = path.join(contentDir, '.github', 'workflows', 'deploy.yml');
+        const workflow = await readFile(workflowPath, 'utf8');
+        expect(result).toBe(`Generated GitHub Pages workflow at ${workflowPath}`);
+        expect(workflow).toContain('name: "Deploy Example Docs to GitHub Pages"');
+        expect(workflow).toContain('runs-on: ubuntu-latest');
+        expect(workflow).toContain('node-version: "24"');
+        expect(workflow).toContain('working-directory: renderer');
+        expect(workflow).toContain('NUXT_APP_BASE_URL: ${{ steps.pages.outputs.base_path }}');
+        expect(workflow).toContain('NUXT_CONTENT_PATH: "${{ github.workspace }}"');
+        expect(workflow).toContain('CONTENT_DIR: "${{ github.workspace }}"');
+        expect(workflow).toContain('MDSITE_CONFIG_PATH: "${{ github.workspace }}/mdsite.yml"');
+        expect(workflow).toContain('cache-dependency-path: "renderer/package-lock.json"');
+        expect(workflow).toContain('name: Setup mdsite renderer');
+        expect(workflow).toContain('npm install --no-save mdsite');
+        expect(workflow).toContain("node_modules', 'mdsite', 'mdsite-nuxt");
+        expect(workflow).toContain('renderer/build/site');
+        expect(workflow).toContain('path: "./renderer/build/site/public"');
+        expect(workflow).toContain('run: npm run generate');
+        expect(workflow).not.toContain('npm start -- --generate');
+        expect(workflow).toContain('actions/upload-pages-artifact@v3');
+        expect(workflow).toContain('actions/deploy-pages@v4');
+        expect(runForegroundMock).toHaveBeenCalledTimes(1);
+        expect(runForegroundMock).toHaveBeenCalledWith('npm', ['run', 'prepare:renderer'], rendererDir, expect.objectContaining({
+            CONTENT_DIR: contentDir,
+            MDSITE_CONFIG_PATH: path.join(contentDir, 'mdsite.yml'),
+            NUXT_CONTENT_PATH: contentDir
+        }));
+    });
+    it('writes GitHub workflow paths for a root config with content.path', async () => {
+        const configDir = await mkdtemp(path.join(os.tmpdir(), 'mdsite-prepare-'));
+        tempDirs.push(configDir);
+        const contentDir = path.join(configDir, 'docs');
+        const rendererDir = path.join(configDir, 'renderer');
+        await mkdir(path.join(contentDir), { recursive: true });
+        await mkdir(path.join(rendererDir, 'node_modules'), { recursive: true });
+        await writeFile(path.join(configDir, 'mdsite.yml'), [
+            'content:',
+            '  path: docs',
+            'site:',
+            '  name: Root Docs',
+            'server:',
+            '  path: renderer',
+            '  output: build/site',
+            ''
+        ].join('\n'), 'utf8');
+        await writeFile(path.join(contentDir, 'index.md'), '# Root Docs\n', 'utf8');
+        await runPrepareGithubCommand(configDir);
+        const workflow = await readFile(path.join(configDir, '.github', 'workflows', 'deploy.yml'), 'utf8');
+        expect(workflow).toContain('NUXT_CONTENT_PATH: "${{ github.workspace }}/docs"');
+        expect(workflow).toContain('CONTENT_DIR: "${{ github.workspace }}/docs"');
+        expect(workflow).toContain('MDSITE_CONFIG_PATH: "${{ github.workspace }}/mdsite.yml"');
+        expect(workflow).toContain('working-directory: renderer');
+        expect(workflow).toContain('node-version: "24"');
+        expect(workflow).toContain('run: npm run generate');
+        expect(workflow).not.toContain('npm start -- --generate');
+        expect(workflow).toContain('path: "./renderer/build/site/public"');
+        expect(runForegroundMock).toHaveBeenCalledWith('npm', ['run', 'prepare:renderer'], rendererDir, expect.objectContaining({
+            CONTENT_DIR: contentDir,
+            MDSITE_CONFIG_PATH: path.join(configDir, 'mdsite.yml'),
+            NUXT_CONTENT_PATH: contentDir
+        }));
+    });
+    it('creates the configured renderer before preparing the GitHub workflow', async () => {
+        const contentDir = await mkdtemp(path.join(os.tmpdir(), 'mdsite-prepare-'));
+        tempDirs.push(contentDir);
+        const rendererDir = path.join(contentDir, '.mdsite');
+        await writeFile(path.join(contentDir, 'mdsite.yml'), [
+            'site:',
+            '  name: Default Renderer Docs',
+            'server:',
+            '  path: .mdsite',
+            '  output: .output',
+            ''
+        ].join('\n'), 'utf8');
+        await writeFile(path.join(contentDir, 'index.md'), '# Default Renderer Docs\n', 'utf8');
+        await runPrepareGithubCommand(contentDir);
+        const workflow = await readFile(path.join(contentDir, '.github', 'workflows', 'deploy.yml'), 'utf8');
+        expect(await readFile(path.join(rendererDir, 'package.json'), 'utf8')).toContain('mdsite-nuxt');
+        expect(workflow).toContain('working-directory: .mdsite');
+        expect(workflow).toContain('node-version: "24"');
+        expect(workflow).toContain('cache-dependency-path: ".mdsite/package-lock.json"');
+        expect(workflow).toContain('path: "./.mdsite/.output/public"');
+        expect(workflow).toContain('run: npm run generate');
+        expect(workflow).not.toContain('npm start -- --generate');
+        expect(runForegroundMock).toHaveBeenCalledWith('npm', ['ci'], rendererDir, process.env);
+        expect(runForegroundMock).toHaveBeenCalledWith('npm', ['run', 'prepare:renderer'], rendererDir, expect.objectContaining({
+            CONTENT_DIR: contentDir,
+            MDSITE_CONFIG_PATH: path.join(contentDir, 'mdsite.yml'),
+            NUXT_CONTENT_PATH: contentDir
+        }));
+    });
+});
+//# sourceMappingURL=prepare.test.js.map

package/dist/commands/prepare.test.js.map

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

package/dist/commands/preview.d.ts

@@ -0,0 +1,5 @@
+interface PreviewCommandOptions {
+    detached?: boolean;
+}
+export declare function runPreviewCommand(contentDir: string, options?: PreviewCommandOptions): Promise<string | undefined>;
+export {};

package/dist/commands/preview.js

@@ -0,0 +1,62 @@
+import { loadMdsiteConfig } from '../config/mdsite-config.js';
+import { openUrlInBrowser, waitForTcpPort } from '../process/child-process.js';
+import { getRuntimeLogPath, isProcessRunning, readRuntimeState, writeRuntimeState } from '../process/runtime-state.js';
+import { ensurePreviewArtifacts, ensureRendererDependencies, prepareRenderer, previewRendererForeground, previewRendererInBackground } from '../renderer/mdsite-nuxt.js';
+export async function runPreviewCommand(contentDir, options = {}) {
+    if (options.detached) {
+        return runDetachedPreviewCommand(contentDir);
+    }
+    const loaded = await loadMdsiteConfig(contentDir);
+    const { rendererDir, rendererEnv } = await prepareRenderer(loaded.contentDir, loaded.config, loaded);
+    await ensureRendererDependencies(rendererDir);
+    await ensurePreviewArtifacts(rendererDir);
+    await previewRendererForeground(rendererDir, getPreviewEnv(rendererEnv));
+    return undefined;
+}
+async function runDetachedPreviewCommand(contentDir) {
+    const existingState = await readRuntimeState(contentDir, 'preview');
+    if (existingState && isProcessRunning(existingState.pid)) {
+        throw new Error(`mdsite preview is already running with PID ${existingState.pid}.`);
+    }
+    const loaded = await loadMdsiteConfig(contentDir);
+    const { rendererDir, rendererEnv } = await prepareRenderer(loaded.contentDir, loaded.config, loaded);
+    await ensureRendererDependencies(rendererDir);
+    await ensurePreviewArtifacts(rendererDir);
+    const previewEnv = getPreviewEnv(rendererEnv);
+    const logPath = getRuntimeLogPath(contentDir, 'preview');
+    const pid = await previewRendererInBackground(rendererDir, previewEnv, logPath);
+    const previewUrl = getPreviewUrl(previewEnv);
+    await writeRuntimeState(contentDir, {
+        kind: 'preview',
+        pid,
+        logPath,
+        rendererDir,
+        contentDir,
+        command: ['npm', 'run', 'preview'],
+        startedAt: new Date().toISOString()
+    });
+    const previewReady = await waitForTcpPort(previewEnv.HOST ?? 'localhost', Number.parseInt(previewEnv.PORT ?? '3000', 10)).catch(() => false);
+    if (previewReady) {
+        await openUrlInBrowser(previewUrl);
+    }
+    return `mdsite preview running in background (PID ${pid}). URL: ${previewUrl} Log: ${logPath}`;
+}
+function getPreviewUrl(env) {
+    const host = env.NUXT_HOST ?? env.HOST ?? 'localhost';
+    const port = env.NUXT_PORT ?? env.PORT ?? '3000';
+    return `http://${host}:${port}`;
+}
+function getPreviewEnv(env) {
+    const host = env.NUXT_HOST ?? env.HOST ?? 'localhost';
+    const port = env.NUXT_PORT ?? env.PORT ?? '3000';
+    return {
+        ...env,
+        NUXT_HOST: host,
+        NUXT_PORT: port,
+        HOST: host,
+        PORT: port,
+        NITRO_HOST: host,
+        NITRO_PORT: port
+    };
+}
+//# sourceMappingURL=preview.js.map

package/dist/commands/preview.js.map

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

package/dist/commands/start.d.ts

@@ -0,0 +1,5 @@
+interface StartCommandOptions {
+    detached?: boolean;
+}
+export declare function runStartCommand(contentDir: string, options?: StartCommandOptions): Promise<string | undefined>;
+export {};

package/dist/commands/start.js

@@ -0,0 +1,50 @@
+import { loadMdsiteConfig } from '../config/mdsite-config.js';
+import { openUrlInBrowser, waitForTcpPort } from '../process/child-process.js';
+import { getRuntimeLogPath, isProcessRunning, readRuntimeState, writeRuntimeState } from '../process/runtime-state.js';
+import { ensureRendererDependencies, prepareRenderer, startRendererForeground, startRendererInBackground } from '../renderer/mdsite-nuxt.js';
+export async function runStartCommand(contentDir, options = {}) {
+    if (options.detached) {
+        return runDetachedStartCommand(contentDir);
+    }
+    const loaded = await loadMdsiteConfig(contentDir);
+    const { rendererDir, rendererEnv } = await prepareRenderer(loaded.contentDir, loaded.config, loaded);
+    await ensureRendererDependencies(rendererDir);
+    await startRendererForeground(rendererDir, rendererEnv);
+    return undefined;
+}
+async function runDetachedStartCommand(contentDir) {
+    const existingState = await readRuntimeState(contentDir, 'start');
+    if (existingState && isProcessRunning(existingState.pid)) {
+        throw new Error(`mdsite start is already running with PID ${existingState.pid}.`);
+    }
+    const loaded = await loadMdsiteConfig(contentDir);
+    const { rendererDir, rendererEnv } = await prepareRenderer(loaded.contentDir, loaded.config, loaded);
+    await ensureRendererDependencies(rendererDir);
+    const logPath = getRuntimeLogPath(contentDir, 'start');
+    const pid = await startRendererInBackground(rendererDir, rendererEnv, logPath);
+    const startUrl = getStartUrl(rendererEnv);
+    await writeRuntimeState(contentDir, {
+        kind: 'start',
+        pid,
+        logPath,
+        rendererDir,
+        contentDir,
+        command: ['npm', 'run', 'dev'],
+        startedAt: new Date().toISOString()
+    });
+    const startReady = await waitForTcpPort(getStartHost(rendererEnv), Number.parseInt(getStartPort(rendererEnv), 10)).catch(() => false);
+    if (startReady) {
+        await openUrlInBrowser(startUrl);
+    }
+    return `mdsite start running in background (PID ${pid}). Log: ${logPath}`;
+}
+function getStartUrl(env) {
+    return `http://${getStartHost(env)}:${getStartPort(env)}`;
+}
+function getStartHost(env) {
+    return env.NUXT_HOST ?? env.HOST ?? 'localhost';
+}
+function getStartPort(env) {
+    return env.NUXT_PORT ?? env.PORT ?? '3000';
+}
+//# sourceMappingURL=start.js.map

package/dist/commands/start.js.map

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

package/dist/commands/stop.d.ts

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

package/dist/commands/stop.js

@@ -0,0 +1,26 @@
+import { clearRuntimeState, readRuntimeState } from '../process/runtime-state.js';
+import { stopProcess } from '../process/child-process.js';
+export async function runStopCommand(contentDir) {
+    const states = await Promise.all([
+        readRuntimeState(contentDir, 'start'),
+        readRuntimeState(contentDir, 'preview')
+    ]);
+    const messages = [];
+    for (const state of states) {
+        if (!state) {
+            continue;
+        }
+        const stopped = await stopProcess(state.pid);
+        await clearRuntimeState(contentDir, state.kind);
+        if (stopped) {
+            messages.push(`Stopped ${state.kind} process ${state.pid}.`);
+            continue;
+        }
+        messages.push(`Removed stale ${state.kind} state for PID ${state.pid}.`);
+    }
+    if (messages.length === 0) {
+        return 'Nothing is running.';
+    }
+    return messages.join(' ');
+}
+//# sourceMappingURL=stop.js.map

package/dist/commands/stop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.js","sourceRoot":"","sources":["../../src/commands/stop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAEzD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,UAAkB;IACrD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC/B,gBAAgB,CAAC,UAAU,EAAE,OAAO,CAAC;QACrC,gBAAgB,CAAC,UAAU,EAAE,SAAS,CAAC;KACxC,CAAC,CAAA;IAEF,MAAM,QAAQ,GAAa,EAAE,CAAA;IAE7B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,SAAQ;QACV,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC5C,MAAM,iBAAiB,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;QAE/C,IAAI,OAAO,EAAE,CAAC;YACZ,QAAQ,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,IAAI,YAAY,KAAK,CAAC,GAAG,GAAG,CAAC,CAAA;YAC5D,SAAQ;QACV,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC,iBAAiB,KAAK,CAAC,IAAI,kBAAkB,KAAK,CAAC,GAAG,GAAG,CAAC,CAAA;IAC1E,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,qBAAqB,CAAA;IAC9B,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC3B,CAAC"}

package/dist/commands/workflows.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commands/workflows.test.js

@@ -0,0 +1,183 @@
+import { access, mkdir, mkdtemp, readFile, rm, writeFile } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+const waitForTcpPortMock = vi.hoisted(() => vi.fn());
+vi.mock('../process/child-process.js', () => ({
+    openUrlInBrowser: vi.fn(),
+    runBackground: vi.fn(),
+    runForeground: vi.fn(),
+    waitForTcpPort: waitForTcpPortMock,
+    stopProcess: vi.fn()
+}));
+import { serializeMdsiteConfig } from '../config/mdsite-config.js';
+import { openUrlInBrowser, stopProcess, waitForTcpPort, runBackground, runForeground } from '../process/child-process.js';
+import { readRuntimeState } from '../process/runtime-state.js';
+import { runGenerateCommand } from './generate.js';
+import { runInitCommand } from './init.js';
+import { runPreviewCommand } from './preview.js';
+import { runStartCommand } from './start.js';
+import { runStopCommand } from './stop.js';
+const runBackgroundMock = vi.mocked(runBackground);
+const runForegroundMock = vi.mocked(runForeground);
+const openUrlInBrowserMock = vi.mocked(openUrlInBrowser);
+const stopProcessMock = vi.mocked(stopProcess);
+const waitForTcpPortMocked = vi.mocked(waitForTcpPort);
+const tempDirs = [];
+async function makeTempDir() {
+    const dir = await mkdtemp(path.join(os.tmpdir(), 'mdsite-workflows-'));
+    tempDirs.push(dir);
+    return dir;
+}
+async function createContentDir() {
+    const contentDir = await makeTempDir();
+    await mkdir(path.join(contentDir, 'docs'), { recursive: true });
+    await writeFile(path.join(contentDir, 'index.md'), '# Workspace Docs\n', 'utf8');
+    await writeFile(path.join(contentDir, 'docs', 'guide.md'), '# Guide\n', 'utf8');
+    return contentDir;
+}
+async function createRendererDir(contentDir, withNodeModules = true) {
+    const rendererDir = path.join(contentDir, '.renderer');
+    await mkdir(rendererDir, { recursive: true });
+    if (withNodeModules) {
+        await mkdir(path.join(rendererDir, 'node_modules'), { recursive: true });
+    }
+    return rendererDir;
+}
+async function writeConfig(contentDir, overrides = {}) {
+    const config = {
+        favicon: '',
+        features: { bibleTooltips: true, sourceEdit: true },
+        menu: [],
+        server: {
+            output: '.output',
+            path: '.renderer',
+            repo: 'https://github.com/life-and-dev/mdsite',
+            ...overrides.server
+        },
+        site: {
+            canonical: '',
+            name: 'Workspace Docs',
+            ...overrides.site
+        },
+        themes: {
+            light: { colors: {} },
+            dark: { colors: {} }
+        },
+        ...overrides
+    };
+    await writeFile(path.join(contentDir, 'mdsite.yml'), serializeMdsiteConfig(config), 'utf8');
+    return config;
+}
+afterEach(async () => {
+    vi.restoreAllMocks();
+    await Promise.all(tempDirs.splice(0).map((dir) => rm(dir, { recursive: true, force: true })));
+});
+describe('CLI workflow coverage', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        openUrlInBrowserMock.mockResolvedValue(true);
+        waitForTcpPortMocked.mockResolvedValue(true);
+    });
+    it('runInitCommand creates a valid mdsite.yml for the current markdown directory', async () => {
+        const contentDir = await createContentDir();
+        await expect(runInitCommand(contentDir)).resolves.toBeUndefined();
+        const configPath = path.join(contentDir, 'mdsite.yml');
+        const configText = await readFile(configPath, 'utf8');
+        expect(configText).toContain('name: Workspace Docs');
+        expect(configText).toContain('output: .output');
+        expect(configText).toContain('- docs/guide');
+    });
+    it('runStartCommand in detached mode prepares the renderer against the current markdown directory and tracks the background process', async () => {
+        const contentDir = await createContentDir();
+        const rendererDir = await createRendererDir(contentDir);
+        await writeConfig(contentDir);
+        runBackgroundMock.mockResolvedValueOnce(4321);
+        await expect(runStartCommand(contentDir, { detached: true })).resolves.toBe(`mdsite start running in background (PID 4321). Log: ${path.join(contentDir, '.mdsite-runtime', 'start.log')}`);
+        expect(runBackgroundMock).toHaveBeenCalledWith('npm', ['run', 'dev'], rendererDir, expect.objectContaining({
+            NUXT_CONTENT_PATH: contentDir,
+            CONTENT_DIR: contentDir,
+            MDSITE_CONFIG_PATH: path.join(contentDir, 'mdsite.yml')
+        }), path.join(contentDir, '.mdsite-runtime', 'start.log'));
+        expect(waitForTcpPortMocked).toHaveBeenCalledWith('localhost', 3000);
+        expect(openUrlInBrowserMock).toHaveBeenCalledWith('http://localhost:3000');
+        expect(await readFile(path.join(contentDir, '_menu.yml'), 'utf8')).toContain('- docs/guide');
+        expect(await readFile(path.join(rendererDir, '.env'), 'utf8')).toContain(`NUXT_CONTENT_PATH=${JSON.stringify(contentDir)}`);
+        expect(await readFile(path.join(rendererDir, 'content.config.yml'), 'utf8')).toContain('siteName: Workspace Docs');
+        await expect(readRuntimeState(contentDir, 'start')).resolves.toEqual(expect.objectContaining({
+            pid: 4321,
+            rendererDir,
+            contentDir,
+            command: ['npm', 'run', 'dev']
+        }));
+    });
+    it('runGenerateCommand writes generated output to the configured destination', async () => {
+        const contentDir = await createContentDir();
+        const rendererDir = await createRendererDir(contentDir);
+        await writeConfig(contentDir, {
+            server: {
+                output: 'public/site',
+                path: '.renderer',
+                repo: 'https://github.com/life-and-dev/mdsite'
+            }
+        });
+        runForegroundMock.mockImplementation(async (_command, args, cwd) => {
+            if (args[0] === 'run' && args[1] === 'generate') {
+                await mkdir(path.join(cwd, '.output', 'public'), { recursive: true });
+                await writeFile(path.join(cwd, '.output', 'public', 'index.html'), '<h1>generated</h1>', 'utf8');
+            }
+        });
+        await expect(runGenerateCommand(contentDir)).resolves.toBe(`Generated site synced to ${path.join(contentDir, 'public', 'site')}`);
+        expect(await readFile(path.join(contentDir, 'public', 'site', 'index.html'), 'utf8')).toBe('<h1>generated</h1>');
+        expect(runForegroundMock).toHaveBeenCalledWith('npm', ['run', 'generate'], rendererDir, expect.objectContaining({
+            NUXT_CONTENT_PATH: contentDir
+        }));
+    });
+    it('runPreviewCommand works after runGenerateCommand creates only the public artifact', async () => {
+        const contentDir = await createContentDir();
+        const rendererDir = await createRendererDir(contentDir);
+        await writeConfig(contentDir);
+        runForegroundMock.mockImplementation(async (_command, args, cwd) => {
+            if (args[0] === 'run' && args[1] === 'generate') {
+                await mkdir(path.join(cwd, '.output', 'public'), { recursive: true });
+                await writeFile(path.join(cwd, '.output', 'public', 'index.html'), '<h1>generated</h1>', 'utf8');
+            }
+        });
+        await expect(runGenerateCommand(contentDir)).resolves.toBe(`Generated site synced to ${path.join(contentDir, '.output')}`);
+        runBackgroundMock.mockResolvedValueOnce(2468);
+        stopProcessMock.mockResolvedValueOnce(true);
+        await expect(runPreviewCommand(contentDir, { detached: true })).resolves.toBe(`mdsite preview running in background (PID 2468). URL: http://localhost:3000 Log: ${path.join(contentDir, 'mdsite.log')}`);
+        expect(openUrlInBrowserMock).toHaveBeenCalledWith('http://localhost:3000');
+        await expect(runStopCommand(contentDir)).resolves.toBe('Stopped preview process 2468.');
+        await expect(readRuntimeState(contentDir, 'preview')).resolves.toBeNull();
+    });
+    it('rejects start when mdsite.yml is missing', async () => {
+        const contentDir = await createContentDir();
+        await expect(runStartCommand(contentDir)).rejects.toThrow(`Missing mdsite.yml in ${contentDir}. Run \`mdsite init\` first.`);
+    });
+    it('rejects invalid config files before starting the renderer', async () => {
+        const contentDir = await createContentDir();
+        await writeFile(path.join(contentDir, 'mdsite.yml'), 'site: [broken\n', 'utf8');
+        await expect(runStartCommand(contentDir)).rejects.toThrow();
+        await expect(readRuntimeState(contentDir, 'start')).resolves.toBeNull();
+    });
+    it('surfaces install failures and does not persist start state', async () => {
+        const contentDir = await createContentDir();
+        await createRendererDir(contentDir, false);
+        await writeConfig(contentDir);
+        runForegroundMock.mockRejectedValueOnce(new Error('npm install failed'));
+        await expect(runStartCommand(contentDir)).rejects.toThrow('npm install failed');
+        await expect(readRuntimeState(contentDir, 'start')).resolves.toBeNull();
+    });
+    it('does not leave tracked start state or logs behind when foreground renderer fails to boot', async () => {
+        const contentDir = await createContentDir();
+        await createRendererDir(contentDir);
+        await writeConfig(contentDir);
+        runForegroundMock.mockRejectedValueOnce(new Error('Failed to start npm run dev.'));
+        await expect(runStartCommand(contentDir)).rejects.toThrow('Failed to start npm run dev.');
+        await expect(readRuntimeState(contentDir, 'start')).resolves.toBeNull();
+        await expect(access(path.join(contentDir, '.mdsite-runtime', 'start.json'))).rejects.toThrow();
+        await expect(access(path.join(contentDir, '.mdsite-runtime', 'start.log'))).rejects.toThrow();
+    });
+});
+//# sourceMappingURL=workflows.test.js.map