@doriandev/devcc 0.1.2

package/dist/devcc/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Public API for Dev Command Center.
+ *
+ * Project config files import `defineConfig` from here; embedders can drive the
+ * `App` directly or reuse individual pieces (process manager, service adapters,
+ * git parsing) without the UI.
+ */
+export { App, type AppOptions } from "./app/App.js";
+export { createBuiltinCommands, createConfigCommands, createScriptCommands } from "./app/builtinCommands.js";
+export { HELP_SECTIONS, VIEW_SHORTCUTS } from "./app/keymap.js";
+export { theme, glyphs, processStatusStyle, serviceStateStyle } from "./app/theme.js";
+export { CommandRegistry, type CommandContext, type CommandDefinition } from "./core/commands.js";
+export { defineConfig, loadConfig, validateConfig, findConfigFile, CONFIG_FILENAMES, DEFAULT_REFRESH, type CommandConfigEntry, type DevccConfig, type ResolvedConfig, type ServiceConfigEntry, } from "./core/config.js";
+export { TypedEmitter, Subscriptions, type Unsubscribe } from "./core/events.js";
+export { Store, VIEW_IDS, createInitialState, type AppState, type Notification, type ProjectState, type UiState, type ViewId, } from "./core/state.js";
+export { DependencyService, updateArgs, type DependencySnapshot } from "./deps/DependencyService.js";
+export { outdatedArgs, parseOutdated, severityBetween, sortOutdated, summariseOutdated, supportsOutdatedJson, type OutdatedPackage, type UpdateSeverity, } from "./deps/parse.js";
+export { GitService, type GitSnapshot } from "./git/GitService.js";
+export { parseCommits, parsePorcelainV2, summariseStatus, summariseTracking, type GitCommit, type GitFile, type GitStatus, } from "./git/parse.js";
+export { LogBuffer, LogStore, MAX_LOG_LINES, type LogEntry, type LogSource, type LogStream, } from "./logs/LogBuffer.js";
+export { canTransition, crashBackoffDelay, shouldAutoRestart, DEFAULT_CRASH_POLICY, createManagedProcess, describeCommand, isActive, type ManagedProcess, type ProcessDefinition, type ProcessStatus, type ReadinessCheck, } from "./processes/ManagedProcess.js";
+export { dependentsOf, planStartOrder, type StartPlan } from "./processes/graph.js";
+export { ProcessManager, type ProcessManagerOptions } from "./processes/ProcessManager.js";
+export { buildProjectList, discoverProjects, isProjectDirectory, readRecents, recordRecent, type ProjectEntry, } from "./projects/ProjectRegistry.js";
+export { ServiceManager } from "./services/ServiceManager.js";
+export { DockerService, findComposeFile, parseComposePs } from "./services/docker.js";
+export { PortService, detectNodeServices } from "./services/node.js";
+export { OllamaService } from "./services/ollama.js";
+export { PostgresService, parsePostgresUrl } from "./services/postgres.js";
+export { RedisService, parseRedisUrl } from "./services/redis.js";
+export type { ServiceAdapter, ServiceSnapshot, ServiceState, ServiceStatus } from "./services/types.js";
+export { SystemMonitor, cpuUsageBetween, sampleCpu, type SystemMetrics } from "./system/SystemMonitor.js";
+export { DevccError, errorMessage, toDevccError } from "./utils/errors.js";
+export { Logger, createLogger, type LogLevel } from "./utils/logger.js";
+export { detectPackageManager, readPackageJson, readScripts, runScriptArgs, type PackageManager, } from "./utils/packageManager.js";
+export { findProjectRoot } from "./utils/paths.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/devcc/index.d.ts.map

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

package/dist/devcc/index.js

