@life-and-dev/mdsite 0.0.3

package/README.md

@@ -0,0 +1,228 @@
+![MDsite](docs/logo.svg)
+
+# MDsite
+
+## Current workflow
+
+Use the CLI from the root package, then operate on your markdown project directory:
+
+1. Build the local CLI in this repository.
+2. Change into the markdown/content directory you want to serve.
+3. Invoke the built CLI from this repository path, or use a local alias/link that points to it.
+4. Run `init` once to create `mdsite.yml`.
+5. Run `start` for foreground local development, or `start -d` for a tracked background process that opens the browser after the server is ready.
+6. Run `generate` to build static output.
+7. Run `preview` after `generate` for a foreground local preview, or `preview -d` for a tracked background preview.
+8. Run `stop` to stop tracked detached `start` and `preview` processes.
+
+## Documentation location
+
+[Primary project documentation](docs/index.md) and demo content belong in this repository root, such as this `README.md` and `docs/`. Keep `mdsite-nuxt/` documentation limited to renderer internals.
+
+## Implemented commands
+
+```text
+mdsite help
+mdsite version
+mdsite init
+mdsite start
+mdsite generate
+mdsite preview
+mdsite stop
+mdsite prepare github
+```
+
+All commands operate on the **current working directory** as the content/project directory.
+`version` prints the CLI version from the root `package.json`; run it as `mdsite version` or `node /path/to/md-site/dist/index.js version`.
+`prepare github` also requires `mdsite.yml` and writes a GitHub Pages workflow for that content directory.
+
+## Local Development Setup
+
+This repository currently documents a **local-only** workflow:
+
+```bash
+# in this repository
+npm install
+npm run build
+npm run install-alias
+```
+
+Restart CLI terminal session.
+
+Then run the `mdsite-dev` alias from any directory containing `mdsite.yml`:
+
+```bash
+mdsite-dev start
+```
+
+Open http://localhost:3000/. The command runs in the foreground and writes renderer output to the terminal; closing the terminal or interrupting the command stops the process.
+
+To run the demo as a tracked background process instead, use `mdsite-dev start -d` or `mdsite-dev start --detached`. Detached start logs to `.mdsite-runtime/start.log` in the content directory and opens the browser automatically after the server is ready.
+
+To stop a detached local preview:
+
+```bash
+mdsite-dev stop
+```
+
+> [!NOTE] When using `mdsite-dev` locally (e.g. `npm run install-alias`), the CLI utility is called `mdsite-dev`. When installed globally via npm registry, the CLI utility is called `mdsite` instead.
+
+## Supported CLI flow
+
+### Check the CLI version
+
+```bash
+mdsite version
+```
+
+`version` prints the CLI version from the root `package.json`.
+
+### 1. Initialize a content directory
+
+```bash
+mdsite init
+```
+
+`init` creates `mdsite.yml` in the current directory and derives defaults from local markdown files.
+
+### 2. Start local development
+
+```bash
+mdsite start
+```
+
+`start` requires `mdsite.yml`, prepares renderer compatibility files, installs renderer dependencies when `node_modules` is missing, and runs the renderer in the foreground with terminal output. Closing the terminal or interrupting the command stops the foreground process.
+
+Use `mdsite start -d` or `mdsite start --detached` to run a tracked background renderer instead. Detached start logs to `.mdsite-runtime/start.log` in the content directory and opens the browser automatically after the server is ready.
+
+### 3. Generate static output
+
+```bash
+mdsite generate
+```
+
+`generate` requires `mdsite.yml` and writes the generated site to `server.output` under the content directory.
+
+### 4. Preview generated output
+
+```bash
+mdsite preview
+```
+
+`preview` is a **post-generate** local preview step. It requires `mdsite.yml` and an existing generated renderer build.
+By default, it runs in the foreground with terminal output. Closing the terminal or interrupting the command stops the foreground preview.
+
+Use `mdsite preview -d` or `mdsite preview --detached` to run a tracked background preview instead. Detached preview logs to `mdsite.log` in the content directory and writes runtime state under `.mdsite-runtime/`.
+
+### 5. Stop background processes
+
+```bash
+mdsite stop
+```
+
+`stop` is intended for initialized content directories and stops tracked detached `start` and `preview` background processes for the current content directory, not foreground processes.
+
+### 6. Prepare a GitHub Pages workflow
+
+```bash
+mdsite prepare github
+```
+
+`prepare github` requires `mdsite.yml`, prepares the configured local renderer, and writes `.github/workflows/deploy.yml` in the current content directory. The generated workflow uses the configured local `server.path` during GitHub Actions; it does not add a renderer clone or pull workflow.
+
+## Renderer resolution
+
+Renderer resolution is currently **local-only**:
+
+- If `mdsite.yml` sets `server.path`, the CLI first looks for that path **relative to the content directory**.
+- If that directory is not present, the CLI falls back to the checked-in repository renderer at `mdsite-nuxt/`.
+- If the renderer's `node_modules` directory is missing, the CLI runs `npm install` in the renderer directory.
+- `prepare github` requires the configured `server.path` renderer directory to exist; unlike `start`, `generate`, and `preview`, it does not fall back to the checked-in renderer when that configured path is absent.
+
+Current documentation does **not** describe clone/pull behavior as active usage.
+
+## Expected content project layout
+
+Before initialization:
+
+```text
+your-content/
+├── index.md
+└── other-pages.md
+```
+
+After `mdsite init`, `mdsite generate`, and optional tracked background commands:
+
+```text
+your-content/
+├── mdsite.yml
+├── _menu.yml                # orchestration/compatibility artifact
+├── .mdsite-runtime/         # created when tracked background processes are started
+├── .output/                 # created by mdsite generate, or server.output
+├── index.md
+└── other-pages.md
+```
+
+The CLI also writes renderer compatibility files such as `_menu.yml`, `mdsite-nuxt/.env`, and `mdsite-nuxt/content.config.yml` as part of orchestration. Tracked background commands write runtime files under `.mdsite-runtime/`.
+
+## Migration notes for existing users
+
+If you previously used the legacy root workflow:
+
+- Replace `npm start` with `node /path/to/md-site/dist/index.js start`.
+- Replace `npm run generate` with `node /path/to/md-site/dist/index.js generate`.
+- Replace `npm run preview` with `node /path/to/md-site/dist/index.js preview` after `node /path/to/md-site/dist/index.js generate`.
+- Replace legacy root/domain config assumptions with a single `mdsite.yml` in the content directory.
+- Treat `content.config.yml` and domain-specific `*.config.yml` files as legacy reference, not current setup.
+- Keep custom markdown content, menus, and theme values, but move current configuration intent into `mdsite.yml`.
+
+## Troubleshooting
+
+### `mdsite.yml` is missing
+
+If `start`, `generate`, `preview`, or `stop` are not behaving as expected, first confirm you are in the intended content directory and that `mdsite.yml` exists there:
+
+```bash
+mdsite init
+```
+
+### Renderer directory issues
+
+- If `server.path` is set, confirm it points to a renderer directory relative to the content directory.
+- If that path does not exist, the CLI falls back to the checked-in `mdsite-nuxt` directory in this repository.
+- If neither renderer location exists, the CLI cannot run.
+- For `prepare github`, the configured `server.path` must exist because workflow generation uses the configured renderer path directly.
+
+### Renderer dependencies missing
+
+If the renderer has no `node_modules`, the CLI runs `npm install` in the renderer directory automatically. If that install fails, fix the renderer dependency issue and rerun the command.
+
+### Preview fails
+
+Run `mdsite generate` first. `preview` requires an existing generated renderer build.
+
+### Config problems
+
+- `mdsite.yml` must be valid YAML.
+- `server.output` is resolved under the content directory.
+- `server.path` is resolved relative to the content directory.
+- If `favicon` is configured, the referenced file must exist.
+
+## Configuration reference
+
+`mdsite.yml` is the only active content-directory configuration file. `mdsite init` creates it and fills defaults from local markdown files where possible.
+
+| Key                      | Default                                  | Description                                                                                                                                               |
+| ------------------------ | ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `favicon`                | empty string                             | Optional favicon path relative to the content directory.                                                                                                  |
+| `features.bibleTooltips` | `true`                                   | Enables renderer Bible tooltip support.                                                                                                                   |
+| `features.sourceEdit`    | `true`                                   | Enables renderer source-edit support.                                                                                                                     |
+| `menu`                   | derived from markdown files              | Menu structure used to generate `_menu.yml`.                                                                                                              |
+| `server.output`          | `.output`                                | Static output path under the content directory.                                                                                                           |
+| `server.path`            | `.mdsite`                                | Renderer path relative to the content directory. Local commands fall back to checked-in `mdsite-nuxt/` when this path is absent, except `prepare github`. |
+| `server.repo`            | `https://github.com/life-and-dev/mdsite` | Stored for compatibility and generated renderer config. It is not used for active clone/pull behaviour.                                                   |
+| `site.canonical`         | empty string                             | Canonical site URL passed to the renderer.                                                                                                                |
+| `site.name`              | derived from `index.md` or directory     | Site name passed to the renderer.                                                                                                                         |
+| `themes.light.colors`    | built-in palette                         | Light theme colour overrides.                                                                                                                             |
+| `themes.dark.colors`     | built-in palette                         | Dark theme colour overrides.                                                                                                                              |
+

