dev-cockpit 0.1.0 → 0.2.1

package/dist/commands/init-config-wizard.js

@@ -1,818 +0,0 @@
-/**
- * Interactive `cockpit.yaml` wizard for `dev-cockpit init-config --interactive`.
- *
- * Two pieces:
- *   1. {@link runInitWizard} — the prompt loop (lazy-imports @inquirer/prompts
- *      so non-interactive code paths don't pay the import cost).
- *   2. {@link renderWizardYaml} — pure function: WizardResult → yaml string.
- *      Lives here so tests can exercise it without touching prompts at all.
- *
- * The wizard intentionally stays narrow: it scaffolds a *usable* starter
- * config covering the common knobs (one watcher or two, the five built-in
- * health types with their primary args + a remediation, an optional docker
- * block, optional highlights, the notifications flag). Anything more
- * advanced — custom triggers, expectStatus, exec args — the user edits in
- * the generated yaml.
- */
-// ─── Pure renderer ──────────────────────────────────────────────────────────
-function indent(line, level) {
-    return '  '.repeat(level) + line;
-}
-function quote(value) {
-    // Quote when it contains characters yaml cares about; otherwise leave bare.
-    if (/^[A-Za-z0-9_./-]+$/.test(value))
-        return value;
-    return `'${value.replace(/'/g, "''")}'`;
-}
-function renderHealth(checks) {
-    if (checks.length === 0)
-        return [];
-    const out = ['health:'];
-    for (const c of checks) {
-        out.push(indent(`- id: ${quote(c.id)}`, 1));
-        out.push(indent(`  label: ${quote(c.label)}`, 1));
-        out.push(indent(`  type: ${c.type}`, 1));
-        out.push(indent(`  severity: ${c.severity}`, 1));
-        switch (c.type) {
-            case 'container-running':
-                out.push(indent(`  container: ${quote(c.container)}`, 1));
-                break;
-            case 'port-open':
-                out.push(indent(`  host: ${quote(c.host)}`, 1));
-                out.push(indent(`  port: ${c.port}`, 1));
-                break;
-            case 'http-ok':
-                out.push(indent(`  url: ${quote(c.url)}`, 1));
-                break;
-            case 'file-exists':
-                out.push(indent(`  path: ${quote(c.path)}`, 1));
-                break;
-            case 'exec-zero':
-                out.push(indent(`  command: ${quote(c.command)}`, 1));
-                break;
-        }
-        out.push(indent(`  remediation:`, 1));
-        out.push(indent(`    key: ${quote(c.remediation.key)}`, 1));
-        out.push(indent(`    label: ${quote(c.remediation.label)}`, 1));
-        out.push(indent(`    command: ${quote(c.remediation.command)}`, 1));
-    }
-    return out;
-}
-function renderWatchers(watchers) {
-    if (watchers.length === 0)
-        return [];
-    const out = ['watchers:'];
-    for (const w of watchers) {
-        out.push(indent(`- id: ${quote(w.id)}`, 1));
-        out.push(indent(`  command: ${quote(w.command)}`, 1));
-    }
-    return out;
-}
-function renderDocker(docker) {
-    if (!docker)
-        return [];
-    const out = ['docker:'];
-    if (docker.composeFile) {
-        out.push(indent(`composeFile: ${quote(docker.composeFile)}`, 1));
-    }
-    out.push(indent('services:', 1));
-    for (const s of docker.services) {
-        out.push(indent(`- name: ${quote(s.name)}`, 2));
-    }
-    return out;
-}
-function renderRepos(repos) {
-    if (repos.length === 0)
-        return [];
-    const out = ['repos:'];
-    for (const r of repos) {
-        out.push(indent(`- id: ${quote(r.id)}`, 1));
-        out.push(indent(`  path: ${quote(r.path)}`, 1));
-        if (r.label && r.label !== r.id) {
-            out.push(indent(`  label: ${quote(r.label)}`, 1));
-        }
-    }
-    return out;
-}
-function renderHighlights(hs) {
-    if (hs.length === 0)
-        return [];
-    const out = ['highlights:'];
-    for (const h of hs) {
-        out.push(indent(`- pattern: ${quote(h.pattern)}`, 1));
-        out.push(indent(`  severity: ${h.severity}`, 1));
-    }
-    return out;
-}
-export function renderWizardYaml(result) {
-    const blocks = [];
-    blocks.push([
-        '# Generated by `dev-cockpit init-config --interactive`. Edit freely.',
-        '',
-        'version: 1',
-        `appName: ${quote(result.appName)}`,
-    ]);
-    const watchers = renderWatchers(result.watchers);
-    if (watchers.length > 0)
-        blocks.push(watchers);
-    const docker = renderDocker(result.docker);
-    if (docker.length > 0)
-        blocks.push(docker);
-    const repos = renderRepos(result.repos);
-    if (repos.length > 0)
-        blocks.push(repos);
-    const highlights = renderHighlights(result.highlights);
-    if (highlights.length > 0)
-        blocks.push(highlights);
-    const health = renderHealth(result.health);
-    if (health.length > 0)
-        blocks.push(health);
-    blocks.push([
-        'notifications:',
-        indent(`enabled: ${result.notifications.enabled}`, 1),
-    ]);
-    return blocks.map((b) => b.join('\n')).join('\n\n') + '\n';
-}
-// ─── Interactive prompt loop ────────────────────────────────────────────────
-import fs from 'node:fs';
-import path from 'node:path';
-import chalk from 'chalk';
-async function loadPrompts() {
-    const m = (await import('@inquirer/prompts'));
-    return m;
-}
-// ─── Console helpers (lots of guidance copy in here, kept terminal-friendly) ─
-function blank() {
-    process.stdout.write('\n');
-}
-function line(s = '') {
-    process.stdout.write(`${s}\n`);
-}
-function header(stepIdx, total, title) {
-    blank();
-    line(chalk.bold.cyan(`── Step ${stepIdx} of ${total} — ${title} ──`));
-}
-function explain(s) {
-    // Wrap soft. Keep a constant left margin.
-    for (const para of s.split('\n'))
-        line(chalk.dim(para));
-}
-function showSummary(result) {
-    blank();
-    line(chalk.bold('  cockpit.yaml summary:'));
-    line(`    ${chalk.dim('appName:')} ${result.appName}`);
-    if (result.watchers.length > 0) {
-        line(`    ${chalk.dim('watchers:')} ${result.watchers.map((w) => w.id).join(', ')}`);
-    }
-    if (result.docker) {
-        line(`    ${chalk.dim('docker services:')} ${result.docker.services.map((s) => s.name).join(', ')}`);
-    }
-    if (result.repos.length > 0) {
-        line(`    ${chalk.dim('repos:')} ${result.repos.map((r) => r.id).join(', ')}`);
-    }
-    if (result.highlights.length > 0) {
-        line(`    ${chalk.dim('highlights:')} ${result.highlights.length} pattern(s)`);
-    }
-    if (result.health.length > 0) {
-        line(`    ${chalk.dim('health:')} ${result.health.map((h) => `${h.id} (${h.type})`).join(', ')}`);
-    }
-    line(`    ${chalk.dim('notifications:')} ${result.notifications.enabled ? 'enabled' : 'disabled'}`);
-    blank();
-}
-function safeReadJson(p) {
-    try {
-        return JSON.parse(fs.readFileSync(p, 'utf8'));
-    }
-    catch {
-        return null;
-    }
-}
-function detectComposeFile(cwd) {
-    for (const candidate of ['compose.yaml', 'compose.yml', 'docker-compose.yml', 'docker-compose.yaml']) {
-        if (fs.existsSync(path.join(cwd, candidate)))
-            return candidate;
-    }
-    return undefined;
-}
-function parseComposeServices(cwd, composeFile) {
-    // Lightweight scan — doesn't depend on `yaml`. Picks lines like
-    // `    name:` directly under a top-level `services:` key.
-    try {
-        const text = fs.readFileSync(path.join(cwd, composeFile), 'utf8');
-        const out = [];
-        let inServices = false;
-        for (const raw of text.split('\n')) {
-            // Top-level key (column 0) other than `services:` ends the block.
-            if (/^[A-Za-z]/.test(raw)) {
-                inServices = raw.startsWith('services:');
-                continue;
-            }
-            if (!inServices)
-                continue;
-            const m = /^ {2,4}([A-Za-z][A-Za-z0-9._-]*):\s*$/.exec(raw);
-            if (m && m[1])
-                out.push(m[1]);
-        }
-        return out;
-    }
-    catch {
-        return [];
-    }
-}
-function detectRepoSuggestions(cwd, pkg) {
-    const out = [];
-    // npm / yarn workspaces — package.json `workspaces` is either an array of
-    // glob patterns OR an object with `packages: [...]`.
-    const ws = pkg?.['workspaces'];
-    let workspaceGlobs = [];
-    if (Array.isArray(ws)) {
-        workspaceGlobs = ws.filter((g) => typeof g === 'string');
-    }
-    else if (ws && typeof ws === 'object') {
-        const packages = ws.packages;
-        if (Array.isArray(packages)) {
-            workspaceGlobs = packages.filter((g) => typeof g === 'string');
-        }
-    }
-    for (const glob of workspaceGlobs) {
-        for (const entry of expandSimpleGlob(cwd, glob)) {
-            out.push({ id: path.basename(entry), path: path.relative(cwd, path.join(cwd, entry)) || '.' });
-        }
-    }
-    // pnpm-workspace.yaml — lightweight scan, no yaml parser dep needed.
-    const pnpmFile = path.join(cwd, 'pnpm-workspace.yaml');
-    if (fs.existsSync(pnpmFile)) {
-        try {
-            const text = fs.readFileSync(pnpmFile, 'utf8');
-            const inPackages = /packages:\s*([\s\S]*?)(?:\n[a-zA-Z]|$)/.exec(text);
-            if (inPackages?.[1]) {
-                for (const line of inPackages[1].split('\n')) {
-                    const m = /^\s*-\s*['"]?([^'"]+)['"]?/.exec(line);
-                    if (m?.[1]) {
-                        for (const entry of expandSimpleGlob(cwd, m[1])) {
-                            if (!out.some((e) => e.path === entry)) {
-                                out.push({ id: path.basename(entry), path: entry });
-                            }
-                        }
-                    }
-                }
-            }
-        }
-        catch {
-            // ignore
-        }
-    }
-    // Default fallback: a single entry at the workspace root, named after
-    // package.json or the directory.
-    if (out.length === 0) {
-        const id = pkg?.['name'] ?? path.basename(cwd) ?? 'app';
-        out.push({ id, path: '.' });
-    }
-    return out;
-}
-/**
- * Tiny glob expander good enough for `packages/*` and literal paths.
- * Anything more exotic (`**`, brace expansion, negations) just returns the
- * literal as-is — the user can hand-edit cockpit.yaml later.
- */
-function expandSimpleGlob(cwd, glob) {
-    if (!glob.includes('*')) {
-        return fs.existsSync(path.join(cwd, glob)) ? [glob] : [];
-    }
-    const m = /^([^*]+?)\/?\*$/.exec(glob);
-    if (!m?.[1])
-        return [];
-    const baseRel = m[1];
-    const baseAbs = path.join(cwd, baseRel);
-    if (!fs.existsSync(baseAbs))
-        return [];
-    try {
-        return fs
-            .readdirSync(baseAbs, { withFileTypes: true })
-            .filter((d) => d.isDirectory() && !d.name.startsWith('.'))
-            .map((d) => path.posix.join(baseRel, d.name));
-    }
-    catch {
-        return [];
-    }
-}
-function gatherHints(cwd) {
-    const pkg = safeReadJson(path.join(cwd, 'package.json'));
-    const pkgScripts = pkg?.['scripts'] ?? {};
-    const composeFile = detectComposeFile(cwd);
-    const composeServices = composeFile ? parseComposeServices(cwd, composeFile) : [];
-    return {
-        cwd,
-        appNameDefault: pkg?.['name'] ?? path.basename(cwd) ?? 'my-cockpit',
-        packageJsonScripts: pkgScripts,
-        composeFile,
-        composeServices,
-        hasArtisan: fs.existsSync(path.join(cwd, 'artisan')),
-        hasComposerJson: fs.existsSync(path.join(cwd, 'composer.json')),
-        repoSuggestions: detectRepoSuggestions(cwd, pkg),
-    };
-}
-// ─── Per-section prompts ────────────────────────────────────────────────────
-async function promptAppName(prompts, hints, fallback) {
-    header(1, 7, 'App name');
-    explain([
-        'Just a label for this cockpit. Shows up in window titles and OS',
-        'notification headers. Press enter to accept the default.',
-    ].join('\n'));
-    return prompts.input({
-        message: 'appName',
-        default: hints.appNameDefault || fallback,
-    });
-}
-async function promptWatchers(prompts, hints) {
-    header(3, 7, 'Watchers — long-running processes');
-    explain([
-        'Watchers are commands the cockpit spawns once on boot and streams into',
-        'the Output pane. Use this for anything that runs forever and writes to',
-        'stdout — and isn\'t already covered by the docker block above:',
-        '',
-        '    npm: `vite`, `tsc --watch`, `jest --watch`, `npm run dev`',
-        '    php: `php artisan serve`, `php artisan queue:work`',
-        '    log tails: `tail -f storage/logs/laravel.log`',
-        '',
-        'Each watcher gets a tag (its `id`) so its lines stay grouped in Output.',
-    ].join('\n'));
-    const suggestionScripts = ['dev', 'watch', 'start', 'serve'].filter((s) => hints.packageJsonScripts[s]);
-    const watchers = [];
-    if (suggestionScripts.length > 0) {
-        blank();
-        line(chalk.dim(`  Detected package.json scripts: ${suggestionScripts.map((s) => chalk.cyan(s)).join(', ')}`));
-        const picked = await prompts.checkbox({
-            message: 'Pick the scripts to register as watchers (space to toggle, enter to confirm)',
-            choices: [
-                ...suggestionScripts.map((s) => ({
-                    name: `${s} → npm run ${s}  (${hints.packageJsonScripts[s] ?? ''})`.slice(0, 80),
-                    value: s,
-                    checked: s === 'dev' || s === 'watch',
-                })),
-                { name: '— none of these, I’ll add custom watchers below', value: '__custom__' },
-            ],
-        });
-        for (const s of picked) {
-            if (s === '__custom__')
-                continue;
-            watchers.push({ id: s, command: `npm run ${s}` });
-        }
-    }
-    let addAnother = await prompts.confirm({
-        message: watchers.length > 0
-            ? 'Add another (custom) watcher beyond what was picked?'
-            : 'Add a custom watcher now?',
-        default: false,
-    });
-    while (addAnother) {
-        const id = await prompts.input({
-            message: 'watcher id (short slug, e.g. `tsc`, `vite`)',
-            validate: (s) => (s.trim().length > 0 ? true : 'cannot be empty'),
-        });
-        const command = await prompts.input({
-            message: `command for ${chalk.cyan(id)} (will be spawned once on cockpit boot)`,
-            validate: (s) => (s.trim().length > 0 ? true : 'cannot be empty'),
-        });
-        watchers.push({ id: id.trim(), command: command.trim() });
-        addAnother = await prompts.confirm({ message: 'Add another watcher?', default: false });
-    }
-    if (watchers.length === 0) {
-        line(chalk.dim('  (skipped — no watchers configured)'));
-    }
-    return watchers;
-}
-async function promptDocker(prompts, hints) {
-    header(2, 7, 'Docker — log tailing for compose services');
-    explain([
-        'If you run a docker-compose stack, the cockpit can stream',
-        '`docker compose logs -f` for selected services into the Output pane.',
-        '',
-        'This section is compose-only. For other long-running processes',
-        '(`php artisan serve`, `vite`, log tails), the next step covers them as',
-        'watchers. Skip this entire section if you don\'t run a compose stack here.',
-    ].join('\n'));
-    if (hints.composeFile) {
-        blank();
-        line(chalk.dim(`  Detected ${chalk.cyan(hints.composeFile)} with services: ${hints.composeServices.length > 0 ? hints.composeServices.map((s) => chalk.cyan(s)).join(', ') : '(none parsed)'}.`));
-    }
-    else {
-        line(chalk.dim('  No compose file detected at the project root.'));
-    }
-    const want = await prompts.confirm({
-        message: 'Include a docker block?',
-        default: Boolean(hints.composeFile),
-    });
-    if (!want) {
-        line(chalk.dim('  (skipped — docker logs will not be tailed)'));
-        return undefined;
-    }
-    const composeFile = await prompts.input({
-        message: 'compose file (relative to workspace root)',
-        default: hints.composeFile ?? 'docker-compose.yml',
-    });
-    if (hints.composeServices.length > 0) {
-        const picked = await prompts.checkbox({
-            message: 'Which services should the cockpit tail logs from?',
-            choices: hints.composeServices.map((s) => ({ name: s, value: s, checked: true })),
-        });
-        return {
-            composeFile,
-            services: picked.map((name) => ({ name })),
-        };
-    }
-    const servicesRaw = await prompts.input({
-        message: 'services to tail (comma-separated, e.g. `web,db,redis`)',
-        default: 'web',
-        validate: (s) => (s.trim().length > 0 ? true : 'enter at least one service'),
-    });
-    return {
-        composeFile,
-        services: servicesRaw
-            .split(',')
-            .map((s) => s.trim())
-            .filter(Boolean)
-            .map((name) => ({ name })),
-    };
-}
-async function promptRepos(prompts, hints) {
-    header(4, 7, 'Repos pane entries');
-    explain([
-        'The Repos pane lists things you can act on with single keystrokes',
-        'inside the cockpit:',
-        '',
-        '    r → rebuild      w → toggle watcher       l → run lint',
-        '',
-        'Docker services from the docker block already appear here automatically',
-        '(with r → restart). This step is for code-side entries — typically:',
-        '',
-        '   • the project root (single Node/Laravel/Python app)',
-        '   • each package in a monorepo (npm/yarn/pnpm workspaces)',
-        '   • each in-house package you develop alongside the app',
-        '',
-        'Skip entirely if you only need docker services in the pane. The r/w/l',
-        'actions become live when an active profile bundle wires them; the',
-        'generic shell shows the rows but the keys are no-ops without one.',
-    ].join('\n'));
-    if (hints.repoSuggestions.length > 0) {
-        blank();
-        line(chalk.dim(`  Detected ${chalk.cyan(String(hints.repoSuggestions.length))} candidate(s) from this project:`));
-    }
-    const picked = await prompts.checkbox({
-        message: hints.repoSuggestions.length > 0
-            ? 'Pick which to register as repo entries (space toggles, enter confirms)'
-            : 'No suggestions detected — press enter to skip, or add custom entries below',
-        choices: hints.repoSuggestions.map((r) => ({
-            name: `${r.id}  →  ${r.path}`,
-            value: r.id,
-            checked: hints.repoSuggestions.length === 1, // single-app default: pre-checked
-        })),
-    });
-    const out = hints.repoSuggestions.filter((r) => picked.includes(r.id));
-    let addAnother = await prompts.confirm({
-        message: out.length > 0 ? 'Add another (custom) repo entry?' : 'Add a custom repo entry?',
-        default: false,
-    });
-    while (addAnother) {
-        const id = await prompts.input({
-            message: 'repo id (slug; e.g. `api`, `web`)',
-            validate: (s) => (s.trim().length > 0 ? true : 'cannot be empty'),
-        });
-        const repoPath = await prompts.input({
-            message: `path (relative to workspace root) for ${chalk.cyan(id)}`,
-            default: '.',
-            validate: (s) => (s.trim().length > 0 ? true : 'cannot be empty'),
-        });
-        const label = await prompts.input({
-            message: `label shown in the pane (defaults to id if blank)`,
-            default: id,
-        });
-        out.push({
-            id: id.trim(),
-            path: repoPath.trim(),
-            label: label.trim() === id.trim() ? undefined : label.trim(),
-        });
-        addAnother = await prompts.confirm({ message: 'Add another?', default: false });
-    }
-    if (out.length === 0) {
-        line(chalk.dim('  (skipped — Repos pane will only show docker services, if any)'));
-    }
-    return out;
-}
-async function promptHighlights(prompts) {
-    header(5, 7, 'Output highlights');
-    explain([
-        'Regex patterns that re-colour matching lines in Output. `error`-severity',
-        'matches additionally feed the Recent Errors strip on the Repos pane and',
-        'fire OS notifications (per the section below).',
-        '',
-        'Examples — pattern + severity:',
-        '    Stack trace                         error   (red, also notifies)',
-        '    \\[ERROR\\]                            error   (Laravel-style log lines)',
-        '    PHP Fatal                           error   (PHP error surface)',
-        '    WARN                                warn    (yellow, no notify)',
-        '',
-        'Combine with watchers for max value — e.g. a watcher running',
-        '`tail -f storage/logs/laravel.log` plus the `\\[ERROR\\]` highlight will',
-        'stream Laravel\'s log into Output and paint each error red as it lands.',
-    ].join('\n'));
-    const want = await prompts.confirm({ message: 'Add highlight patterns?', default: false });
-    if (!want) {
-        line(chalk.dim('  (skipped — Output stays uncoloured)'));
-        return [];
-    }
-    const out = [];
-    let addAnother = true;
-    while (addAnother) {
-        const pattern = await prompts.input({
-            message: 'pattern (regex; e.g. `ERROR`, `Stack trace`)',
-            validate: (s) => (s.trim().length > 0 ? true : 'cannot be empty'),
-        });
-        const severity = await prompts.select({
-            message: 'severity for matching lines',
-            choices: [
-                { name: 'error  — red + feeds notifications', value: 'error' },
-                { name: 'warn   — yellow', value: 'warn' },
-                { name: 'info   — blue (rarely useful, but here for completeness)', value: 'info' },
-            ],
-            default: 'warn',
-        });
-        out.push({ pattern: pattern.trim(), severity });
-        addAnother = await prompts.confirm({ message: 'Add another?', default: false });
-    }
-    return out;
-}
-async function promptHealthChecks(prompts, hints, hasDocker) {
-    header(6, 7, 'Health checks');
-    explain([
-        'Each health check has two parts:',
-        '',
-        `   1. The ${chalk.bold('test')}  — the condition the cockpit evaluates`,
-        '                  ("does X pass?"). Runs at startup + on relevant',
-        '                  events (filesystem changes, docker poll, etc.).',
-        '',
-        `   2. The ${chalk.bold('fix')}   — a single-keystroke remediation. When the test`,
-        '                  fails, the row goes red and pressing the configured',
-        '                  key runs your fix command.',
-        '',
-        'Five built-in test types:',
-        '',
-        '    container-running   is the named container in `docker compose ps`?',
-        '                         e.g. "is pgsql up?"  →  D = docker compose up -d',
-        '',
-        '    port-open           can we open a TCP socket on host:port?',
-        '                         e.g. "is port 5432 open?"  →  D = docker compose up -d',
-        '',
-        '    http-ok             does GET <url> return 2xx?',
-        '                         e.g. "is /health 2xx?"  →  R = restart the app',
-        '',
-        '    file-exists         does <path> exist on disk?',
-        '                         e.g. "does vendor/ exist?"  →  I = composer install',
-        '',
-        '    exec-zero           does <command> exit with status 0?',
-        '                         e.g. "migrations up-to-date?"  →  M = run migrations',
-        '',
-        'You can add as many checks as you like — same type can repeat (e.g. one',
-        'port-open for 5432, another for 6379).',
-    ].join('\n'));
-    const out = [];
-    let typeChoices = baseHealthTypeChoices(Boolean(hints.composeFile && hints.composeServices.length > 0));
-    // Hide container-running when there's no docker block — it'd never go green.
-    if (!hasDocker) {
-        typeChoices = typeChoices.filter((c) => c.value !== 'container-running');
-    }
-    let addAnother = await prompts.confirm({ message: 'Add a health check?', default: true });
-    while (addAnother) {
-        const type = await prompts.select({
-            message: 'check type',
-            choices: typeChoices,
-            default: typeChoices[0]?.value,
-        });
-        out.push(await promptOneHealthCheck(prompts, type, hints));
-        addAnother = await prompts.confirm({ message: 'Add another health check?', default: false });
-    }
-    if (out.length === 0) {
-        line(chalk.dim('  (skipped — Health pane will be empty until you add checks by hand)'));
-    }
-    return out;
-}
-function baseHealthTypeChoices(haveDocker) {
-    return [
-        {
-            name: 'container-running — a named docker container is up',
-            value: 'container-running',
-            description: haveDocker
-                ? 'You have a compose stack — use this for "is service X running?".'
-                : '(no docker block declared — pick this only if your container runs out-of-band)',
-        },
-        {
-            name: 'port-open — a TCP port accepts connections',
-            value: 'port-open',
-            description: 'For "is postgres listening on 5432?" / "is the dev server up?".',
-        },
-        {
-            name: 'http-ok — an HTTP endpoint returns 2xx',
-            value: 'http-ok',
-            description: 'Stronger than port-open — confirms the app actually responds.',
-        },
-        {
-            name: 'file-exists — a file is present at a path',
-            value: 'file-exists',
-            description: 'For vendor/, node_modules/, .env — fast disk-only check.',
-        },
-        {
-            name: 'exec-zero — a command exits 0',
-            value: 'exec-zero',
-            description: 'Catch-all: lint clean, typecheck clean, migrations up-to-date.',
-        },
-    ];
-}
-async function promptOneHealthCheck(prompts, type, hints) {
-    const idDefault = type;
-    const id = await prompts.input({
-        message: 'short id (slug; lowercase, e.g. `web-up`)',
-        default: idDefault,
-        validate: (s) => (/^[a-z0-9][a-z0-9-]*$/.test(s.trim()) ? true : 'lowercase letters/numbers/dashes only'),
-    });
-    const label = await prompts.input({
-        message: 'human-readable label (shown on the Health row)',
-        default: id,
-    });
-    const severity = await prompts.select({
-        message: 'how serious is failure?',
-        choices: [
-            { name: 'error — red, fires OS notification on failure', value: 'error' },
-            { name: 'warn  — yellow, no notification', value: 'warn' },
-            { name: 'ok    — never goes red even when failing (rare)', value: 'ok' },
-        ],
-        default: 'error',
-    });
-    const base = {
-        id: id.trim(),
-        label,
-        severity,
-        remediation: { key: '', label: '', command: '' },
-    };
-    let typed;
-    switch (type) {
-        case 'container-running': {
-            explain('  The exact name of the running container (often the compose service name).');
-            const container = await prompts.input({
-                message: 'container name',
-                default: hints.composeServices[0],
-                validate: (s) => (s.trim().length > 0 ? true : 'cannot be empty'),
-            });
-            typed = { ...base, type, container: container.trim() };
-            break;
-        }
-        case 'port-open': {
-            const host = await prompts.input({
-                message: 'host (almost always 127.0.0.1)',
-                default: '127.0.0.1',
-            });
-            const portRaw = await prompts.number({ message: 'port (number)', default: 8080 });
-            typed = { ...base, type, host: host.trim(), port: portRaw ?? 0 };
-            break;
-        }
-        case 'http-ok': {
-            explain('  Full URL — the check fails if the response is not 2xx.');
-            const url = await prompts.input({
-                message: 'url (e.g. http://localhost:3000/health)',
-                validate: (s) => (s.trim().startsWith('http') ? true : 'must start with http:// or https://'),
-            });
-            typed = { ...base, type, url: url.trim() };
-            break;
-        }
-        case 'file-exists': {
-            const filePath = await prompts.input({
-                message: 'path relative to workspace root',
-                default: hints.hasComposerJson ? 'vendor' : 'node_modules',
-                validate: (s) => (s.trim().length > 0 ? true : 'cannot be empty'),
-            });
-            typed = { ...base, type, path: filePath.trim() };
-            break;
-        }
-        case 'exec-zero': {
-            explain('  The command runs once at startup. Exit code 0 = pass, anything else = fail.');
-            const command = await prompts.input({
-                message: 'command',
-                validate: (s) => (s.trim().length > 0 ? true : 'cannot be empty'),
-            });
-            typed = { ...base, type, command: command.trim() };
-            break;
-        }
-    }
-    blank();
-    line(chalk.bold('  Remediation — what should pressing a key in the cockpit do when this check fails?'));
-    explain([
-        '  Three pieces:',
-        '    • key:     the keystroke to press on the Health pane (single uppercase letter)',
-        '    • label:   what the cockpit shows beside the row when failing',
-        '    • command: the shell command that runs when the user presses the key',
-    ].join('\n'));
-    typed.remediation.key = (await prompts.input({
-        message: 'key (single uppercase letter, e.g. R)',
-        default: 'R',
-        validate: (s) => (/^[A-Z]$/.test(s.trim()) ? true : 'one uppercase letter, e.g. R'),
-    })).trim();
-    typed.remediation.label = await prompts.input({
-        message: 'remediation label',
-        default: defaultRemediationLabel(type),
-    });
-    typed.remediation.command = await prompts.input({
-        message: 'remediation command',
-        default: defaultRemediationCommand(type, hints),
-        validate: (s) => (s.trim().length > 0 ? true : 'cannot be empty'),
-    });
-    return typed;
-}
-function defaultRemediationLabel(type) {
-    switch (type) {
-        case 'container-running':
-            return 'bring up docker stack';
-        case 'port-open':
-            return 'restart the listener';
-        case 'http-ok':
-            return 'restart the app';
-        case 'file-exists':
-            return 'install dependencies';
-        case 'exec-zero':
-            return 'run the failing command';
-    }
-}
-function defaultRemediationCommand(type, hints) {
-    switch (type) {
-        case 'container-running':
-            return hints.composeFile ? `docker compose -f ${hints.composeFile} up -d` : 'docker compose up -d';
-        case 'port-open':
-            return hints.composeFile ? `docker compose -f ${hints.composeFile} up -d` : 'docker compose up -d';
-        case 'http-ok':
-            return 'echo "edit cockpit.yaml to set the restart command"';
-        case 'file-exists':
-            if (hints.hasComposerJson)
-                return 'composer install';
-            if (hints.packageJsonScripts['install'])
-                return 'npm install';
-            return 'npm install';
-        case 'exec-zero':
-            return 'echo "edit cockpit.yaml to set the fix command"';
-    }
-}
-async function promptNotifications(prompts) {
-    header(7, 7, 'Notifications');
-    explain([
-        'Native OS toasts when a health check or build flips state (ok→error or',
-        'error→ok). Only state transitions trigger — no spam, no per-check noise.',
-        'You can disable them per-session inside the cockpit by pressing `n`.',
-    ].join('\n'));
-    const enabled = await prompts.confirm({
-        message: 'Enable notifications?',
-        default: true,
-    });
-    return { enabled };
-}
-// ─── Entry point ────────────────────────────────────────────────────────────
-export async function runInitWizard(opts) {
-    const cwd = opts.cwd ?? process.cwd();
-    const prompts = await loadPrompts();
-    const hints = gatherHints(cwd);
-    blank();
-    line(chalk.bold.cyan('━━ dev-cockpit init-config wizard ━━'));
-    blank();
-    line('  This walks you through a starter cockpit.yaml — the file the cockpit reads on');
-    line('  every `dev-cockpit dev` run. Seven short steps:');
-    blank();
-    line(chalk.dim('    1. App name'));
-    line(chalk.dim('    2. Docker         — compose services to tail logs from'));
-    line(chalk.dim('    3. Watchers       — long-running processes streamed into Output'));
-    line(chalk.dim('    4. Repos          — entries shown in the Repos pane'));
-    line(chalk.dim('    5. Highlights     — regex patterns that paint Output lines'));
-    line(chalk.dim('    6. Health checks  — what should be true; one-keystroke fixes'));
-    line(chalk.dim('    7. Notifications  — native OS toasts on state changes'));
-    blank();
-    line('  Anything you skip you can add later by hand-editing cockpit.yaml.');
-    line(`  Press ${chalk.cyan('Ctrl-C')} to quit; press ${chalk.cyan('enter')} to accept any default.`);
-    blank();
-    const proceed = await prompts.confirm({ message: 'Ready?', default: true });
-    if (!proceed) {
-        throw new Error('wizard aborted');
-    }
-    const appName = await promptAppName(prompts, hints, opts.defaultAppName);
-    const docker = await promptDocker(prompts, hints);
-    const watchers = await promptWatchers(prompts, hints);
-    const repos = await promptRepos(prompts, hints);
-    const highlights = await promptHighlights(prompts);
-    const health = await promptHealthChecks(prompts, hints, docker !== undefined);
-    const notifications = await promptNotifications(prompts);
-    const result = {
-        appName,
-        watchers,
-        docker,
-        repos,
-        highlights,
-        health,
-        notifications,
-    };
-    showSummary(result);
-    return result;
-}