@@ -0,0 +1,36 @@
+/**
+ * Public API for Dev Command Center.
+ *
+ * Project config files import `defineConfig` from here; embedders can drive the
+ * `App` directly or reuse individual pieces (process manager, service adapters,
+ * git parsing) without the UI.
+ */
+export { App } from "./app/App.js";
+export { createBuiltinCommands, createConfigCommands, createScriptCommands } from "./app/builtinCommands.js";
+export { HELP_SECTIONS, VIEW_SHORTCUTS } from "./app/keymap.js";
+export { theme, glyphs, processStatusStyle, serviceStateStyle } from "./app/theme.js";
+export { CommandRegistry } from "./core/commands.js";
+export { defineConfig, loadConfig, validateConfig, findConfigFile, CONFIG_FILENAMES, DEFAULT_REFRESH, } from "./core/config.js";
+export { TypedEmitter, Subscriptions } from "./core/events.js";
+export { Store, VIEW_IDS, createInitialState, } from "./core/state.js";
+export { DependencyService, updateArgs } from "./deps/DependencyService.js";
+export { outdatedArgs, parseOutdated, severityBetween, sortOutdated, summariseOutdated, supportsOutdatedJson, } from "./deps/parse.js";
+export { GitService } from "./git/GitService.js";
+export { parseCommits, parsePorcelainV2, summariseStatus, summariseTracking, } from "./git/parse.js";
+export { LogBuffer, LogStore, MAX_LOG_LINES, } from "./logs/LogBuffer.js";
+export { canTransition, crashBackoffDelay, shouldAutoRestart, DEFAULT_CRASH_POLICY, createManagedProcess, describeCommand, isActive, } from "./processes/ManagedProcess.js";
+export { dependentsOf, planStartOrder } from "./processes/graph.js";
+export { ProcessManager } from "./processes/ProcessManager.js";
+export { buildProjectList, discoverProjects, isProjectDirectory, readRecents, recordRecent, } from "./projects/ProjectRegistry.js";
+export { ServiceManager } from "./services/ServiceManager.js";
+export { DockerService, findComposeFile, parseComposePs } from "./services/docker.js";
+export { PortService, detectNodeServices } from "./services/node.js";
+export { OllamaService } from "./services/ollama.js";
+export { PostgresService, parsePostgresUrl } from "./services/postgres.js";
+export { RedisService, parseRedisUrl } from "./services/redis.js";
+export { SystemMonitor, cpuUsageBetween, sampleCpu } from "./system/SystemMonitor.js";
+export { DevccError, errorMessage, toDevccError } from "./utils/errors.js";
+export { Logger, createLogger } from "./utils/logger.js";
+export { detectPackageManager, readPackageJson, readScripts, runScriptArgs, } from "./utils/packageManager.js";
+export { findProjectRoot } from "./utils/paths.js";
+//# sourceMappingURL=index.js.map

package/dist/devcc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/devcc/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,GAAG,EAAmB,MAAM,cAAc,CAAA;AACnD,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAC5G,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAC/D,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAErF,OAAO,EAAE,eAAe,EAA+C,MAAM,oBAAoB,CAAA;AACjG,OAAO,EACL,YAAY,EACZ,UAAU,EACV,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,eAAe,GAKhB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAoB,MAAM,kBAAkB,CAAA;AAChF,OAAO,EACL,KAAK,EACL,QAAQ,EACR,kBAAkB,GAMnB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAA2B,MAAM,6BAA6B,CAAA;AACpG,OAAO,EACL,YAAY,EACZ,aAAa,EACb,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,GAGrB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EAAE,UAAU,EAAoB,MAAM,qBAAqB,CAAA;AAClE,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,iBAAiB,GAIlB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EACL,SAAS,EACT,QAAQ,EACR,aAAa,GAId,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,QAAQ,GAKT,MAAM,+BAA+B,CAAA;AACtC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAkB,MAAM,sBAAsB,CAAA;AACnF,OAAO,EAAE,cAAc,EAA8B,MAAM,+BAA+B,CAAA;AAE1F,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,YAAY,GAEb,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrF,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC1E,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAGjE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,SAAS,EAAsB,MAAM,2BAA2B,CAAA;AAEzG,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAC1E,OAAO,EAAE,MAAM,EAAE,YAAY,EAAiB,MAAM,mBAAmB,CAAA;AACvE,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,aAAa,GAEd,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/devcc/logs/LogBuffer.d.ts

