dev-cockpit 0.1.0

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

@@ -0,0 +1,35 @@
+/**
+ * `dev-cockpit init-config` — write a starter `cockpit.yaml`.
+ *
+ * The template is intentionally minimal and domain-neutral. Every section is
+ * commented out except `version` and `appName`; users uncomment the blocks
+ * they need. `--with-docker` includes the docker stanza uncommented as a
+ * jumping-off point for containerized workflows.
+ */
+import type { Profile } from '../core/types.js';
+export interface InitConfigOptions {
+    /** Target directory for cockpit.yaml. Default: process.cwd(). */
+    cwd?: string;
+    /** Include an uncommented docker block. Default: false. */
+    withDocker?: boolean;
+    /** Overwrite without prompting. Default: false. */
+    force?: boolean;
+    /** Override the default app name baked into the template. */
+    appName?: string;
+    /** Run the interactive wizard instead of writing the static template. */
+    interactive?: boolean;
+    /** Active profile (passed by buildCli) — forwarded to the post-wizard doctor pass. */
+    profile?: Profile;
+}
+export declare function buildTemplate(opts: {
+    withDocker: boolean;
+    appName: string;
+}): string;
+export interface InitConfigResult {
+    /** Absolute path written. */
+    path: string;
+    /** Whether an existing file was overwritten. */
+    overwrote: boolean;
+}
+export declare function initConfigCommand(opts?: InitConfigOptions): Promise<InitConfigResult | null>;
+//# sourceMappingURL=init-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init-config.d.ts","sourceRoot":"","sources":["../../src/commands/init-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAIhD,MAAM,WAAW,iBAAiB;IAChC,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mDAAmD;IACnD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,sFAAsF;IACtF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAoEpF;AAED,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAsB,iBAAiB,CACrC,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CA4DlC"}

package/dist/commands/init-config.js