package/bin/mdsite.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import "../dist/index.js";

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

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

package/dist/commands/commands.test.js

@@ -0,0 +1,302 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+vi.mock('node:fs/promises', () => ({
+    access: vi.fn(),
+    cp: vi.fn(),
+    rm: vi.fn(),
+    writeFile: vi.fn()
+}));
+vi.mock('../config/mdsite-config.js', () => ({
+    buildDefaultMdsiteConfig: vi.fn(),
+    loadMdsiteConfig: vi.fn(),
+    resolveContentOutputPath: vi.fn(),
+    serializeMdsiteConfig: vi.fn()
+}));
+vi.mock('../process/runtime-state.js', () => ({
+    clearRuntimeState: vi.fn(),
+    getRuntimeLogPath: vi.fn(),
+    isProcessRunning: vi.fn(),
+    readRuntimeState: vi.fn(),
+    writeRuntimeState: vi.fn()
+}));
+vi.mock('../process/child-process.js', () => ({
+    openUrlInBrowser: vi.fn(),
+    stopProcess: vi.fn(),
+    waitForTcpPort: vi.fn()
+}));
+vi.mock('../renderer/mdsite-nuxt.js', () => ({
+    ensurePreviewArtifacts: vi.fn(),
+    ensureRendererDependencies: vi.fn(),
+    generateRenderer: vi.fn(),
+    getRendererGeneratedOutputPath: vi.fn(),
+    prepareRenderer: vi.fn(),
+    previewRendererForeground: vi.fn(),
+    previewRendererInBackground: vi.fn(),
+    startRendererForeground: vi.fn(),
+    startRendererInBackground: vi.fn()
+}));
+import { access, cp, 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, getRendererGeneratedOutputPath, prepareRenderer, previewRendererForeground, previewRendererInBackground, startRendererForeground, startRendererInBackground } from '../renderer/mdsite-nuxt.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 accessMock = vi.mocked(access);
+const cpMock = vi.mocked(cp);
+const rmMock = vi.mocked(rm);
+const writeFileMock = vi.mocked(writeFile);
+const buildDefaultConfigMock = vi.mocked(buildDefaultMdsiteConfig);
+const loadConfigMock = vi.mocked(loadMdsiteConfig);
+const resolveOutputMock = vi.mocked(resolveContentOutputPath);
+const serializeConfigMock = vi.mocked(serializeMdsiteConfig);
+const clearRuntimeStateMock = vi.mocked(clearRuntimeState);
+const getRuntimeLogPathMock = vi.mocked(getRuntimeLogPath);
+const isProcessRunningMock = vi.mocked(isProcessRunning);
+const readRuntimeStateMock = vi.mocked(readRuntimeState);
+const writeRuntimeStateMock = vi.mocked(writeRuntimeState);
+const ensurePreviewArtifactsMock = vi.mocked(ensurePreviewArtifacts);
+const ensureRendererDependenciesMock = vi.mocked(ensureRendererDependencies);
+const generateRendererMock = vi.mocked(generateRenderer);
+const getRendererGeneratedOutputPathMock = vi.mocked(getRendererGeneratedOutputPath);
+const prepareRendererMock = vi.mocked(prepareRenderer);
+const previewRendererForegroundMock = vi.mocked(previewRendererForeground);
+const previewRendererInBackgroundMock = vi.mocked(previewRendererInBackground);
+const startRendererForegroundMock = vi.mocked(startRendererForeground);
+const startRendererInBackgroundMock = vi.mocked(startRendererInBackground);
+const stopProcessMock = vi.mocked(stopProcess);
+const openUrlInBrowserMock = vi.mocked(openUrlInBrowser);
+const waitForTcpPortMock = vi.mocked(waitForTcpPort);
+const loadedConfig = {
+    config: {
+        favicon: '',
+        features: { bibleTooltips: true, sourceEdit: true },
+        menu: [],
+        server: { output: '.output', path: '.renderer', repo: 'repo' },
+        site: { canonical: '', name: 'Docs' },
+        themes: { light: { colors: {} }, dark: { colors: {} } }
+    },
+    configDir: '/content',
+    configPath: '/content/mdsite.yml',
+    contentDir: '/content'
+};
+describe('command helpers', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        vi.useRealTimers();
+        loadConfigMock.mockResolvedValue(loadedConfig);
+        prepareRendererMock.mockResolvedValue({ rendererDir: '/renderer', rendererEnv: { TEST: '1' } });
+        getRuntimeLogPathMock.mockImplementation((contentDir, kind) => {
+            if (kind === 'preview') {
+                return `${contentDir}/mdsite.log`;
+            }
+            return `${contentDir}/.mdsite-runtime/${kind}.log`;
+        });
+        resolveOutputMock.mockReturnValue('/content/public');
+        getRendererGeneratedOutputPathMock.mockReturnValue('/renderer/.output/public');
+        openUrlInBrowserMock.mockResolvedValue(true);
+        waitForTcpPortMock.mockResolvedValue(true);
+    });
+    it('runInitCommand creates mdsite.yml only when it does not already exist', async () => {
+        accessMock.mockRejectedValueOnce(new Error('missing'));
+        buildDefaultConfigMock.mockResolvedValue(loadedConfig.config);
+        serializeConfigMock.mockReturnValue('serialized-config');
+        await expect(runInitCommand('/content')).resolves.toBeUndefined();
+        expect(buildDefaultConfigMock).toHaveBeenCalledWith('/content');
+        expect(writeFileMock).toHaveBeenCalledWith('/content/mdsite.yml', 'serialized-config', 'utf8');
+        accessMock.mockResolvedValueOnce(undefined);
+        await expect(runInitCommand('/content')).rejects.toThrow('mdsite.yml already exists at /content/mdsite.yml.');
+    });
+    it('runStartCommand starts the renderer in the foreground by default without runtime metadata', async () => {
+        await expect(runStartCommand('/content')).resolves.toBeUndefined();
+        expect(readRuntimeStateMock).not.toHaveBeenCalled();
+        expect(getRuntimeLogPathMock).not.toHaveBeenCalled();
+        expect(startRendererInBackgroundMock).not.toHaveBeenCalled();
+        expect(writeRuntimeStateMock).not.toHaveBeenCalled();
+        expect(ensureRendererDependenciesMock).toHaveBeenCalledWith('/renderer');
+        expect(startRendererForegroundMock).toHaveBeenCalledWith('/renderer', { TEST: '1' });
+    });
+    it('runStartCommand rejects detached mode when an active start process is already running', async () => {
+        readRuntimeStateMock.mockResolvedValueOnce({ kind: 'start', pid: 44 });
+        isProcessRunningMock.mockReturnValueOnce(true);
+        await expect(runStartCommand('/content', { detached: true })).rejects.toThrow('mdsite start is already running with PID 44.');
+        expect(loadConfigMock).not.toHaveBeenCalled();
+    });
+    it('runStartCommand starts detached renderer for stale state and persists fresh runtime metadata', async () => {
+        vi.useFakeTimers();
+        vi.setSystemTime(new Date('2026-04-10T12:34:56.000Z'));
+        readRuntimeStateMock.mockResolvedValueOnce({ kind: 'start', pid: 44 });
+        isProcessRunningMock.mockReturnValueOnce(false);
+        startRendererInBackgroundMock.mockResolvedValueOnce(777);
+        await expect(runStartCommand('/content', { detached: true })).resolves.toBe('mdsite start running in background (PID 777). Log: /content/.mdsite-runtime/start.log');
+        expect(ensureRendererDependenciesMock).toHaveBeenCalledWith('/renderer');
+        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);
+        expect(openUrlInBrowserMock).toHaveBeenCalledWith('http://localhost:3000');
+        expect(writeRuntimeStateMock).toHaveBeenCalledWith('/content', expect.objectContaining({
+            kind: 'start',
+            pid: 777,
+            rendererDir: '/renderer',
+            command: ['npm', 'run', 'dev'],
+            startedAt: '2026-04-10T12:34:56.000Z'
+        }));
+    });
+    it('runStartCommand uses the configured start host and port when opening detached start', async () => {
+        readRuntimeStateMock.mockResolvedValueOnce(null);
+        prepareRendererMock.mockResolvedValueOnce({
+            rendererDir: '/renderer',
+            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 start running in background (PID 778). Log: /content/.mdsite-runtime/start.log');
+        expect(waitForTcpPortMock).toHaveBeenCalledWith('start.local', 4321);
+        expect(openUrlInBrowserMock).toHaveBeenCalledWith('http://start.local:4321');
+    });
+    it('runStartCommand does not open the browser when detached start readiness times out', async () => {
+        readRuntimeStateMock.mockResolvedValueOnce(null);
+        startRendererInBackgroundMock.mockResolvedValueOnce(779);
+        waitForTcpPortMock.mockResolvedValueOnce(false);
+        await expect(runStartCommand('/content', { detached: true })).resolves.toBe('mdsite start running in background (PID 779). Log: /content/.mdsite-runtime/start.log');
+        expect(waitForTcpPortMock).toHaveBeenCalledWith('localhost', 3000);
+        expect(openUrlInBrowserMock).not.toHaveBeenCalled();
+    });
+    it('runStartCommand keeps succeeding when detached start readiness checks fail', async () => {
+        readRuntimeStateMock.mockResolvedValueOnce(null);
+        startRendererInBackgroundMock.mockResolvedValueOnce(780);
+        waitForTcpPortMock.mockRejectedValueOnce(new Error('connect failed'));
+        await expect(runStartCommand('/content', { detached: true })).resolves.toBe('mdsite start running in background (PID 780). Log: /content/.mdsite-runtime/start.log');
+        expect(openUrlInBrowserMock).not.toHaveBeenCalled();
+    });
+    it('runPreviewCommand previews in the foreground by default without runtime metadata', async () => {
+        await expect(runPreviewCommand('/content')).resolves.toBeUndefined();
+        expect(readRuntimeStateMock).not.toHaveBeenCalled();
+        expect(getRuntimeLogPathMock).not.toHaveBeenCalled();
+        expect(previewRendererInBackgroundMock).not.toHaveBeenCalled();
+        expect(writeRuntimeStateMock).not.toHaveBeenCalled();
+        expect(waitForTcpPortMock).not.toHaveBeenCalled();
+        expect(openUrlInBrowserMock).not.toHaveBeenCalled();
+        expect(ensureRendererDependenciesMock).toHaveBeenCalledWith('/renderer');
+        expect(ensurePreviewArtifactsMock).toHaveBeenCalledWith('/renderer');
+        expect(previewRendererForegroundMock).toHaveBeenCalledWith('/renderer', expect.objectContaining({
+            TEST: '1',
+            NUXT_HOST: 'localhost',
+            NUXT_PORT: '3000',
+            HOST: 'localhost',
+            PORT: '3000',
+            NITRO_HOST: 'localhost',
+            NITRO_PORT: '3000'
+        }));
+    });
+    it('runPreviewCommand rejects detached mode when an active preview process is already running', async () => {
+        readRuntimeStateMock.mockResolvedValueOnce({ kind: 'preview', pid: 55 });
+        isProcessRunningMock.mockReturnValueOnce(true);
+        await expect(runPreviewCommand('/content', { detached: true })).rejects.toThrow('mdsite preview is already running with PID 55.');
+        expect(loadConfigMock).not.toHaveBeenCalled();
+    });
+    it('runPreviewCommand enforces preview artifacts and persists preview runtime state in detached mode', async () => {
+        vi.useFakeTimers();
+        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 preview running in background (PID 888). URL: http://localhost:3000 Log: /content/mdsite.log');
+        expect(ensurePreviewArtifactsMock).toHaveBeenCalledWith('/renderer');
+        expect(ensurePreviewArtifactsMock.mock.invocationCallOrder[0]).toBeGreaterThan(ensureRendererDependenciesMock.mock.invocationCallOrder[0] ?? 0);
+        expect(previewRendererInBackgroundMock).toHaveBeenCalledWith('/renderer', expect.objectContaining({
+            TEST: '1',
+            NUXT_HOST: 'localhost',
+            NUXT_PORT: '3000',
+            HOST: 'localhost',
+            PORT: '3000',
+            NITRO_HOST: 'localhost',
+            NITRO_PORT: '3000'
+        }), '/content/mdsite.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);
+        expect(openUrlInBrowserMock).toHaveBeenCalledWith('http://localhost:3000');
+        expect(writeRuntimeStateMock).toHaveBeenCalledWith('/content', expect.objectContaining({
+            kind: 'preview',
+            pid: 888,
+            command: ['npm', 'run', 'preview'],
+            startedAt: '2026-04-10T13:00:00.000Z'
+        }));
+    });
+    it('runPreviewCommand prefers inherited preview host and port values for the detached preview URL', async () => {
+        readRuntimeStateMock.mockResolvedValueOnce(null);
+        prepareRendererMock.mockResolvedValueOnce({
+            rendererDir: '/renderer',
+            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 preview running in background (PID 999). URL: http://preview.local:4321 Log: /content/mdsite.log');
+        expect(previewRendererInBackgroundMock).toHaveBeenCalledWith('/renderer', expect.objectContaining({
+            HOST: 'preview.local',
+            PORT: '4321',
+            NUXT_HOST: 'preview.local',
+            NUXT_PORT: '4321',
+            NITRO_HOST: 'preview.local',
+            NITRO_PORT: '4321'
+        }), '/content/mdsite.log');
+        expect(waitForTcpPortMock).toHaveBeenCalledWith('preview.local', 4321);
+        expect(openUrlInBrowserMock).toHaveBeenCalledWith('http://preview.local:4321');
+    });
+    it('runPreviewCommand falls back to HOST and PORT when NUXT preview values are unset in detached mode', async () => {
+        readRuntimeStateMock.mockResolvedValueOnce(null);
+        prepareRendererMock.mockResolvedValueOnce({
+            rendererDir: '/renderer',
+            rendererEnv: { HOST: '127.0.0.1', PORT: '4173' }
+        });
+        previewRendererInBackgroundMock.mockResolvedValueOnce(1000);
+        await expect(runPreviewCommand('/content', { detached: true })).resolves.toBe('mdsite preview running in background (PID 1000). URL: http://127.0.0.1:4173 Log: /content/mdsite.log');
+        expect(previewRendererInBackgroundMock).toHaveBeenCalledWith('/renderer', expect.objectContaining({
+            HOST: '127.0.0.1',
+            PORT: '4173',
+            NUXT_HOST: '127.0.0.1',
+            NUXT_PORT: '4173',
+            NITRO_HOST: '127.0.0.1',
+            NITRO_PORT: '4173'
+        }), '/content/mdsite.log');
+        expect(waitForTcpPortMock).toHaveBeenCalledWith('127.0.0.1', 4173);
+        expect(openUrlInBrowserMock).toHaveBeenCalledWith('http://127.0.0.1:4173');
+    });
+    it('runPreviewCommand does not open the browser when detached preview readiness times out', async () => {
+        readRuntimeStateMock.mockResolvedValueOnce(null);
+        previewRendererInBackgroundMock.mockResolvedValueOnce(1001);
+        waitForTcpPortMock.mockResolvedValueOnce(false);
+        await expect(runPreviewCommand('/content', { detached: true })).resolves.toBe('mdsite preview running in background (PID 1001). URL: http://localhost:3000 Log: /content/mdsite.log');
+        expect(waitForTcpPortMock).toHaveBeenCalledWith('localhost', 3000);
+        expect(openUrlInBrowserMock).not.toHaveBeenCalled();
+    });
+    it('runPreviewCommand keeps succeeding when detached preview readiness checks fail', async () => {
+        readRuntimeStateMock.mockResolvedValueOnce(null);
+        previewRendererInBackgroundMock.mockResolvedValueOnce(1002);
+        waitForTcpPortMock.mockRejectedValueOnce(new Error('connect failed'));
+        await expect(runPreviewCommand('/content', { detached: true })).resolves.toBe('mdsite preview running in background (PID 1002). URL: http://localhost:3000 Log: /content/mdsite.log');
+        expect(openUrlInBrowserMock).not.toHaveBeenCalled();
+    });
+    it('runGenerateCommand syncs renderer output to the configured destination', async () => {
+        await expect(runGenerateCommand('/content')).resolves.toBe('Generated site synced to /content/public');
+        expect(generateRendererMock).toHaveBeenCalledWith('/renderer', { TEST: '1' });
+        expect(rmMock).toHaveBeenCalledWith('/content/public', { recursive: true, force: true });
+        expect(cpMock).toHaveBeenCalledWith('/renderer/.output/public', '/content/public', { recursive: true, force: true });
+    });
+    it('runGenerateCommand surfaces sync failures with the destination path', async () => {
+        cpMock.mockRejectedValueOnce(new Error('permission denied'));
+        await expect(runGenerateCommand('/content')).rejects.toThrow('Failed to sync generated output to /content/public: permission denied');
+    });
+    it('runStopCommand handles nothing-running, stopped, and stale-state cases', async () => {
+        readRuntimeStateMock.mockResolvedValueOnce(null).mockResolvedValueOnce(null);
+        await expect(runStopCommand('/content')).resolves.toBe('Nothing is running.');
+        readRuntimeStateMock
+            .mockResolvedValueOnce({ kind: 'start', pid: 11 })
+            .mockResolvedValueOnce({ kind: 'preview', pid: 22 });
+        stopProcessMock.mockResolvedValueOnce(true).mockResolvedValueOnce(false);
+        await expect(runStopCommand('/content')).resolves.toBe('Stopped start process 11. Removed stale preview state for PID 22.');
+        expect(clearRuntimeStateMock).toHaveBeenNthCalledWith(1, '/content', 'start');
+        expect(clearRuntimeStateMock).toHaveBeenNthCalledWith(2, '/content', 'preview');
+    });
+});
+//# sourceMappingURL=commands.test.js.map

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

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

package/dist/commands/generate.d.ts

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

package/dist/commands/generate.js

@@ -0,0 +1,20 @@
+import { cp, rm } from 'node:fs/promises';
+import { loadMdsiteConfig, resolveContentOutputPath } from '../config/mdsite-config.js';
+import { ensureRendererDependencies, generateRenderer, getRendererGeneratedOutputPath, prepareRenderer } from '../renderer/mdsite-nuxt.js';
+export async function runGenerateCommand(contentDir) {
+    const loaded = await loadMdsiteConfig(contentDir);
+    const { rendererDir, rendererEnv } = await prepareRenderer(loaded.contentDir, loaded.config, loaded);
+    await ensureRendererDependencies(rendererDir);
+    await generateRenderer(rendererDir, rendererEnv);
+    const rendererOutputPath = getRendererGeneratedOutputPath(rendererDir);
+    const destinationOutputPath = resolveContentOutputPath(loaded.configDir, loaded.config);
+    try {
+        await rm(destinationOutputPath, { recursive: true, force: true });
+        await cp(rendererOutputPath, destinationOutputPath, { recursive: true, force: true });
+    }
+    catch (error) {
+        throw new Error(`Failed to sync generated output to ${destinationOutputPath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return `Generated site synced to ${destinationOutputPath}`;
+}
+//# sourceMappingURL=generate.js.map

package/dist/commands/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAA;AAEzC,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAA;AACvF,OAAO,EAAE,0BAA0B,EAAE,gBAAgB,EAAE,8BAA8B,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAE1I,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,UAAkB;IACzD,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,UAAU,CAAC,CAAA;IACjD,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAEpG,MAAM,0BAA0B,CAAC,WAAW,CAAC,CAAA;IAC7C,MAAM,gBAAgB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAA;IAEhD,MAAM,kBAAkB,GAAG,8BAA8B,CAAC,WAAW,CAAC,CAAA;IACtE,MAAM,qBAAqB,GAAG,wBAAwB,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;IAEvF,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,qBAAqB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QACjE,MAAM,EAAE,CAAC,kBAAkB,EAAE,qBAAqB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IACvF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,sCAAsC,qBAAqB,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAC3I,CAAC;IAED,OAAO,4BAA4B,qBAAqB,EAAE,CAAA;AAC5D,CAAC"}

package/dist/commands/init.d.ts

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

package/dist/commands/init.js

@@ -0,0 +1,16 @@
+import { access, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { buildDefaultMdsiteConfig, serializeMdsiteConfig } from '../config/mdsite-config.js';
+export async function runInitCommand(contentDir) {
+    const configPath = path.join(contentDir, 'mdsite.yml');
+    try {
+        await access(configPath);
+    }
+    catch {
+        const config = await buildDefaultMdsiteConfig(contentDir);
+        await writeFile(configPath, serializeMdsiteConfig(config), 'utf8');
+        return;
+    }
+    throw new Error(`mdsite.yml already exists at ${configPath}.`);
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAE5F,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,UAAkB;IACrD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAA;IAEtD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,UAAU,CAAC,CAAA;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAAC,UAAU,CAAC,CAAA;QACzD,MAAM,SAAS,CAAC,UAAU,EAAE,qBAAqB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAA;QAClE,OAAM;IACR,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,gCAAgC,UAAU,GAAG,CAAC,CAAA;AAChE,CAAC"}

package/dist/commands/prepare.d.ts

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