dev-cockpit 0.1.0

package/dist/commands/dev.js

@@ -0,0 +1,158 @@
+/**
+ * `dev-cockpit dev` — generic boot of the three-pane TUI.
+ *
+ * Loads `cockpit.yaml`, runs the active profile's boot lifecycle hook to
+ * collect cockpit handlers + fs-event source + cleanup, wires up docker
+ * log tailers and the health framework, then renders the cockpit shell.
+ *
+ * Workspace root resolution order:
+ *   1. `profile.discoverer()` if present
+ *   2. parent directory of the resolved config file
+ */
+import path from 'node:path';
+import fs from 'node:fs';
+import { loadConfig } from '../core/config.js';
+import { runCockpit } from '../runCockpit.js';
+import { buildHealthContext } from '../health/context.js';
+import { buildHealthRegistry } from '../health/registry.js';
+import { cockpitStore } from '../cockpit/state/store.js';
+import { DockerLogTailer } from '../docker/logs.js';
+import { killAllSpawned, spawnStream } from '../core/subprocess.js';
+export async function devCommand(opts = {}) {
+    const configPath = path.resolve(opts.config ?? 'cockpit.yaml');
+    if (!fs.existsSync(configPath)) {
+        process.stderr.write(`dev-cockpit: no cockpit.yaml found at ${configPath}.\n` +
+            `  Run \`dev-cockpit init-config\` to scaffold one.\n`);
+        process.exit(1);
+    }
+    const profile = opts.profile;
+    const config = loadConfig(configPath, {
+        configSchemaExt: profile?.configSchemaExt,
+        profileKey: profile?.appName,
+    });
+    const workspaceRoot = profile?.discoverer?.()?.root ?? path.dirname(configPath);
+    // Seed the Repos pane from config.repos[] (and any docker.services that
+    // the user listed as tailed — those surface as `docker`-kind entries).
+    // Profiles that need richer derivation can call cockpitStore.initRepos
+    // themselves from their setupCli command before runCockpit boots.
+    const seededRepos = {};
+    const seededOrder = [];
+    for (const repo of config.repos) {
+        seededRepos[repo.id] = { name: repo.label ?? repo.id, status: 'idle', kind: 'repo' };
+        seededOrder.push(repo.id);
+    }
+    const profileCtx = { config, workspaceRoot };
+    for (const repo of profile?.reposProvider?.(profileCtx) ?? []) {
+        if (seededRepos[repo.id])
+            continue;
+        seededRepos[repo.id] = { name: repo.label ?? repo.id, status: 'idle', kind: 'repo' };
+        seededOrder.push(repo.id);
+    }
+    for (const svc of config.docker?.services ?? []) {
+        if (seededRepos[svc.name])
+            continue;
+        seededRepos[svc.name] = { name: svc.name, status: 'idle', kind: 'docker' };
+        seededOrder.push(svc.name);
+    }
+    cockpitStore.getState().initRepos(seededRepos, seededOrder);
+    const ctx = buildHealthContext(workspaceRoot, (line) => cockpitStore.getState().appendOutput(line));
+    const registry = buildHealthRegistry({
+        profileChecks: profile?.healthChecks,
+        configEntries: config.health,
+    });
+    const helpSources = (profile?.helpSources ?? []).map((src) => ({
+        id: src.id,
+        title: src.title,
+        path: src.path,
+        content: src.content,
+        omit: src.omit,
+    }));
+    // Profile lifecycle hook. Runs after config load + workspaceRoot resolution
+    // and before the cockpit renders. Profiles return any combination of
+    // pane handlers, an fs-event subscription (typically WatcherManager.
+    // subscribeFsEvents) for the health framework, and a cleanup callback
+    // awaited at teardown.
+    const bootResult = profile?.boot
+        ? await profile.boot(profileCtx)
+        : {};
+    const handlers = bootResult.cockpitHandlers ?? {};
+    const handle = runCockpit({
+        profile: profile
+            ? {
+                ...profile,
+                helpSources,
+                defaultHelpPage: profile.defaultHelpPage ?? config.help.defaultPage,
+            }
+            : undefined,
+        runRepoAction: handlers.runRepoAction,
+        onWatchToggle: handlers.onWatchToggle,
+        onLint: handlers.onLint,
+        onOpenError: handlers.onOpenError,
+        footerLegends: handlers.footerLegends,
+        health: {
+            workspaceRoot,
+            profileChecks: registry,
+            ctx,
+            notifications: {
+                enabled: config.notifications.enabled,
+                exclude: config.notifications.exclude,
+            },
+            appName: config.appName,
+            subscribeFsEvents: bootResult.subscribeFsEvents,
+        },
+    });
+    // Spawn each declared watcher as a long-running streaming process. Output
+    // flows into the Output pane tagged by the watcher's id (or label). The
+    // global spawnStream registry tracks each child, so killAllSpawned() at
+    // teardown reaps them. No fsevent-driven respawn here — the watcher's own
+    // command (e.g. `tsc --watch`) is expected to handle re-runs internally.
+    for (const watcher of config.watchers) {
+        const [exe, ...args] = watcher.command.split(/\s+/);
+        if (!exe)
+            continue;
+        const source = watcher.label ?? watcher.id;
+        spawnStream(exe, args, {
+            cwd: watcher.cwd ? path.resolve(workspaceRoot, watcher.cwd) : workspaceRoot,
+            env: watcher.env,
+            onStdout: (line) => cockpitStore.getState().appendOutput({
+                ts: Date.now(),
+                source,
+                severity: 'info',
+                text: line,
+            }),
+            onStderr: (line) => cockpitStore.getState().appendOutput({
+                ts: Date.now(),
+                source,
+                severity: 'warn',
+                text: line,
+            }),
+        });
+    }
+    // Optional docker log tailer — only if config declares services to tail.
+    const dockerServices = (config.docker?.services ?? []).filter((s) => s.tail !== false);
+    let dockerTailer = null;
+    if (dockerServices.length > 0) {
+        dockerTailer = new DockerLogTailer({
+            workspaceRoot,
+            services: dockerServices.map((s) => s.name),
+            highlightPatterns: config.highlights.map((h) => h.pattern),
+            appendOutput: (line) => cockpitStore.getState().appendOutput(line),
+            pushRecentError: (err) => cockpitStore.getState().pushRecentError(err),
+            notifyOpts: () => ({
+                config: {
+                    enabled: config.notifications.enabled,
+                    exclude: config.notifications.exclude,
+                },
+                sessionEnabled: cockpitStore.getState().notificationsEnabledSession,
+                appName: config.appName,
+            }),
+        });
+        dockerTailer.start();
+    }
+    await handle.waitUntilExit();
+    if (dockerTailer)
+        await dockerTailer.stop();
+    if (bootResult.cleanup)
+        await bootResult.cleanup();
+    await killAllSpawned();
+}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `dev-cockpit doctor` — one-shot health check.
+ *
+ * Loads the cockpit config, resolves the workspace root, builds the health
+ * registry from `config.health[]` + `profile.healthChecks`, runs the
+ * `startup` trigger set once, prints results, and exits non-zero on any
+ * `error` severity.
+ */
+import type { Profile } from '../core/types.js';
+import type { HealthStatus } from '../core/types.js';
+export interface DoctorCommandOptions {
+    config?: string;
+    profile?: Profile;
+}
+export declare function formatResults(results: HealthStatus[], appName: string): {
+    lines: string[];
+    exitCode: 0 | 1;
+};
+export declare function doctorCommand(opts?: DoctorCommandOptions): Promise<void>;
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAKhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAQD,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG;IACvE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;CACjB,CAoBA;AAED,wBAAsB,aAAa,CAAC,IAAI,GAAE,oBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BlF"}