@@ -0,0 +1,131 @@
+/**
+ * `dev-cockpit init-config` — write a starter `cockpit.yaml`.
+ *
+ * The template is intentionally minimal and domain-neutral. Every section is
+ * commented out except `version` and `appName`; users uncomment the blocks
+ * they need. `--with-docker` includes the docker stanza uncommented as a
+ * jumping-off point for containerized workflows.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { renderWizardYaml, runInitWizard } from './init-config-wizard.js';
+import { doctorCommand } from './doctor.js';
+export function buildTemplate(opts) {
+    const dockerBlock = opts.withDocker
+        ? `
+# Docker services to tail in the Output pane. Remove this block on plain-Node
+# projects.
+docker:
+  composeFile: docker-compose.yml
+  services:
+    - name: app
+      tail: true
+`
+        : `
+# Docker services to tail in the Output pane. Uncomment for containerized projects.
+# docker:
+#   composeFile: docker-compose.yml
+#   services:
+#     - name: app
+#       tail: true
+`;
+    return `# dev-cockpit configuration. All keys except \`version\` and \`appName\` are
+# optional; defaults from src/core/config.ts apply when missing.
+
+version: 1
+appName: ${opts.appName}
+
+# Long-running watcher processes streamed into the Output pane.
+# watchers:
+#   - id: build
+#     command: npm run watch
+#     color: cyan
+
+# Repos surfaced in the Repos pane (linkable to watchers / lint).
+# repos:
+#   - id: app
+#     path: .
+#     label: app
+${dockerBlock}
+# Output highlight patterns (regex) — matched lines render with elevated severity.
+# highlights:
+#   - pattern: 'ERROR'
+#     severity: error
+#   - pattern: 'WARN'
+#     severity: warn
+
+# Health checks. Built-in types: container-running, port-open, http-ok,
+# file-exists, exec-zero. See docs/health.md for the full schema.
+# health:
+#   - id: app-up
+#     label: app responsive
+#     type: http-ok
+#     url: http://localhost:3000/health
+
+# Help-pane sources (markdown trees) and the landing page slug.
+# help:
+#   sources: []
+#   defaultPage: getting-started
+
+# Native OS notifications. Set enabled: false to mute entirely.
+# notifications:
+#   enabled: true
+#   exclude: []
+
+# Bind-mount overlays applied by \`dev-cockpit mount\`.
+# mounts:
+#   - hostPath: ./packages/api
+#     containerPath: /srv/api
+`;
+}
+export async function initConfigCommand(opts = {}) {
+    const cwd = opts.cwd ?? process.cwd();
+    const target = path.join(cwd, 'cockpit.yaml');
+    const exists = fs.existsSync(target);
+    if (exists && !opts.force) {
+        process.stdout.write(`dev-cockpit init-config: ${target} already exists.\n` +
+            `  Pass --force to overwrite.\n`);
+        return null;
+    }
+    const content = opts.interactive
+        ? renderWizardYaml(await runInitWizard({
+            defaultAppName: opts.appName ?? (path.basename(cwd) || 'my-cockpit'),
+            cwd,
+        }))
+        : buildTemplate({
+            withDocker: opts.withDocker ?? false,
+            appName: opts.appName ?? 'my-cockpit',
+        });
+    fs.writeFileSync(target, content, 'utf8');
+    process.stdout.write(`\ndev-cockpit init-config: wrote ${target}\n`);
+    if (opts.withDocker) {
+        process.stdout.write('  Docker block uncommented; adjust composeFile/services as needed.\n');
+    }
+    if (opts.interactive) {
+        // Offer to run doctor immediately so the user gets instant feedback that
+        // the config parses + every health check has a baseline state. Note for
+        // edits: re-run `dev-cockpit doctor` any time after hand-editing.
+        const { confirm } = (await import('@inquirer/prompts'));
+        const runDoctorNow = await confirm({
+            message: 'Run `dev-cockpit doctor` now to validate the file + show initial health?',
+            default: true,
+        });
+        if (runDoctorNow) {
+            process.stdout.write('\n');
+            try {
+                await doctorCommand({ config: target, profile: opts.profile });
+            }
+            catch (err) {
+                process.stderr.write(`\ndoctor failed: ${err instanceof Error ? err.message : String(err)}\n`);
+            }
+        }
+        process.stdout.write('\nNext:\n');
+        process.stdout.write('  • Edit cockpit.yaml any time, then re-run `dev-cockpit doctor`.\n');
+        process.stdout.write('  • Run `dev-cockpit dev` to launch the cockpit (Tab/arrows cycle panes, q quits).\n');
+        process.stdout.write('  • The Help tab inside the cockpit has the full docs.\n');
+    }
+    else {
+        process.stdout.write('  Run `dev-cockpit doctor` to verify the config loads cleanly.\n');
+    }
+    return { path: target, overwrote: exists };
+}

package/dist/commands/mount.d.ts

@@ -0,0 +1,48 @@
+/**
+ * `dev-cockpit mount` — generic bind-mount overlay manager.
+ *
+ * Collects mount candidates from two sources and writes a Docker compose
+ * override file plus a manifest:
+ *   1. `config.mounts[]` — explicit, declared in cockpit.yaml
+ *   2. `profile.mountCandidatesProvider?.()` — discovered programmatically
+ *
+ * The merged set is keyed by `containerPath`; if both sources name the same
+ * container path, the config entry wins (explicit > discovered). The
+ * compose override targets a single configurable service (default: first
+ * service in `config.docker.services`).
+ *
+ * Subcommands:
+ *   mount         — write/refresh the overlay and manifest
+ *   mount status  — list active mounts from the manifest
+ *   mount clear   — remove overlay and manifest
+ */
+import type { Mount, Profile } from '../core/types.js';
+export interface MountCommandOptions {
+    config?: string;
+    profile?: Profile;
+    /** Container service name to attach the bind mounts to. */
+    service?: string;
+}
+export interface MountManifest {
+    appName: string;
+    workspaceRoot: string;
+    service: string;
+    overlayPath: string;
+    mounts: Mount[];
+    /** ISO timestamp of last apply. */
+    appliedAt: string;
+}
+/**
+ * Merge mount sources, keyed on containerPath. Config entries win over
+ * provider-discovered ones for the same container path.
+ */
+export declare function mergeMounts(configMounts: readonly Mount[], providerMounts: readonly Mount[]): Mount[];
+/**
+ * Render a Docker compose override YAML for the given service + mounts.
+ * Hand-rolled (no `yaml` writer) so the output stays stable + diff-friendly.
+ */
+export declare function renderOverlay(service: string, mounts: readonly Mount[]): string;
+export declare function mountCommand(opts?: MountCommandOptions): Promise<void>;
+export declare function mountStatusCommand(opts?: MountCommandOptions): Promise<void>;
+export declare function mountClearCommand(opts?: MountCommandOptions): Promise<void>;
+//# sourceMappingURL=mount.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../../src/commands/mount.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAIvD,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,YAAY,EAAE,SAAS,KAAK,EAAE,EAC9B,cAAc,EAAE,SAAS,KAAK,EAAE,GAC/B,KAAK,EAAE,CAKT;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,MAAM,CAe/E;AAkDD,wBAAsB,YAAY,CAAC,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgChF;AAED,wBAAsB,kBAAkB,CAAC,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBtF;AAED,wBAAsB,iBAAiB,CAAC,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBrF"}

