@gachlab/devup 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 gachlab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,332 @@
+# devup
+
+[![CI](https://github.com/gachlab/devup/actions/workflows/ci.yml/badge.svg)](https://github.com/gachlab/devup/actions/workflows/ci.yml)
+
+A terminal UI dev stack runner for Node.js monorepos. Define your services in a config file, and devup handles the rest: phased startup, health checks, lazy on-demand proxies, process stats, and reverse proxy config generation — all in a single TUI dashboard.
+
+Built with TypeScript 6, Ink (React for terminals), and zero test dependencies (uses `node:test` natively).
+
+## Features
+
+- **Phased startup** — boot services in dependency order with automatic port readiness detection
+- **Lazy mode** — only start services when they receive traffic. Idle services shut down after a configurable timeout
+- **TUI dashboard** — live logs and process stats (CPU, memory, health, errors, restarts) in a split-panel terminal UI
+- **Cross-platform** — Linux, macOS, and Windows. Platform-specific process management, stats collection, and browser opening
+- **Reverse proxy config** — generate Traefik (or other) dynamic config from running services. Health-aware: only routes to healthy services
+- **Project-agnostic** — works with any Node.js monorepo. Your project defines a `devup.config.ts`, devup does the rest
+- **npm install management** — automatic dependency installation with hash-based stamps to skip redundant installs
+- **Auto-restart with backoff** — crashed services restart automatically with exponential backoff (2s → 4s → 8s), max 3 attempts
+- **Port conflict detection** — checks if a port is already in use before starting a service
+
+## Quick start
+
+### 1. Install
+
+```bash
+npm install -D @gachlab/devup
+```
+
+### 2. Create config
+
+Create `devup.config.ts` in your project root:
+
+```typescript
+import { defineConfig } from '@gachlab/devup';
+
+export default defineConfig({
+  name: 'MyProject',
+  icon: '🚀',
+  envFile: '.env',
+
+  services: [
+    {
+      name: 'api',
+      cwd: 'packages/api',
+      cmd: 'node',
+      args: ['--watch-path', 'src', 'src/index.js'],
+      type: 'api',
+      port: 3000,
+      phase: 0,
+      maxMem: 256,
+    },
+    {
+      name: 'web',
+      cwd: 'packages/web',
+      cmd: 'npx',
+      args: ['vite', '--port', '4200'],
+      type: 'web',
+      port: 4200,
+      phase: 1,
+      maxMem: 512,
+    },
+  ],
+});
+```
+
+### 3. Run
+
+```bash
+npx devup
+```
+
+## Config reference
+
+### `DevStackConfig`
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `name` | `string` | ✅ | Project name shown in the TUI header |
+| `icon` | `string` | | Emoji shown before the project name. Default: `📦` |
+| `envFile` | `string` | | Path to `.env` file relative to project root. Default: `.env` |
+| `env` | `Record<string, string>` | | Extra environment variables. Won't overwrite existing ones |
+| `services` | `ServiceConfig[]` | ✅ | List of services to manage |
+| `lazy` | `LazyConfig` | | Lazy mode configuration |
+| `proxy` | `ProxyConfig` | | Reverse proxy config generation |
+
+### `ServiceConfig`
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `name` | `string` | ✅ | Unique service name |
+| `cwd` | `string` | ✅ | Working directory relative to project root |
+| `cmd` | `string` | ✅ | Command to run (`node`, `npx`, etc.) |
+| `args` | `string[]` | ✅ | Command arguments |
+| `type` | `'api' \| 'web'` | ✅ | Service type. APIs get health-checked; webs are assumed ready after start |
+| `port` | `number` | ✅ | Port the service listens on. Must be unique |
+| `phase` | `number` | ✅ | Startup phase (0 = first). Services in the same phase start together; devup waits for all APIs in a phase to be ready before starting the next phase |
+| `maxMem` | `number` | | Max memory in MB. Injects `--max-old-space-size` for `node` commands, or `NODE_OPTIONS` for `npx` |
+| `preBuild` | `string` | | Command to run before starting (e.g., `npm run build`) |
+| `watchBuild` | `string` | | Watch command to run alongside the service (e.g., `npx tsup --watch`) |
+| `nodeArgs` | `string[]` | | Extra Node.js arguments |
+| `extraEnv` | `Record<string, string>` | | Extra environment variables for this service |
+
+### `LazyConfig`
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `alwaysOn` | `string[]` | ✅ | Service names that always start immediately |
+| `timeout` | `number` | | Minutes of inactivity before stopping a lazy service. Default: `10` |
+
+When lazy mode is active (default), services not in `alwaysOn` start a TCP proxy on their port. The real service only boots when something connects to that port. After `timeout` minutes of no connections, the service shuts down and returns to idle.
+
+### `ProxyConfig`
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `provider` | `string` | ✅ | Proxy provider name. Currently: `'traefik'` |
+| `routes` | `Record<string, string>` | ✅ | Map of service name → subdomain. Empty string = root domain |
+| `confPath` | `string` | | Path to write the config file. Default: `~/.traefik/traefik_conf.yaml` |
+| `host` | `string` | | Target host for proxy URLs. Default: auto-detected per platform |
+| `tls` | `boolean` | | Enable TLS config. Default: `true` |
+| `entrypoint` | `string` | | Proxy entrypoint name. Default: `'websecure'` |
+
+The proxy config is only generated when `--proxy` is passed on the CLI. Only services with `health === 'up'` are included in the generated config.
+
+## CLI flags
+
+```
+devup [options]
+```
+
+### Service selection
+
+| Flag | Description |
+|---|---|
+| `--only apis` | Only start API services |
+| `--only webs` | Only start web services |
+| `--services api,web,auth` | Start only the named services |
+| `--skip tasks-api,pickup-api` | Start everything except these |
+| `--config path/to/config.ts` | Use a custom config file |
+
+### Lazy mode
+
+| Flag | Description |
+|---|---|
+| `--lazy` | Enable lazy mode (default) |
+| `--no-lazy` | Disable lazy mode — start everything immediately |
+| `--timeout 15` | Idle timeout in minutes (default: 10) |
+
+### Reverse proxy
+
+| Flag | Description |
+|---|---|
+| `--proxy` | Enable proxy config generation |
+| `--proxy-host 127.0.0.1` | Override target host |
+| `--proxy-conf /path/to/file` | Override config file path |
+| `--proxy-tls` | Enable TLS (default) |
+| `--no-proxy-tls` | Disable TLS |
+| `--proxy-entrypoint web` | Override entrypoint name |
+
+## TUI keybindings
+
+| Key | Action |
+|---|---|
+| `q` / `Ctrl+C` | Quit and stop all services |
+| `Tab` | Switch focus between Logs and Stats panels |
+| `f` | Filter logs by service |
+| `a` | Show all logs (clear filter) |
+| `/` | Search in logs |
+| `p` | Pause/resume log output |
+| `t` | Toggle timestamps |
+| `c` | Clear logs |
+| `s` | Cycle sort mode (name → memory → errors) |
+| `r` | Restart a service |
+| `o` | Open a web service in browser |
+| `T` | Toggle reverse proxy config sync |
+
+## Config file formats
+
+devup looks for config files in this order:
+
+1. `devup.config.ts` — TypeScript with full type checking and intellisense
+2. `devup.config.js` — JavaScript (ESM or CJS)
+3. `devup.config.json` — JSON (no functions or imports)
+
+Or pass `--config path/to/file` to use a custom path.
+
+## Phases
+
+Services boot in phase order. Within a phase, all services start simultaneously. devup waits for all API services in a phase to respond on their port before moving to the next phase.
+
+```
+Phase 0: Core infrastructure (config server, auth)
+Phase 1: Base APIs (app, users, files, events)
+Phase 2: Dependent APIs (communications, notifications)
+Phase 3: Final APIs
+Phase 4: Frontends (Angular, Svelte, React, Vite)
+```
+
+Phase numbers are arbitrary — use whatever makes sense for your dependency graph.
+
+## Lazy mode
+
+In lazy mode, devup creates a TCP proxy on each lazy service's original port. The real service runs on `port + 10000` when started.
+
+```
+Client → :3000 (proxy) → :13000 (real service)
+```
+
+When a connection arrives and the service is idle, devup:
+1. Runs `npm install` if needed
+2. Starts the service on the offset port
+3. Waits for the port to be ready
+4. Pipes the buffered connection through
+
+After `timeout` minutes with no connections, the service stops and returns to idle.
+
+Services listed in `lazy.alwaysOn` skip the proxy and start normally.
+
+## Platform support
+
+| Feature | Linux | macOS | Windows |
+|---|---|---|---|
+| Process stats (CPU, memory) | `ps` | `ps` | `wmic` |
+| Kill process tree | `kill -pid` | `kill -pid` | `taskkill /T /F` |
+| Open browser | `xdg-open` | `open` | `cmd /c start` |
+| Default proxy host | `172.17.0.1` | `host.docker.internal` | `host.docker.internal` |
+
+## Reverse proxy providers
+
+devup generates dynamic config for reverse proxies. Currently supported:
+
+### Traefik
+
+Generates a YAML file for Traefik's [file provider](https://doc.traefik.io/traefik/providers/file/). Mount the config file as a volume in your Traefik container.
+
+```yaml
+# docker-compose.yml
+services:
+  traefik:
+    volumes:
+      - ~/.traefik:/etc/traefik/dynamic
+```
+
+```bash
+devup --proxy --proxy-host 172.17.0.1
+```
+
+Adding a new provider (Nginx, Caddy, etc.) requires implementing the `ProxyConfigProvider` interface:
+
+```typescript
+interface ProxyConfigProvider {
+  readonly name: string;
+  generate(services: Map<string, ServiceState>, opts: ProxyOpts): string;
+  write(content: string, opts: ProxyOpts): void;
+  clear(opts: ProxyOpts): void;
+}
+```
+
+## Example: full config
+
+```typescript
+import { defineConfig } from '@gachlab/devup';
+
+export default defineConfig({
+  name: 'MyApp',
+  icon: '⚡',
+  envFile: '.env',
+  env: {
+    DOMAIN: 'localhost',
+  },
+
+  services: [
+    // Phase 0 — Core
+    { name: 'config-api', cwd: 'config/api', cmd: 'node', args: ['src/index.js'], type: 'api', port: 2999, phase: 0, maxMem: 192 },
+
+    // Phase 1 — APIs
+    { name: 'auth-api',   cwd: 'auth/api',   cmd: 'node', args: ['src/index.js'], type: 'api', port: 3002, phase: 1, maxMem: 192 },
+    { name: 'app-api',    cwd: 'app/api',    cmd: 'node', args: ['src/index.js'], type: 'api', port: 3000, phase: 1, maxMem: 256 },
+    { name: 'files-api',  cwd: 'files/api',  cmd: 'node', args: ['src/index.js'], type: 'api', port: 3013, phase: 1, maxMem: 192 },
+
+    // Phase 1 — TypeScript API with build step
+    { name: 'orders-api', cwd: 'orders/api', cmd: 'node', args: ['dist/index.js'], type: 'api', port: 3031, phase: 1, maxMem: 256,
+      preBuild: 'npm run build', watchBuild: 'npx tsup --watch' },
+
+    // Phase 2 — Dependent APIs
+    { name: 'notifications-api', cwd: 'notifications/api', cmd: 'node', args: ['src/index.js'], type: 'api', port: 3010, phase: 2, maxMem: 256 },
+
+    // Phase 4 — Frontends
+    { name: 'app-web',   cwd: 'app/web',   cmd: 'npx', args: ['ng', 'serve', '--port', '4201'], type: 'web', port: 4201, phase: 4, maxMem: 512 },
+    { name: 'admin-web', cwd: 'admin/web', cmd: 'npx', args: ['vite', '--port', '4204'],        type: 'web', port: 4204, phase: 4, maxMem: 384 },
+    { name: 'staff-web', cwd: 'staff/web', cmd: 'npx', args: ['vite', '--port', '4040'],        type: 'web', port: 4040, phase: 4, maxMem: 384 },
+  ],
+
+  lazy: {
+    alwaysOn: ['config-api', 'app-web'],
+    timeout: 10,
+  },
+
+  proxy: {
+    provider: 'traefik',
+    routes: {
+      'app-web':   '',
+      'admin-web': 'admin',
+      'staff-web': 'staff',
+      'app-api':   'app-api',
+      'auth-api':  'auth-api',
+      'files-api': 'files-api',
+    },
+  },
+});
+```
+
+## Requirements
+
+- Node.js >= 22
+- npm (for dependency installation)
+- A terminal with TTY support (for the interactive TUI)
+
+## Development
+
+```bash
+git clone https://github.com/gachlab/devup.git
+cd devup
+npm install
+npm run build
+npm test              # 112 tests, node:test native
+npm run test:coverage # coverage report
+```
+
+## License
+
+MIT © gachlab

package/dist/chunk-LG7UD5ZR.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+
+// src/platform/linux.ts
+import { exec, spawn } from "child_process";
+function parsePsTime(time) {
+  const parts = time.split(":").map(Number);
+  if (parts.length === 3) return parts[0] * 3600 + parts[1] * 60 + parts[2];
+  if (parts.length === 2) return parts[0] * 60 + parts[1];
+  return 0;
+}
+var LinuxPlatform = class {
+  defaultTraefikHost = "172.17.0.1";
+  getProcessStats(pids) {
+    if (!pids.length) return Promise.resolve(/* @__PURE__ */ new Map());
+    return new Promise((resolve) => {
+      exec(
+        `ps -o pid=,rss=,time= -p ${pids.join(",")} 2>/dev/null || true`,
+        { encoding: "utf8", timeout: 5e3 },
+        (err, stdout) => {
+          const map = /* @__PURE__ */ new Map();
+          if (err || !stdout) return resolve(map);
+          for (const line of stdout.trim().split("\n")) {
+            const parts = line.trim().split(/\s+/);
+            if (parts.length < 3) continue;
+            const pid = parseInt(parts[0], 10);
+            map.set(pid, {
+              rss: parseInt(parts[1], 10) || 0,
+              cpuSeconds: parsePsTime(parts[2])
+            });
+          }
+          resolve(map);
+        }
+      );
+    });
+  }
+  killTree(pid, signal = "SIGTERM") {
+    try {
+      process.kill(-pid, signal);
+    } catch {
+      try {
+        process.kill(pid, signal);
+      } catch {
+      }
+    }
+  }
+  openBrowser(url) {
+    spawn("xdg-open", [url], { detached: true, stdio: "ignore" }).unref();
+  }
+};
+
+export {
+  LinuxPlatform
+};
+//# sourceMappingURL=chunk-LG7UD5ZR.js.map

package/dist/chunk-LG7UD5ZR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/platform/linux.ts"],"sourcesContent":["import { exec, spawn } from 'node:child_process';\nimport type { Platform, ProcessStats } from './types.js';\n\nfunction parsePsTime(time: string): number {\n  const parts = time.split(':').map(Number);\n  if (parts.length === 3) return parts[0]! * 3600 + parts[1]! * 60 + parts[2]!;\n  if (parts.length === 2) return parts[0]! * 60 + parts[1]!;\n  return 0;\n}\n\nexport class LinuxPlatform implements Platform {\n  readonly defaultTraefikHost: string = '172.17.0.1';\n\n  getProcessStats(pids: number[]): Promise<Map<number, ProcessStats>> {\n    if (!pids.length) return Promise.resolve(new Map());\n\n    return new Promise(resolve => {\n      exec(\n        `ps -o pid=,rss=,time= -p ${pids.join(',')} 2>/dev/null || true`,\n        { encoding: 'utf8', timeout: 5000 },\n        (err, stdout) => {\n          const map = new Map<number, ProcessStats>();\n          if (err || !stdout) return resolve(map);\n\n          for (const line of stdout.trim().split('\\n')) {\n            const parts = line.trim().split(/\\s+/);\n            if (parts.length < 3) continue;\n            const pid = parseInt(parts[0]!, 10);\n            map.set(pid, {\n              rss: parseInt(parts[1]!, 10) || 0,\n              cpuSeconds: parsePsTime(parts[2]!),\n            });\n          }\n          resolve(map);\n        },\n      );\n    });\n  }\n\n  killTree(pid: number, signal: NodeJS.Signals = 'SIGTERM'): void {\n    try { process.kill(-pid, signal); } catch {\n      try { process.kill(pid, signal); } catch { /* already dead */ }\n    }\n  }\n\n  openBrowser(url: string): void {\n    spawn('xdg-open', [url], { detached: true, stdio: 'ignore' }).unref();\n  }\n}\n"],"mappings":";;;AAAA,SAAS,MAAM,aAAa;AAG5B,SAAS,YAAY,MAAsB;AACzC,QAAM,QAAQ,KAAK,MAAM,GAAG,EAAE,IAAI,MAAM;AACxC,MAAI,MAAM,WAAW,EAAG,QAAO,MAAM,CAAC,IAAK,OAAO,MAAM,CAAC,IAAK,KAAK,MAAM,CAAC;AAC1E,MAAI,MAAM,WAAW,EAAG,QAAO,MAAM,CAAC,IAAK,KAAK,MAAM,CAAC;AACvD,SAAO;AACT;AAEO,IAAM,gBAAN,MAAwC;AAAA,EACpC,qBAA6B;AAAA,EAEtC,gBAAgB,MAAoD;AAClE,QAAI,CAAC,KAAK,OAAQ,QAAO,QAAQ,QAAQ,oBAAI,IAAI,CAAC;AAElD,WAAO,IAAI,QAAQ,aAAW;AAC5B;AAAA,QACE,4BAA4B,KAAK,KAAK,GAAG,CAAC;AAAA,QAC1C,EAAE,UAAU,QAAQ,SAAS,IAAK;AAAA,QAClC,CAAC,KAAK,WAAW;AACf,gBAAM,MAAM,oBAAI,IAA0B;AAC1C,cAAI,OAAO,CAAC,OAAQ,QAAO,QAAQ,GAAG;AAEtC,qBAAW,QAAQ,OAAO,KAAK,EAAE,MAAM,IAAI,GAAG;AAC5C,kBAAM,QAAQ,KAAK,KAAK,EAAE,MAAM,KAAK;AACrC,gBAAI,MAAM,SAAS,EAAG;AACtB,kBAAM,MAAM,SAAS,MAAM,CAAC,GAAI,EAAE;AAClC,gBAAI,IAAI,KAAK;AAAA,cACX,KAAK,SAAS,MAAM,CAAC,GAAI,EAAE,KAAK;AAAA,cAChC,YAAY,YAAY,MAAM,CAAC,CAAE;AAAA,YACnC,CAAC;AAAA,UACH;AACA,kBAAQ,GAAG;AAAA,QACb;AAAA,MACF;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,SAAS,KAAa,SAAyB,WAAiB;AAC9D,QAAI;AAAE,cAAQ,KAAK,CAAC,KAAK,MAAM;AAAA,IAAG,QAAQ;AACxC,UAAI;AAAE,gBAAQ,KAAK,KAAK,MAAM;AAAA,MAAG,QAAQ;AAAA,MAAqB;AAAA,IAChE;AAAA,EACF;AAAA,EAEA,YAAY,KAAmB;AAC7B,UAAM,YAAY,CAAC,GAAG,GAAG,EAAE,UAAU,MAAM,OAAO,SAAS,CAAC,EAAE,MAAM;AAAA,EACtE;AACF;","names":[]}

package/dist/config/cli.d.ts

@@ -0,0 +1,17 @@
+import type { ServiceConfig } from './types.js';
+export interface CliArgs {
+    configPath?: string;
+    only?: string;
+    skip: string[];
+    services?: string[];
+    lazy: boolean;
+    lazyTimeout: number;
+    proxy: boolean;
+    proxyHost?: string;
+    proxyConf?: string;
+    proxyTls: boolean;
+    proxyEntrypoint: string;
+}
+export declare function parseCliArgs(argv: string[]): CliArgs;
+export declare function filterServices(services: ServiceConfig[], args: CliArgs): ServiceConfig[];
+//# sourceMappingURL=cli.d.ts.map

package/dist/config/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/config/cli.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,OAAO;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;CACzB;AAID,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAgCpD;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,OAAO,GAAG,aAAa,EAAE,CAoBxF"}

package/dist/config/loader.d.ts

@@ -0,0 +1,4 @@
+import type { DevStackConfig } from './types.js';
+export declare function findConfigFile(cwd: string, explicit?: string): string;
+export declare function loadConfig(configPath: string): Promise<DevStackConfig>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAQjD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAcrE;AAED,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAgB5E"}

package/dist/config/types.d.ts

@@ -0,0 +1,37 @@
+export interface ServiceConfig {
+    name: string;
+    cwd: string;
+    cmd: string;
+    args: string[];
+    type: 'api' | 'web';
+    port: number;
+    phase: number;
+    maxMem?: number;
+    preBuild?: string;
+    watchBuild?: string;
+    nodeArgs?: string[];
+    extraEnv?: Record<string, string>;
+}
+export interface LazyConfig {
+    alwaysOn: string[];
+    timeout?: number;
+}
+export interface ProxyConfig {
+    provider: string;
+    routes: Record<string, string>;
+    confPath?: string;
+    host?: string;
+    tls?: boolean;
+    entrypoint?: string;
+}
+export interface DevStackConfig {
+    name: string;
+    icon?: string;
+    envFile?: string;
+    env?: Record<string, string>;
+    services: ServiceConfig[];
+    lazy?: LazyConfig;
+    proxy?: ProxyConfig;
+}
+export declare function defineConfig(config: DevStackConfig): DevStackConfig;
+//# sourceMappingURL=types.d.ts.map

package/dist/config/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,KAAK,GAAG,KAAK,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAEnE"}

package/dist/config/validator.d.ts

@@ -0,0 +1,8 @@
+import type { DevStackConfig } from './types.js';
+export interface ValidationError {
+    field: string;
+    message: string;
+}
+export declare function validateConfig(config: DevStackConfig, cwd: string): ValidationError[];
+export declare function formatValidationErrors(errors: ValidationError[]): string;
+//# sourceMappingURL=validator.d.ts.map

package/dist/config/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/config/validator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,eAAe,EAAE,CAuErF;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,CAExE"}

package/dist/darwin-3KJ3IEXN.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import {
+  LinuxPlatform
+} from "./chunk-LG7UD5ZR.js";
+
+// src/platform/darwin.ts
+import { spawn } from "child_process";
+var DarwinPlatform = class extends LinuxPlatform {
+  defaultTraefikHost = "host.docker.internal";
+  openBrowser(url) {
+    spawn("open", [url], { detached: true, stdio: "ignore" }).unref();
+  }
+};
+export {
+  DarwinPlatform
+};
+//# sourceMappingURL=darwin-3KJ3IEXN.js.map

package/dist/darwin-3KJ3IEXN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/platform/darwin.ts"],"sourcesContent":["import { spawn } from 'node:child_process';\nimport { LinuxPlatform } from './linux.js';\n\nexport class DarwinPlatform extends LinuxPlatform {\n  override readonly defaultTraefikHost = 'host.docker.internal';\n\n  override openBrowser(url: string): void {\n    spawn('open', [url], { detached: true, stdio: 'ignore' }).unref();\n  }\n}\n"],"mappings":";;;;;;AAAA,SAAS,aAAa;AAGf,IAAM,iBAAN,cAA6B,cAAc;AAAA,EAC9B,qBAAqB;AAAA,EAE9B,YAAY,KAAmB;AACtC,UAAM,QAAQ,CAAC,GAAG,GAAG,EAAE,UAAU,MAAM,OAAO,SAAS,CAAC,EAAE,MAAM;AAAA,EAClE;AACF;","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { defineConfig } from './config/types.js';
+export type { DevStackConfig, ServiceConfig, LazyConfig, ProxyConfig } from './config/types.js';
+export type { Platform, ProcessStats } from './platform/types.js';
+export type { ProxyConfigProvider, ProxyOpts } from './proxy-config/types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChG,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAClE,YAAY,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC"}