package/dist/commands/doctor.js

@@ -0,0 +1,66 @@
+/**
+ * `dev-cockpit doctor` — one-shot health check.
+ *
+ * Loads the cockpit config, resolves the workspace root, builds the health
+ * registry from `config.health[]` + `profile.healthChecks`, runs the
+ * `startup` trigger set once, prints results, and exits non-zero on any
+ * `error` severity.
+ */
+import path from 'node:path';
+import fs from 'node:fs';
+import { loadConfig } from '../core/config.js';
+import { buildHealthContext } from '../health/context.js';
+import { buildHealthRegistry } from '../health/registry.js';
+import { runChecks } from '../health/runner.js';
+const GLYPH = {
+    ok: '✓',
+    warn: '⚠',
+    error: '✗',
+};
+export function formatResults(results, appName) {
+    if (results.length === 0) {
+        return {
+            lines: [`${appName} doctor: no checks ran (empty health registry)`],
+            exitCode: 0,
+        };
+    }
+    const labelWidth = Math.max(...results.map((r) => r.label.length));
+    const lines = [];
+    let anyError = false;
+    for (const r of results) {
+        if (r.severity === 'error')
+            anyError = true;
+        const detail = r.detail || (r.severity === 'ok' ? 'ok' : '(no detail)');
+        let line = `${GLYPH[r.severity]} ${r.label.padEnd(labelWidth)}  ${detail}`;
+        if (r.severity !== 'ok' && r.remediationKey) {
+            line += `  → press ${r.remediationKey} in cockpit`;
+        }
+        lines.push(line);
+    }
+    return { lines, exitCode: anyError ? 1 : 0 };
+}
+export async function doctorCommand(opts = {}) {
+    const configPath = path.resolve(opts.config ?? 'cockpit.yaml');
+    if (!fs.existsSync(configPath)) {
+        process.stderr.write(`dev-cockpit doctor: no cockpit.yaml found at ${configPath}.\n`);
+        process.exit(1);
+    }
+    const profile = opts.profile;
+    const config = loadConfig(configPath, {
+        configSchemaExt: profile?.configSchemaExt,
+        profileKey: profile?.appName,
+    });
+    const workspaceRoot = profile?.discoverer?.()?.root ?? path.dirname(configPath);
+    const ctx = buildHealthContext(workspaceRoot);
+    const registry = buildHealthRegistry({
+        profileChecks: profile?.healthChecks,
+        configEntries: config.health,
+    });
+    const results = await runChecks(registry, ['startup'], ctx);
+    const { lines, exitCode } = formatResults(results, config.appName);
+    for (const line of lines) {
+        process.stdout.write(`${line}\n`);
+    }
+    if (exitCode !== 0)
+        process.exit(exitCode);
+}