package/dist/commands/mount.js

@@ -0,0 +1,150 @@
+/**
+ * `dev-cockpit mount` — generic bind-mount overlay manager.
+ *
+ * Collects mount candidates from two sources and writes a Docker compose
+ * override file plus a manifest:
+ *   1. `config.mounts[]` — explicit, declared in cockpit.yaml
+ *   2. `profile.mountCandidatesProvider?.()` — discovered programmatically
+ *
+ * The merged set is keyed by `containerPath`; if both sources name the same
+ * container path, the config entry wins (explicit > discovered). The
+ * compose override targets a single configurable service (default: first
+ * service in `config.docker.services`).
+ *
+ * Subcommands:
+ *   mount         — write/refresh the overlay and manifest
+ *   mount status  — list active mounts from the manifest
+ *   mount clear   — remove overlay and manifest
+ */
+import path from 'node:path';
+import fs from 'node:fs';
+import { loadConfig } from '../core/config.js';
+import { getStatePaths } from '../core/paths.js';
+/**
+ * Merge mount sources, keyed on containerPath. Config entries win over
+ * provider-discovered ones for the same container path.
+ */
+export function mergeMounts(configMounts, providerMounts) {
+    const seen = new Map();
+    for (const m of providerMounts)
+        seen.set(m.containerPath, m);
+    for (const m of configMounts)
+        seen.set(m.containerPath, m);
+    return Array.from(seen.values());
+}
+/**
+ * Render a Docker compose override YAML for the given service + mounts.
+ * Hand-rolled (no `yaml` writer) so the output stays stable + diff-friendly.
+ */
+export function renderOverlay(service, mounts) {
+    if (mounts.length === 0) {
+        return `# dev-cockpit: no mounts to apply\nservices: {}\n`;
+    }
+    const lines = [
+        '# Generated by `dev-cockpit mount`. Do not edit by hand — re-run the command.',
+        'services:',
+        `  ${service}:`,
+        '    volumes:',
+    ];
+    for (const m of mounts) {
+        lines.push(`      - ${m.hostPath}:${m.containerPath}`);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+function resolveOverlayPath(workspaceRoot) {
+    return path.join(workspaceRoot, 'docker-compose.dev-cockpit.yml');
+}
+function manifestPath(workspaceRoot, appName) {
+    const paths = getStatePaths(workspaceRoot, { appName });
+    return path.join(paths.stateDir, 'mount.manifest.json');
+}
+function loadCommandConfig(opts) {
+    const profile = opts.profile;
+    const configPath = path.resolve(opts.config ?? 'cockpit.yaml');
+    if (!fs.existsSync(configPath)) {
+        process.stderr.write(`dev-cockpit mount: no cockpit.yaml found at ${configPath}.\n`);
+        process.exit(1);
+    }
+    const config = loadConfig(configPath, {
+        configSchemaExt: profile?.configSchemaExt,
+        profileKey: profile?.appName,
+    });
+    const workspaceRoot = profile?.discoverer?.()?.root ?? path.dirname(configPath);
+    const explicitService = opts.service ?? config.docker?.services?.[0]?.name;
+    if (!explicitService) {
+        process.stderr.write('dev-cockpit mount: no target service. Pass --service <name> or set docker.services in cockpit.yaml.\n');
+        process.exit(1);
+    }
+    const providerMounts = profile?.mountCandidatesProvider?.() ?? [];
+    return {
+        configPath,
+        workspaceRoot,
+        appName: config.appName,
+        service: explicitService,
+        configMounts: config.mounts,
+        providerMounts,
+    };
+}
+export async function mountCommand(opts = {}) {
+    const { workspaceRoot, appName, service, configMounts, providerMounts } = loadCommandConfig(opts);
+    const merged = mergeMounts(configMounts, providerMounts);
+    if (merged.length === 0) {
+        process.stdout.write('dev-cockpit mount: no mount candidates from config.mounts[] or profile.mountCandidatesProvider.\n');
+        return;
+    }
+    const overlayPath = resolveOverlayPath(workspaceRoot);
+    fs.writeFileSync(overlayPath, renderOverlay(service, merged), 'utf8');
+    const manifest = {
+        appName,
+        workspaceRoot,
+        service,
+        overlayPath,
+        mounts: merged,
+        appliedAt: new Date().toISOString(),
+    };
+    fs.writeFileSync(manifestPath(workspaceRoot, appName), JSON.stringify(manifest, null, 2), 'utf8');
+    process.stdout.write(`dev-cockpit mount: wrote ${overlayPath}\n`);
+    for (const m of merged) {
+        process.stdout.write(`  ${m.hostPath} → ${service}:${m.containerPath}\n`);
+    }
+    process.stdout.write(`  Apply with: docker compose -f <your-compose>.yml -f ${path.basename(overlayPath)} up -d\n`);
+}
+export async function mountStatusCommand(opts = {}) {
+    const { workspaceRoot, appName } = loadCommandConfig(opts);
+    const target = manifestPath(workspaceRoot, appName);
+    if (!fs.existsSync(target)) {
+        process.stdout.write('dev-cockpit mount: no active overlay (no manifest found).\n');
+        return;
+    }
+    const manifest = JSON.parse(fs.readFileSync(target, 'utf8'));
+    process.stdout.write(`dev-cockpit mount status — service: ${manifest.service}\n`);
+    process.stdout.write(`  overlay: ${manifest.overlayPath}\n`);
+    process.stdout.write(`  applied: ${manifest.appliedAt}\n`);
+    if (manifest.mounts.length === 0) {
+        process.stdout.write('  (no mounts)\n');
+        return;
+    }
+    for (const m of manifest.mounts) {
+        process.stdout.write(`  ${m.hostPath} → ${m.containerPath}\n`);
+    }
+}
+export async function mountClearCommand(opts = {}) {
+    const { workspaceRoot, appName } = loadCommandConfig(opts);
+    const overlayPath = resolveOverlayPath(workspaceRoot);
+    const target = manifestPath(workspaceRoot, appName);
+    let removed = 0;
+    if (fs.existsSync(overlayPath)) {
+        fs.rmSync(overlayPath);
+        removed += 1;
+        process.stdout.write(`dev-cockpit mount: removed ${overlayPath}\n`);
+    }
+    if (fs.existsSync(target)) {
+        fs.rmSync(target);
+        removed += 1;
+        process.stdout.write(`dev-cockpit mount: removed ${target}\n`);
+    }
+    if (removed === 0) {
+        process.stdout.write('dev-cockpit mount: nothing to clear.\n');
+    }
+}