openboot 0.1.0

package/dist/lib/tail.d.ts

@@ -0,0 +1,12 @@
+import { BootConfig } from "../types";
+interface TailHandle {
+    /** Stop all watchers and clean up. */
+    stop: () => void;
+}
+/**
+ * Stream all app logs to stdout, interleaved and color-coded by service name.
+ * Returns a handle to stop tailing.
+ */
+export declare function tailAllLogs(config: BootConfig): TailHandle;
+export {};
+//# sourceMappingURL=tail.d.ts.map

package/dist/lib/tail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tail.d.ts","sourceRoot":"","sources":["../../src/lib/tail.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAoBtC,UAAU,UAAU;IAClB,sCAAsC;IACtC,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAwF1D"}

package/dist/lib/tail.js

@@ -0,0 +1,136 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tailAllLogs = tailAllLogs;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const LOGS_DIR = path.join(".boot", "logs");
+/**
+ * ANSI color codes for service labels.
+ */
+const COLORS = [
+    "\x1b[36m", // cyan
+    "\x1b[33m", // yellow
+    "\x1b[35m", // magenta
+    "\x1b[32m", // green
+    "\x1b[34m", // blue
+    "\x1b[91m", // bright red
+    "\x1b[93m", // bright yellow
+    "\x1b[95m", // bright magenta
+];
+const RESET = "\x1b[0m";
+const DIM = "\x1b[2m";
+/**
+ * Stream all app logs to stdout, interleaved and color-coded by service name.
+ * Returns a handle to stop tailing.
+ */
+function tailAllLogs(config) {
+    const watchers = [];
+    const positions = new Map();
+    const apps = config.apps || [];
+    const maxNameLen = Math.max(...apps.map((a) => a.name.length), 5);
+    // Print initial message
+    console.log(`${DIM}Streaming logs for ${apps.length} service${apps.length !== 1 ? "s" : ""}... (Ctrl+C to detach)${RESET}\n`);
+    for (let i = 0; i < apps.length; i++) {
+        const app = apps[i];
+        const color = COLORS[i % COLORS.length];
+        const logPath = path.join(LOGS_DIR, `${app.name}.log`);
+        const label = app.name.padEnd(maxNameLen);
+        // Read existing content from the end (last 5 lines for context)
+        if (fs.existsSync(logPath)) {
+            const content = fs.readFileSync(logPath, "utf-8");
+            const lines = content.split("\n");
+            const startLine = Math.max(0, lines.length - 6);
+            const tail = lines.slice(startLine).join("\n").trim();
+            if (tail) {
+                for (const line of tail.split("\n")) {
+                    console.log(`${color}${label}${RESET} ${DIM}│${RESET} ${line}`);
+                }
+            }
+            positions.set(app.name, content.length);
+        }
+        else {
+            positions.set(app.name, 0);
+        }
+        // Watch for changes
+        try {
+            // Ensure the log file exists
+            if (!fs.existsSync(logPath)) {
+                fs.mkdirSync(path.dirname(logPath), { recursive: true });
+                fs.writeFileSync(logPath, "");
+            }
+            const watcher = fs.watch(logPath, () => {
+                try {
+                    const stat = fs.statSync(logPath);
+                    const prevPos = positions.get(app.name) || 0;
+                    if (stat.size > prevPos) {
+                        // Read new content
+                        const fd = fs.openSync(logPath, "r");
+                        const buf = Buffer.alloc(stat.size - prevPos);
+                        fs.readSync(fd, buf, 0, buf.length, prevPos);
+                        fs.closeSync(fd);
+                        const newContent = buf.toString("utf-8");
+                        const newLines = newContent.split("\n");
+                        for (const line of newLines) {
+                            if (line.trim()) {
+                                console.log(`${color}${label}${RESET} ${DIM}│${RESET} ${line}`);
+                            }
+                        }
+                        positions.set(app.name, stat.size);
+                    }
+                    else if (stat.size < prevPos) {
+                        // File was truncated (e.g. after clean)
+                        positions.set(app.name, 0);
+                    }
+                }
+                catch {
+                    // File might have been deleted
+                }
+            });
+            watchers.push(watcher);
+        }
+        catch {
+            // Can't watch this file
+        }
+    }
+    return {
+        stop: () => {
+            for (const w of watchers) {
+                w.close();
+            }
+        },
+    };
+}
+//# sourceMappingURL=tail.js.map

package/dist/lib/tail.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,71 @@
+export interface BootConfig {
+    /** Project name */
+    name: string;
+    /** Package manager override (auto-detected if omitted) */
+    packageManager?: "pnpm" | "npm" | "yarn";
+    /** Environment file validation */
+    env?: EnvConfig;
+    /** One-time setup commands (run via `boot setup`) */
+    setup?: string[];
+    /** Docker services (compose-based or raw containers) */
+    docker?: DockerConfig;
+    /** Application processes managed by boot */
+    apps?: AppConfig[];
+}
+export interface EnvConfig {
+    /** Path to .env file (default: .env) */
+    file?: string;
+    /** Required environment variables — boot up will fail if these are missing */
+    required?: string[];
+    /** Values that should be rejected (e.g. example/default secrets) */
+    reject?: Record<string, string[]>;
+}
+export interface DockerConfig {
+    /** Path to compose file (default: docker-compose.yml) */
+    composeFile?: string;
+    /** Services managed via docker compose (requires composeFile) */
+    services?: DockerService[];
+    /** Standalone containers managed via docker run/start (no compose needed) */
+    containers?: ContainerConfig[];
+}
+export interface DockerService {
+    /** Service name (used for display) */
+    name: string;
+    /** Container name (for docker exec; defaults to name) */
+    container?: string;
+    /** Command to run inside container to check readiness */
+    readyCheck?: string;
+    /** Seconds to wait for readiness (default: 30) */
+    timeout?: number;
+}
+export interface ContainerConfig {
+    /** Container name */
+    name: string;
+    /** Docker image */
+    image: string;
+    /** Port mappings (e.g. "5433:5432") */
+    ports?: string[];
+    /** Environment variables for the container */
+    env?: Record<string, string>;
+    /** Volume mounts */
+    volumes?: string[];
+    /** Command to run inside container to check readiness */
+    readyCheck?: string;
+    /** Seconds to wait for readiness (default: 30) */
+    timeout?: number;
+}
+export interface AppConfig {
+    /** App name (used for display, PID files, log files) */
+    name: string;
+    /** Working directory relative to project root */
+    path?: string;
+    /** Command to start the app */
+    command: string;
+    /** Port the app listens on */
+    port?: number;
+    /** URL to poll for health check */
+    health?: string;
+    /** Extra environment variables */
+    env?: Record<string, string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IAEb,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;IAEzC,kCAAkC;IAClC,GAAG,CAAC,EAAE,SAAS,CAAC;IAEhB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjB,wDAAwD;IACxD,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAE3B,6EAA6E;IAC7E,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IAEb,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IAEb,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IAEd,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjB,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7B,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IAEb,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAEhB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,kCAAkC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "openboot",
+  "version": "0.1.0",
+  "description": "Dev stack lifecycle manager. One command to setup, start, stop, and reboot your projects.",
+  "author": "Treadie, Inc.",
+  "license": "FSL-1.1-MIT",
+  "bin": {
+    "boot": "./dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "commander": "^13.1.0",
+    "yaml": "^2.7.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}