@@ -0,0 +1,86 @@
+import { TypedEmitter } from "../core/events.js";
+/** Default cap for a single source's in-memory history. */
+export declare const MAX_LOG_LINES = 5000;
+export type LogStream = "stdout" | "stderr" | "system";
+export interface LogEntry {
+    /** Monotonic per-buffer sequence number; used for cheap "has it changed?" checks. */
+    seq: number;
+    timestamp: Date;
+    stream: LogStream;
+    text: string;
+}
+/**
+ * Fixed-capacity ring buffer.
+ *
+ * Memory is bounded by construction: once `capacity` lines are stored, each new
+ * line overwrites the oldest one. Nothing else in the app is allowed to retain
+ * log lines.
+ */
+export declare class LogBuffer {
+    readonly id: string;
+    readonly capacity: number;
+    private readonly entries;
+    private writeIndex;
+    private count;
+    private nextSeq;
+    private pendingPartial;
+    constructor(id: string, capacity?: number);
+    get size(): number;
+    /** Total lines ever written, including evicted ones. */
+    get totalWritten(): number;
+    /** True when the oldest lines have been dropped. */
+    get truncated(): boolean;
+    push(text: string, stream?: LogStream, timestamp?: Date): LogEntry;
+    /**
+     * Feed a raw chunk from a child process. Splits on newlines and holds back an
+     * unterminated trailing fragment until the rest arrives.
+     */
+    pushChunk(chunk: string, stream?: LogStream): LogEntry[];
+    /** Flush a held-back partial line (call when the stream closes). */
+    flush(stream?: LogStream): LogEntry[];
+    /** Entries in chronological order. */
+    toArray(): LogEntry[];
+    /** The most recent `n` entries, chronologically ordered. */
+    tail(n: number): LogEntry[];
+    /** A window of the chronological history, used by the scrolling log viewer. */
+    slice(offset: number, length: number): LogEntry[];
+    clear(): void;
+}
+export interface LogSource {
+    id: string;
+    label: string;
+}
+export type LogStoreEvents = {
+    "log:append": [string, LogEntry[]];
+    "log:clear": [string];
+    "log:sources": [LogSource[]];
+};
+/**
+ * Owns one `LogBuffer` per source (managed process, script run, or devcc itself)
+ * and announces changes so the Logs view can update without polling.
+ */
+export declare class LogStore extends TypedEmitter<LogStoreEvents> {
+    private readonly capacity;
+    private readonly buffers;
+    private readonly labels;
+    constructor(capacity?: number);
+    register(id: string, label: string): LogBuffer;
+    unregister(id: string): void;
+    get(id: string): LogBuffer | undefined;
+    has(id: string): boolean;
+    sources(): LogSource[];
+    append(id: string, text: string, stream?: LogStream): void;
+    appendChunk(id: string, chunk: string, stream: LogStream): void;
+    flush(id: string): void;
+    clear(id: string): void;
+    clearAll(): void;
+}
+/**
+ * Remove terminal control sequences from a captured line.
+ *
+ * Children are told `FORCE_COLOR=0`, but watchers such as `tsc --watch` still
+ * clear the screen and move the cursor; rendered verbatim those bytes would
+ * corrupt the viewer (or, in the merged stream, someone else's line).
+ */
+export declare function stripControlSequences(text: string): string;
+//# sourceMappingURL=LogBuffer.d.ts.map

package/dist/devcc/logs/LogBuffer.d.ts.map

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

package/dist/devcc/logs/LogBuffer.js