package/dist/commands/init-config-wizard.d.ts

@@ -0,0 +1,84 @@
+/**
+ * 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.
+ */
+export type HealthBuiltinType = 'container-running' | 'port-open' | 'http-ok' | 'file-exists' | 'exec-zero';
+export type HighlightSeverity = 'info' | 'warn' | 'error';
+export type HealthSeverity = 'ok' | 'warn' | 'error';
+export interface WizardWatcher {
+    id: string;
+    command: string;
+}
+export interface WizardDockerService {
+    name: string;
+}
+export interface WizardDocker {
+    composeFile?: string;
+    services: WizardDockerService[];
+}
+export interface WizardHighlight {
+    pattern: string;
+    severity: HighlightSeverity;
+}
+export interface WizardRemediation {
+    key: string;
+    label: string;
+    command: string;
+}
+export interface WizardHealthCheckBase {
+    id: string;
+    label: string;
+    severity: HealthSeverity;
+    remediation: WizardRemediation;
+}
+export type WizardHealthCheck = (WizardHealthCheckBase & {
+    type: 'container-running';
+    container: string;
+}) | (WizardHealthCheckBase & {
+    type: 'port-open';
+    host: string;
+    port: number;
+}) | (WizardHealthCheckBase & {
+    type: 'http-ok';
+    url: string;
+}) | (WizardHealthCheckBase & {
+    type: 'file-exists';
+    path: string;
+}) | (WizardHealthCheckBase & {
+    type: 'exec-zero';
+    command: string;
+});
+export interface WizardRepo {
+    id: string;
+    path: string;
+    label?: string;
+}
+export interface WizardResult {
+    appName: string;
+    watchers: WizardWatcher[];
+    docker?: WizardDocker;
+    repos: WizardRepo[];
+    highlights: WizardHighlight[];
+    health: WizardHealthCheck[];
+    notifications: {
+        enabled: boolean;
+    };
+}
+export declare function renderWizardYaml(result: WizardResult): string;
+export declare function runInitWizard(opts: {
+    defaultAppName: string;
+    cwd?: string;
+}): Promise<WizardResult>;
+//# sourceMappingURL=init-config-wizard.d.ts.map

package/dist/commands/init-config-wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-config-wizard.d.ts","sourceRoot":"","sources":["../../src/commands/init-config-wizard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,iBAAiB,GACzB,mBAAmB,GACnB,WAAW,GACX,SAAS,GACT,aAAa,GACb,WAAW,CAAC;AAEhB,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAC1D,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC;AAErD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,iBAAiB,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW,EAAE,iBAAiB,CAAC;CAChC;AAED,MAAM,MAAM,iBAAiB,GACzB,CAAC,qBAAqB,GAAG;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,GAC1E,CAAC,qBAAqB,GAAG;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAC3E,CAAC,qBAAqB,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,GAC1D,CAAC,qBAAqB,GAAG;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAC/D,CAAC,qBAAqB,GAAG;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAErE,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,aAAa,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CACrC;AA8FD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CA+B7D;AAuwBD,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,YAAY,CAAC,CAgDxB"}