@@ -0,0 +1,200 @@
+import { TypedEmitter } from "../core/events.js";
+/** Default cap for a single source's in-memory history. */
+export const MAX_LOG_LINES = 5_000;
+/**
+ * Fixed-capacity ring buffer.
+ *
+ * Memory is bounded by construction: once `capacity` lines are stored, each new
+ * line overwrites the oldest one. Nothing else in the app is allowed to retain
+ * log lines.
+ */
+export class LogBuffer {
+    id;
+    capacity;
+    entries;
+    writeIndex = 0;
+    count = 0;
+    nextSeq = 0;
+    pendingPartial = { stdout: "", stderr: "", system: "" };
+    constructor(id, capacity = MAX_LOG_LINES) {
+        this.id = id;
+        this.capacity = capacity;
+        if (capacity <= 0)
+            throw new RangeError("LogBuffer capacity must be > 0");
+        this.entries = new Array(capacity);
+    }
+    get size() {
+        return this.count;
+    }
+    /** Total lines ever written, including evicted ones. */
+    get totalWritten() {
+        return this.nextSeq;
+    }
+    /** True when the oldest lines have been dropped. */
+    get truncated() {
+        return this.nextSeq > this.capacity;
+    }
+    push(text, stream = "stdout", timestamp = new Date()) {
+        const entry = { seq: this.nextSeq++, timestamp, stream, text: stripControlSequences(text) };
+        this.entries[this.writeIndex] = entry;
+        this.writeIndex = (this.writeIndex + 1) % this.capacity;
+        if (this.count < this.capacity)
+            this.count += 1;
+        return entry;
+    }
+    /**
+     * Feed a raw chunk from a child process. Splits on newlines and holds back an
+     * unterminated trailing fragment until the rest arrives.
+     */
+    pushChunk(chunk, stream = "stdout") {
+        const combined = this.pendingPartial[stream] + chunk;
+        const parts = combined.split(/\r?\n/u);
+        this.pendingPartial[stream] = parts.pop() ?? "";
+        return parts.map((line) => this.push(stripTrailingCarriage(line), stream));
+    }
+    /** Flush a held-back partial line (call when the stream closes). */
+    flush(stream) {
+        const streams = stream ? [stream] : ["stdout", "stderr", "system"];
+        const flushed = [];
+        for (const name of streams) {
+            const partial = this.pendingPartial[name];
+            if (partial.length > 0) {
+                this.pendingPartial[name] = "";
+                flushed.push(this.push(stripTrailingCarriage(partial), name));
+            }
+        }
+        return flushed;
+    }
+    /** Entries in chronological order. */
+    toArray() {
+        const result = [];
+        const start = this.count < this.capacity ? 0 : this.writeIndex;
+        for (let i = 0; i < this.count; i += 1) {
+            const entry = this.entries[(start + i) % this.capacity];
+            if (entry)
+                result.push(entry);
+        }
+        return result;
+    }
+    /** The most recent `n` entries, chronologically ordered. */
+    tail(n) {
+        if (n <= 0)
+            return [];
+        const all = this.toArray();
+        return all.slice(Math.max(0, all.length - n));
+    }
+    /** A window of the chronological history, used by the scrolling log viewer. */
+    slice(offset, length) {
+        const all = this.toArray();
+        const start = Math.max(0, Math.min(offset, all.length));
+        return all.slice(start, start + Math.max(0, length));
+    }
+    clear() {
+        this.entries.fill(undefined);
+        this.writeIndex = 0;
+        this.count = 0;
+        this.pendingPartial = { stdout: "", stderr: "", system: "" };
+    }
+}
+/**
+ * Owns one `LogBuffer` per source (managed process, script run, or devcc itself)
+ * and announces changes so the Logs view can update without polling.
+ */
+export class LogStore extends TypedEmitter {
+    capacity;
+    buffers = new Map();
+    labels = new Map();
+    constructor(capacity = MAX_LOG_LINES) {
+        super();
+        this.capacity = capacity;
+    }
+    register(id, label) {
+        const existing = this.buffers.get(id);
+        if (existing) {
+            if (this.labels.get(id) !== label) {
+                this.labels.set(id, label);
+                this.emit("log:sources", this.sources());
+            }
+            return existing;
+        }
+        const buffer = new LogBuffer(id, this.capacity);
+        this.buffers.set(id, buffer);
+        this.labels.set(id, label);
+        this.emit("log:sources", this.sources());
+        return buffer;
+    }
+    unregister(id) {
+        if (this.buffers.delete(id)) {
+            this.labels.delete(id);
+            this.emit("log:sources", this.sources());
+        }
+    }
+    get(id) {
+        return this.buffers.get(id);
+    }
+    has(id) {
+        return this.buffers.has(id);
+    }
+    sources() {
+        return [...this.buffers.keys()].map((id) => ({ id, label: this.labels.get(id) ?? id }));
+    }
+    append(id, text, stream = "system") {
+        const buffer = this.buffers.get(id) ?? this.register(id, id);
+        const entry = buffer.push(text, stream);
+        this.emit("log:append", id, [entry]);
+    }
+    appendChunk(id, chunk, stream) {
+        const buffer = this.buffers.get(id) ?? this.register(id, id);
+        const entries = buffer.pushChunk(chunk, stream);
+        if (entries.length > 0)
+            this.emit("log:append", id, entries);
+    }
+    flush(id) {
+        const buffer = this.buffers.get(id);
+        if (!buffer)
+            return;
+        const entries = buffer.flush();
+        if (entries.length > 0)
+            this.emit("log:append", id, entries);
+    }
+    clear(id) {
+        this.buffers.get(id)?.clear();
+        this.emit("log:clear", id);
+    }
+    clearAll() {
+        for (const id of this.buffers.keys())
+            this.clear(id);
+    }
+}
+function stripTrailingCarriage(line) {
+    return line.endsWith("\r") ? line.slice(0, -1) : line;
+}
+const ESC = String.fromCharCode(27);
+const BEL = String.fromCharCode(7);
+/** CSI sequences (`ESC [ ... final`), including screen clears and cursor moves. */
+const CSI_SEQUENCE = new RegExp(`${ESC}\\[[0-?]*[ -/]*[@-~]`, "gu");
+/** OSC sequences (`ESC ] ... BEL` or `ESC ] ... ESC \\`), e.g. window titles and hyperlinks. */
+const OSC_SEQUENCE = new RegExp(`${ESC}\\][^${BEL}${ESC}]*(?:${BEL}|${ESC}\\\\)`, "gu");
+/**
+ * Two-byte escapes such as `ESC c` (reset) and `ESC 7`/`ESC 8` (save/restore
+ * cursor). Any printable after a bare ESC is an escape by definition.
+ */
+const SIMPLE_ESCAPE = new RegExp(`${ESC}[0-~]`, "gu");
+/** Remaining C0 controls apart from tab. Matching control characters is the point here. */
+// eslint-disable-next-line no-control-regex
+const C0_CONTROLS = /[\u0000-\u0008\u000b-\u001f\u007f]/gu;
+/**
+ * Remove terminal control sequences from a captured line.
+ *
+ * Children are told `FORCE_COLOR=0`, but watchers such as `tsc --watch` still
+ * clear the screen and move the cursor; rendered verbatim those bytes would
+ * corrupt the viewer (or, in the merged stream, someone else's line).
+ */
+export function stripControlSequences(text) {
+    return text
+        .replace(CSI_SEQUENCE, "")
+        .replace(OSC_SEQUENCE, "")
+        .replace(SIMPLE_ESCAPE, "")
+        .replace(C0_CONTROLS, "");
+}
+//# sourceMappingURL=LogBuffer.js.map

package/dist/devcc/logs/LogBuffer.js.map

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

package/dist/devcc/logs/merge.d.ts

@@ -0,0 +1,36 @@
+import type { LogBuffer, LogEntry } from "./LogBuffer.js";
+/** A log line that knows which source it came from. */
+export interface SourcedLogEntry {
+    sourceId: string;
+    entry: LogEntry;
+}
+/** The synthetic source id that shows every buffer merged into one stream. */
+export declare const ALL_SOURCES = "*";
+/** Upper bound on how many lines the merged stream materialises at once. */
+export declare const MERGED_LIMIT = 2000;
+/**
+ * Merge the tails of several chronological buffers into one chronological
+ * stream, bounded by `limit` lines in total.
+ *
+ * Each buffer is already ordered, so taking the last `limit` of each and
+ * sorting once is both simple and cheap enough for a few thousand lines.
+ * Ties on timestamp fall back to sequence number, which is per-buffer, so a
+ * stable sort keeps the input order between buffers.
+ */
+export declare function mergeTails(buffers: readonly LogBuffer[], limit?: number): SourcedLogEntry[];
+export interface LogFilter {
+    /** Case-insensitive substring, or a regular expression if it parses as one. */
+    query: string;
+    /** Show only stderr lines. */
+    errorsOnly: boolean;
+}
+export declare const EMPTY_LOG_FILTER: LogFilter;
+/**
+ * Compile a user query. Anything that fails to parse as a regex is treated as
+ * a literal, so typing `(` never breaks the view.
+ */
+export declare function compileQuery(query: string): ((text: string) => boolean) | null;
+export declare function filterEntries(entries: readonly SourcedLogEntry[], filter: LogFilter): SourcedLogEntry[];
+export declare function isFilterActive(filter: LogFilter): boolean;
+export declare function describeFilter(filter: LogFilter): string;
+//# sourceMappingURL=merge.d.ts.map

package/dist/devcc/logs/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../../src/devcc/logs/merge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEzD,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,QAAQ,CAAA;CAChB;AAED,8EAA8E;AAC9E,eAAO,MAAM,WAAW,MAAM,CAAA;AAE9B,4EAA4E;AAC5E,eAAO,MAAM,YAAY,OAAQ,CAAA;AAEjC;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,EAAE,KAAK,GAAE,MAAqB,GAAG,eAAe,EAAE,CAgBzG;AAED,MAAM,WAAW,SAAS;IACxB,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAA;IACb,8BAA8B;IAC9B,UAAU,EAAE,OAAO,CAAA;CACpB;AAED,eAAO,MAAM,gBAAgB,EAAE,SAA4C,CAAA;AAE3E;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,IAAI,CAW9E;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,EAAE,MAAM,EAAE,SAAS,GAAG,eAAe,EAAE,CAQvG;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAEzD;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAKxD"}

package/dist/devcc/logs/merge.js

@@ -0,0 +1,71 @@
+/** The synthetic source id that shows every buffer merged into one stream. */
+export const ALL_SOURCES = "*";
+/** Upper bound on how many lines the merged stream materialises at once. */
+export const MERGED_LIMIT = 2_000;
+/**
+ * Merge the tails of several chronological buffers into one chronological
+ * stream, bounded by `limit` lines in total.
+ *
+ * Each buffer is already ordered, so taking the last `limit` of each and
+ * sorting once is both simple and cheap enough for a few thousand lines.
+ * Ties on timestamp fall back to sequence number, which is per-buffer, so a
+ * stable sort keeps the input order between buffers.
+ */
+export function mergeTails(buffers, limit = MERGED_LIMIT) {
+    if (limit <= 0)
+        return [];
+    const combined = [];
+    for (const buffer of buffers) {
+        for (const entry of buffer.tail(limit))
+            combined.push({ sourceId: buffer.id, entry });
+    }
+    combined.sort((a, b) => {
+        const byTime = a.entry.timestamp.getTime() - b.entry.timestamp.getTime();
+        if (byTime !== 0)
+            return byTime;
+        if (a.sourceId === b.sourceId)
+            return a.entry.seq - b.entry.seq;
+        return 0;
+    });
+    return combined.length > limit ? combined.slice(combined.length - limit) : combined;
+}
+export const EMPTY_LOG_FILTER = { query: "", errorsOnly: false };
+/**
+ * Compile a user query. Anything that fails to parse as a regex is treated as
+ * a literal, so typing `(` never breaks the view.
+ */
+export function compileQuery(query) {
+    const trimmed = query.trim();
+    if (trimmed === "")
+        return null;
+    try {
+        const pattern = new RegExp(trimmed, "iu");
+        return (text) => pattern.test(text);
+    }
+    catch {
+        const needle = trimmed.toLowerCase();
+        return (text) => text.toLowerCase().includes(needle);
+    }
+}
+export function filterEntries(entries, filter) {
+    const matches = compileQuery(filter.query);
+    if (!matches && !filter.errorsOnly)
+        return [...entries];
+    return entries.filter(({ entry }) => {
+        if (filter.errorsOnly && entry.stream !== "stderr")
+            return false;
+        return matches ? matches(entry.text) : true;
+    });
+}
+export function isFilterActive(filter) {
+    return filter.query.trim() !== "" || filter.errorsOnly;
+}
+export function describeFilter(filter) {
+    const parts = [];
+    if (filter.query.trim() !== "")
+        parts.push(`/${filter.query.trim()}/`);
+    if (filter.errorsOnly)
+        parts.push("errors only");
+    return parts.join(" · ");
+}
+//# sourceMappingURL=merge.js.map

package/dist/devcc/logs/merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../../../src/devcc/logs/merge.ts"],"names":[],"mappings":"AAQA,8EAA8E;AAC9E,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAA;AAE9B,4EAA4E;AAC5E,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAA;AAEjC;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,OAA6B,EAAE,QAAgB,YAAY;IACpF,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,EAAE,CAAA;IAEzB,MAAM,QAAQ,GAAsB,EAAE,CAAA;IACtC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;IACvF,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACrB,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,EAAE,CAAA;QACxE,IAAI,MAAM,KAAK,CAAC;YAAE,OAAO,MAAM,CAAA;QAC/B,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ;YAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAA;QAC/D,OAAO,CAAC,CAAA;IACV,CAAC,CAAC,CAAA;IAEF,OAAO,QAAQ,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAA;AACrF,CAAC;AASD,MAAM,CAAC,MAAM,gBAAgB,GAAc,EAAE,KAAK,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAA;AAE3E;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IAC5B,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,IAAI,CAAA;IAE/B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;QACzC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAA;QACpC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;IACtD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAmC,EAAE,MAAiB;IAClF,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC1C,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU;QAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAA;IAEvD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;QAClC,IAAI,MAAM,CAAC,UAAU,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAA;QAChE,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAC7C,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAiB;IAC9C,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,MAAM,CAAC,UAAU,CAAA;AACxD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAiB;IAC9C,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,KAAK,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IACtE,IAAI,MAAM,CAAC,UAAU;QAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;IAChD,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AAC1B,CAAC"}

package/dist/devcc/processes/ManagedProcess.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Types and pure helpers describing a process Dev Command Center knows about.
+ *
+ * `ownership` is the safety boundary: `"managed"` processes were launched by us
+ * and may be signalled; `"detected"` processes were merely observed on the host
+ * and must never be killed by devcc.
+ */
+export type ProcessStatus = "stopped" | "starting" | "running" | "stopping" | "failed";
+export type ProcessOwnership = "managed" | "detected";
+/** `service` processes are long-running; `task` processes are expected to exit. */
+export type ProcessKind = "service" | "task";
+export interface ProcessDefinition {
+    id: string;
+    name: string;
+    command: string;
+    args?: string[];
+    cwd?: string;
+    env?: Record<string, string>;
+    kind?: ProcessKind;
+    /** Start automatically when devcc launches. */
+    autoStart?: boolean;
+    /** Informational URL shown next to the process (e.g. `localhost:3000`). */
+    url?: string;
+    /** Port to probe for a readiness indicator. */
+    port?: number;
+    /** Milliseconds to wait after SIGTERM before escalating to SIGKILL. */
+    killGraceMs?: number;
+    /**
+     * Bring the process back up automatically when it exits non-zero.
+     * Opt-in per process: devcc never resurrects something you stopped yourself.
+     */
+    restartOnCrash?: boolean;
+    /** Give up after this many consecutive crashes (default 5). */
+    maxCrashRestarts?: number;
+    /** First backoff delay; doubles per consecutive crash (default 1000ms). */
+    crashBackoffMs?: number;
+    /** Upper bound on the backoff delay (default 30000ms). */
+    maxCrashBackoffMs?: number;
+    /**
+     * A run lasting at least this long is considered healthy, which resets the
+     * crash counter (default 30000ms).
+     */
+    healthyAfterMs?: number;
+    /**
+     * Ids of processes that must be *ready* before this one starts. Used by
+     * "start all" and autostart to bring a stack up in order.
+     */
+    dependsOn?: string[];
+    /**
+     * How devcc decides the process is usable. Until it passes, the process is
+     * reported as `starting` rather than `running`. Without one, a process is
+     * considered ready the moment it has spawned.
+     */
+    readiness?: ReadinessCheck;
+}
+export interface ReadinessCheck {
+    /** Ready once something accepts a TCP connection on this port. */
+    port?: number;
+    host?: string;
+    /** Ready once a line of output matches this regular expression. */
+    logPattern?: string;
+    /** Give up waiting after this long and report `running` anyway (default 30000). */
+    timeoutMs?: number;
+    /** How often to probe the port (default 250). */
+    intervalMs?: number;
+}
+export declare const DEFAULT_READINESS: {
+    readonly timeoutMs: 30000;
+    readonly intervalMs: 250;
+};
+export declare const DEFAULT_CRASH_POLICY: {
+    readonly maxCrashRestarts: 5;
+    readonly crashBackoffMs: 1000;
+    readonly maxCrashBackoffMs: 30000;
+    readonly healthyAfterMs: 30000;
+};
+export interface ManagedProcess {
+    id: string;
+    name: string;
+    command: string;
+    args?: string[];
+    cwd?: string;
+    status: ProcessStatus;
+    pid?: number;
+    startedAt?: Date;
+    exitCode?: number;
+    /** Signal that terminated the process, when it was signalled. */
+    exitSignal?: string;
+    stoppedAt?: Date;
+    kind: ProcessKind;
+    ownership: ProcessOwnership;
+    url?: string;
+    port?: number;
+    /** How many times the user has restarted it this session. */
+    restarts: number;
+    /** Consecutive automatic restarts since the last healthy run. */
+    crashRestarts: number;
+    /** When an automatic restart is scheduled, the time it will happen. */
+    retryAt?: Date;
+    /** True once devcc has given up automatically restarting this process. */
+    crashRestartsExhausted?: boolean;
+    /** Last failure message, cleared on a successful start. */
+    lastError?: string;
+    /** Ids this process waits for before starting. */
+    dependsOn: string[];
+    /** True once the readiness check has passed (or there is none). */
+    ready: boolean;
+    /** Set when the readiness check timed out and the process was reported anyway. */
+    readinessTimedOut?: boolean;
+}
+export declare const ACTIVE_STATUSES: readonly ProcessStatus[];
+export declare function isActive(status: ProcessStatus): boolean;
+/** Whether a status change is legal. Keeps the manager's bookkeeping honest. */
+export declare function canTransition(from: ProcessStatus, to: ProcessStatus): boolean;
+/** Build the initial snapshot for a definition. */
+export declare function createManagedProcess(definition: ProcessDefinition, ownership?: ProcessOwnership): ManagedProcess;
+/**
+ * Exponential backoff for automatic restarts.
+ *
+ * `attempt` is 1-based: the first restart waits `base`, the second `2 * base`,
+ * and so on, capped at `max`. Keeping this a pure function makes the policy
+ * testable without spawning anything.
+ */
+export declare function crashBackoffDelay(attempt: number, base?: number, max?: number): number;
+/** Whether a crashed process should be brought back up automatically. */
+export declare function shouldAutoRestart(definition: Pick<ProcessDefinition, "restartOnCrash" | "maxCrashRestarts">, snapshot: Pick<ManagedProcess, "crashRestarts">): boolean;
+/** Human-readable one-liner of what will actually be executed. */
+export declare function describeCommand(process: Pick<ManagedProcess, "command" | "args">): string;
+//# sourceMappingURL=ManagedProcess.d.ts.map

package/dist/devcc/processes/ManagedProcess.d.ts.map

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