@doriandev/devcc 0.1.2

package/dist/devcc/services/types.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Service adapters describe things the project depends on but that devcc does
+ * not necessarily own: Docker, a database, a local model server, a dev server
+ * someone started in another terminal.
+ *
+ * Adapters are detected at runtime. Nothing here assumes a given project has
+ * any particular service.
+ */
+export type ServiceState = "running" | "stopped" | "degraded" | "unknown" | "unavailable";
+export interface ServiceStatusItem {
+    name: string;
+    state: ServiceState;
+    detail?: string;
+}
+export interface ServiceStatus {
+    state: ServiceState;
+    /** One-line summary shown next to the service name. */
+    detail?: string;
+    /** Where to reach it, e.g. `localhost:5432`. */
+    endpoint?: string;
+    /** Sub-entries, e.g. individual compose containers. */
+    items?: ServiceStatusItem[];
+    checkedAt: Date;
+}
+export interface ServiceActionContext {
+    /** Ask the user before doing something destructive. Resolves to the answer. */
+    confirm: (title: string, message: string) => Promise<boolean>;
+}
+export interface ServiceAdapter {
+    id: string;
+    name: string;
+    /** Grouping label shown in the Services view. */
+    category: "container" | "database" | "runtime" | "ai" | "web";
+    /** Cheap check: is this service relevant to this project/host at all? */
+    detect: () => Promise<boolean>;
+    getStatus: () => Promise<ServiceStatus>;
+    start?: (context: ServiceActionContext) => Promise<void>;
+    stop?: (context: ServiceActionContext) => Promise<void>;
+    restart?: (context: ServiceActionContext) => Promise<void>;
+}
+export interface ServiceSnapshot {
+    id: string;
+    name: string;
+    category: ServiceAdapter["category"];
+    status: ServiceStatus;
+    canStart: boolean;
+    canStop: boolean;
+    canRestart: boolean;
+}
+export declare const UNKNOWN_STATUS: ServiceStatus;
+//# sourceMappingURL=types.d.ts.map

package/dist/devcc/services/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/devcc/services/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,aAAa,CAAA;AAEzF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,YAAY,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,YAAY,CAAA;IACnB,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uDAAuD;IACvD,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAA;IAC3B,SAAS,EAAE,IAAI,CAAA;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,+EAA+E;IAC/E,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC9D;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,iDAAiD;IACjD,QAAQ,EAAE,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,IAAI,GAAG,KAAK,CAAA;IAE7D,yEAAyE;IACzE,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;IAC9B,SAAS,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,CAAA;IAEvC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACxD,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACvD,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3D;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,CAAA;IACpC,MAAM,EAAE,aAAa,CAAA;IACrB,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,OAAO,CAAA;CACpB;AAED,eAAO,MAAM,cAAc,EAAE,aAA4D,CAAA"}

package/dist/devcc/services/types.js

@@ -0,0 +1,10 @@
+/**
+ * Service adapters describe things the project depends on but that devcc does
+ * not necessarily own: Docker, a database, a local model server, a dev server
+ * someone started in another terminal.
+ *
+ * Adapters are detected at runtime. Nothing here assumes a given project has
+ * any particular service.
+ */
+export const UNKNOWN_STATUS = { state: "unknown", checkedAt: new Date(0) };
+//# sourceMappingURL=types.js.map

package/dist/devcc/services/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/devcc/services/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAmDH,MAAM,CAAC,MAAM,cAAc,GAAkB,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAA"}

package/dist/devcc/system/SystemMonitor.d.ts

@@ -0,0 +1,87 @@
+import { cpus } from "node:os";
+import { TypedEmitter } from "../core/events.js";
+export interface CpuSample {
+    idle: number;
+    total: number;
+}
+export interface DiskUsage {
+    total: number;
+    free: number;
+    used: number;
+    ratio: number;
+}
+export interface SystemMetrics {
+    /** 0..1, averaged across cores since the previous sample. */
+    cpu: number;
+    memoryTotal: number;
+    memoryFree: number;
+    memoryUsed: number;
+    memoryRatio: number;
+    loadAverage: [number, number, number];
+    /** Host uptime in milliseconds. */
+    uptimeMs: number;
+    /** devcc's own uptime in milliseconds. */
+    processUptimeMs: number;
+    disk: DiskUsage | null;
+    sampledAt: Date;
+}
+export interface HostInfo {
+    hostname: string;
+    platform: string;
+    release: string;
+    arch: string;
+    cpuModel: string;
+    cpuCount: number;
+    totalMemory: number;
+    home: string;
+    runtime: string;
+    nodeVersion: string;
+}
+/** Versions of external tools; populated lazily so startup is never blocked. */
+export interface ToolVersions {
+    git: string | null;
+    docker: string | null;
+    packageManager: string | null;
+}
+export type SystemMonitorEvents = {
+    "system:metrics": [SystemMetrics];
+    "system:tools": [ToolVersions];
+};
+/** Aggregate `os.cpus()` times into idle/total counters. */
+export declare function sampleCpu(cpuInfos?: ReturnType<typeof cpus>): CpuSample;
+/**
+ * CPU utilisation between two samples, as a 0..1 ratio.
+ * Returns 0 when the samples are identical (no elapsed time).
+ */
+export declare function cpuUsageBetween(previous: CpuSample, current: CpuSample): number;
+export declare function detectRuntime(): string;
+export interface SystemMonitorOptions {
+    rootDir: string;
+    intervalMs?: number;
+}
+/**
+ * Samples host metrics on a timer using Node APIs only.
+ *
+ * The one exception is tool versions (`git`, `docker`), which have no API; those
+ * are read once, lazily, off the startup path.
+ */
+export declare class SystemMonitor extends TypedEmitter<SystemMonitorEvents> {
+    private readonly options;
+    private timer;
+    private previousSample;
+    private metrics;
+    private tools;
+    private readonly intervalMs;
+    private readonly startedAt;
+    constructor(options: SystemMonitorOptions);
+    getMetrics(): SystemMetrics | null;
+    getTools(): ToolVersions;
+    getHostInfo(): HostInfo;
+    start(): void;
+    stop(): void;
+    sample(): Promise<SystemMetrics>;
+    /** Read tool versions once. Safe to call repeatedly; results are cached. */
+    refreshTools(packageManager: string): Promise<ToolVersions>;
+    private readDisk;
+}
+//# sourceMappingURL=SystemMonitor.d.ts.map

package/dist/devcc/system/SystemMonitor.d.ts.map

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

package/dist/devcc/system/SystemMonitor.js

@@ -0,0 +1,142 @@
+import { statfs } from "node:fs/promises";
+import { arch, cpus, freemem, homedir, hostname, loadavg, platform, release, totalmem, uptime } from "node:os";
+import { TypedEmitter } from "../core/events.js";
+import { exec } from "../utils/exec.js";
+/** Aggregate `os.cpus()` times into idle/total counters. */
+export function sampleCpu(cpuInfos = cpus()) {
+    let idle = 0;
+    let total = 0;
+    for (const cpu of cpuInfos) {
+        idle += cpu.times.idle;
+        total += cpu.times.user + cpu.times.nice + cpu.times.sys + cpu.times.idle + cpu.times.irq;
+    }
+    return { idle, total };
+}
+/**
+ * CPU utilisation between two samples, as a 0..1 ratio.
+ * Returns 0 when the samples are identical (no elapsed time).
+ */
+export function cpuUsageBetween(previous, current) {
+    const idleDelta = current.idle - previous.idle;
+    const totalDelta = current.total - previous.total;
+    if (totalDelta <= 0)
+        return 0;
+    const usage = 1 - idleDelta / totalDelta;
+    return Math.max(0, Math.min(1, usage));
+}
+export function detectRuntime() {
+    const bunVersion = globalThis.Bun?.version;
+    if (bunVersion)
+        return `bun ${bunVersion}`;
+    return `node ${process.versions.node}`;
+}
+/**
+ * Samples host metrics on a timer using Node APIs only.
+ *
+ * The one exception is tool versions (`git`, `docker`), which have no API; those
+ * are read once, lazily, off the startup path.
+ */
+export class SystemMonitor extends TypedEmitter {
+    options;
+    timer = null;
+    previousSample = sampleCpu();
+    metrics = null;
+    tools = { git: null, docker: null, packageManager: null };
+    intervalMs;
+    startedAt = Date.now();
+    constructor(options) {
+        super();
+        this.options = options;
+        this.intervalMs = options.intervalMs ?? 1_500;
+    }
+    getMetrics() {
+        return this.metrics;
+    }
+    getTools() {
+        return this.tools;
+    }
+    getHostInfo() {
+        const cpuList = cpus();
+        return {
+            hostname: hostname(),
+            platform: platform(),
+            release: release(),
+            arch: arch(),
+            cpuModel: cpuList[0]?.model.trim() ?? "unknown",
+            cpuCount: cpuList.length,
+            totalMemory: totalmem(),
+            home: homedir(),
+            runtime: detectRuntime(),
+            nodeVersion: process.versions.node,
+        };
+    }
+    start() {
+        if (this.timer)
+            return;
+        void this.sample();
+        this.timer = setInterval(() => void this.sample(), this.intervalMs);
+        this.timer.unref?.();
+    }
+    stop() {
+        if (!this.timer)
+            return;
+        clearInterval(this.timer);
+        this.timer = null;
+    }
+    async sample() {
+        const current = sampleCpu();
+        const cpu = cpuUsageBetween(this.previousSample, current);
+        this.previousSample = current;
+        const total = totalmem();
+        const free = freemem();
+        const [one = 0, five = 0, fifteen = 0] = loadavg();
+        const metrics = {
+            cpu,
+            memoryTotal: total,
+            memoryFree: free,
+            memoryUsed: total - free,
+            memoryRatio: total > 0 ? (total - free) / total : 0,
+            loadAverage: [one, five, fifteen],
+            uptimeMs: uptime() * 1000,
+            processUptimeMs: Date.now() - this.startedAt,
+            disk: await this.readDisk(),
+            sampledAt: new Date(),
+        };
+        this.metrics = metrics;
+        this.emit("system:metrics", metrics);
+        return metrics;
+    }
+    /** Read tool versions once. Safe to call repeatedly; results are cached. */
+    async refreshTools(packageManager) {
+        const [git, docker, pm] = await Promise.all([
+            versionOf("git", ["--version"], /git version (\S+)/u),
+            versionOf("docker", ["--version"], /Docker version ([^,\s]+)/u),
+            versionOf(packageManager, ["--version"], /(\S+)/u),
+        ]);
+        this.tools = { git, docker, packageManager: pm };
+        this.emit("system:tools", this.tools);
+        return this.tools;
+    }
+    async readDisk() {
+        try {
+            const stats = await statfs(this.options.rootDir);
+            const total = Number(stats.blocks) * Number(stats.bsize);
+            const free = Number(stats.bavail) * Number(stats.bsize);
+            if (!Number.isFinite(total) || total <= 0)
+                return null;
+            const used = total - free;
+            return { total, free, used, ratio: used / total };
+        }
+        catch {
+            return null;
+        }
+    }
+}
+async function versionOf(command, args, pattern) {
+    const result = await exec(command, args, { timeoutMs: 3_000 });
+    if (!result.ok)
+        return null;
+    const text = result.stdout.trim().split("\n")[0] ?? "";
+    return pattern.exec(text)?.[1] ?? (text === "" ? null : text);
+}
+//# sourceMappingURL=SystemMonitor.js.map

package/dist/devcc/system/SystemMonitor.js.map

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

package/dist/devcc/utils/errors.d.ts

@@ -0,0 +1,31 @@
+/**
+ * A single, consistent error model for everything Dev Command Center does.
+ *
+ * Every failure that reaches the UI is normalised into a `DevccError` so the
+ * notification centre, the log file and the diagnostics panel can all render it
+ * the same way.
+ */
+export type DevccErrorScope = "config" | "process" | "script" | "git" | "docker" | "service" | "system" | "command" | "internal";
+export interface DevccErrorOptions {
+    scope: DevccErrorScope;
+    /** Short, user facing summary. Shown in the notification area. */
+    message: string;
+    /** Longer text (command output, stack, ...) shown when the error is inspected. */
+    detail?: string;
+    cause?: unknown;
+    /** Whether the application can keep running normally. Defaults to `true`. */
+    recoverable?: boolean;
+}
+export declare class DevccError extends Error {
+    readonly scope: DevccErrorScope;
+    readonly detail?: string;
+    readonly recoverable: boolean;
+    constructor(options: DevccErrorOptions);
+}
+/** Best-effort message extraction from an unknown thrown value. */
+export declare function errorMessage(error: unknown): string;
+/** Stack (or message) of an unknown thrown value, for the log file. */
+export declare function errorDetail(error: unknown): string | undefined;
+/** Normalise anything thrown into a `DevccError` without losing information. */
+export declare function toDevccError(error: unknown, scope: DevccErrorScope, fallbackMessage?: string): DevccError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/devcc/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/devcc/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,eAAe,GACzB,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAA;AAEpG,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,eAAe,CAAA;IACtB,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAA;IACf,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,6EAA6E;IAC7E,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;gBAEjB,OAAO,EAAE,iBAAiB;CAOvC;AAED,mEAAmE;AACnE,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQnD;AAED,uEAAuE;AACvE,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAI9D;AAED,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,UAAU,CAQzG"}

package/dist/devcc/utils/errors.js

@@ -0,0 +1,52 @@
+/**
+ * A single, consistent error model for everything Dev Command Center does.
+ *
+ * Every failure that reaches the UI is normalised into a `DevccError` so the
+ * notification centre, the log file and the diagnostics panel can all render it
+ * the same way.
+ */
+export class DevccError extends Error {
+    scope;
+    detail;
+    recoverable;
+    constructor(options) {
+        super(options.message, options.cause === undefined ? undefined : { cause: options.cause });
+        this.name = "DevccError";
+        this.scope = options.scope;
+        this.detail = options.detail;
+        this.recoverable = options.recoverable ?? true;
+    }
+}
+/** Best-effort message extraction from an unknown thrown value. */
+export function errorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    if (typeof error === "string")
+        return error;
+    try {
+        return JSON.stringify(error);
+    }
+    catch {
+        return String(error);
+    }
+}
+/** Stack (or message) of an unknown thrown value, for the log file. */
+export function errorDetail(error) {
+    if (error instanceof DevccError)
+        return error.detail ?? error.stack;
+    if (error instanceof Error)
+        return error.stack;
+    return undefined;
+}
+/** Normalise anything thrown into a `DevccError` without losing information. */
+export function toDevccError(error, scope, fallbackMessage) {
+    if (error instanceof DevccError)
+        return error;
+    return new DevccError({
+        scope,
+        message: fallbackMessage ? `${fallbackMessage}: ${errorMessage(error)}` : errorMessage(error),
+        detail: errorDetail(error),
+        cause: error,
+    });
+}
+//# sourceMappingURL=errors.js.map

package/dist/devcc/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/devcc/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgBH,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,KAAK,CAAiB;IACtB,MAAM,CAAS;IACf,WAAW,CAAS;IAE7B,YAAY,OAA0B;QACpC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAA;QAC1F,IAAI,CAAC,IAAI,GAAG,YAAY,CAAA;QACxB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAA;QAC1B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;QAC5B,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,IAAI,CAAA;IAChD,CAAC;CACF;AAED,mEAAmE;AACnE,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,KAAK,CAAC,OAAO,CAAA;IAChD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IAC3C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;IACtB,CAAC;AACH,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,YAAY,UAAU;QAAE,OAAO,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,CAAA;IACnE,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,KAAK,CAAC,KAAK,CAAA;IAC9C,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,YAAY,CAAC,KAAc,EAAE,KAAsB,EAAE,eAAwB;IAC3F,IAAI,KAAK,YAAY,UAAU;QAAE,OAAO,KAAK,CAAA;IAC7C,OAAO,IAAI,UAAU,CAAC;QACpB,KAAK;QACL,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,eAAe,KAAK,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC;QAC7F,MAAM,EAAE,WAAW,CAAC,KAAK,CAAC;QAC1B,KAAK,EAAE,KAAK;KACb,CAAC,CAAA;AACJ,CAAC"}

package/dist/devcc/utils/exec.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Small, safe process helpers.
+ *
+ * Everything goes through `spawn(executable, args[])` - never a shell string -
+ * so no caller can accidentally build an injectable command line.
+ */
+export interface ExecOptions {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    /** Hard timeout in milliseconds. Defaults to 5s: nothing in the UI may hang. */
+    timeoutMs?: number;
+    /** Bytes of stdout/stderr to retain. Defaults to 1 MiB. */
+    maxBuffer?: number;
+    input?: string;
+    signal?: AbortSignal;
+}
+export interface ExecResult {
+    ok: boolean;
+    code: number | null;
+    signal: NodeJS.Signals | null;
+    stdout: string;
+    stderr: string;
+    timedOut: boolean;
+    durationMs: number;
+    /** Set when the executable could not be spawned at all (e.g. ENOENT). */
+    spawnError?: Error;
+}
+export declare const DEFAULT_EXEC_TIMEOUT_MS = 5000;
+/**
+ * Run a command and collect its output. Never rejects - inspect `ok`/`spawnError`.
+ */
+export declare function exec(command: string, args?: readonly string[], options?: ExecOptions): Promise<ExecResult>;
+/** Convenience wrapper that returns trimmed stdout, or `null` when the command failed. */
+export declare function execOutput(command: string, args?: readonly string[], options?: ExecOptions): Promise<string | null>;
+/** True when `command --version` (or the given probe args) succeeds. */
+export declare function commandExists(command: string, probeArgs?: readonly string[]): Promise<boolean>;
+/** Open a TCP connection to check whether something is listening. */
+export declare function probeTcpPort(port: number, host?: string, timeoutMs?: number): Promise<boolean>;
+/** Resolve a promise to a fallback value when it takes too long. */
+export declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number, fallback: T): Promise<T>;
+//# sourceMappingURL=exec.d.ts.map

package/dist/devcc/utils/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../../src/devcc/utils/exec.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,OAAO,CAAA;IACX,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAA;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,OAAO,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,yEAAyE;IACzE,UAAU,CAAC,EAAE,KAAK,CAAA;CACnB;AAED,eAAO,MAAM,uBAAuB,OAAQ,CAAA;AAE5C;;GAEG;AACH,wBAAgB,IAAI,CAClB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,SAAS,MAAM,EAAO,EAC5B,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CAkErB;AAED,0FAA0F;AAC1F,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,SAAS,MAAM,EAAO,EAC5B,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGxB;AAED,wEAAwE;AACxE,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,SAAS,MAAM,EAAkB,GAC3C,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAc,EAAE,SAAS,SAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAiBhG;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAc9F"}

package/dist/devcc/utils/exec.js

@@ -0,0 +1,112 @@
+import { spawn } from "node:child_process";
+import { connect } from "node:net";
+export const DEFAULT_EXEC_TIMEOUT_MS = 5_000;
+/**
+ * Run a command and collect its output. Never rejects - inspect `ok`/`spawnError`.
+ */
+export function exec(command, args = [], options = {}) {
+    const { cwd, env, timeoutMs = DEFAULT_EXEC_TIMEOUT_MS, maxBuffer = 1024 * 1024, input, signal } = options;
+    return new Promise((resolve) => {
+        const startedAt = Date.now();
+        const spawnOptions = {
+            cwd,
+            env: env ?? process.env,
+            stdio: ["pipe", "pipe", "pipe"],
+            windowsHide: true,
+        };
+        let settled = false;
+        let timedOut = false;
+        let stdout = "";
+        let stderr = "";
+        const child = spawn(command, [...args], spawnOptions);
+        const finish = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            signal?.removeEventListener("abort", onAbort);
+            resolve({ ...result, durationMs: Date.now() - startedAt });
+        };
+        const timer = setTimeout(() => {
+            timedOut = true;
+            child.kill("SIGKILL");
+        }, timeoutMs);
+        timer.unref?.();
+        const onAbort = () => child.kill("SIGKILL");
+        signal?.addEventListener("abort", onAbort, { once: true });
+        child.stdout?.setEncoding("utf8");
+        child.stdout?.on("data", (chunk) => {
+            if (stdout.length < maxBuffer)
+                stdout += chunk;
+        });
+        child.stderr?.setEncoding("utf8");
+        child.stderr?.on("data", (chunk) => {
+            if (stderr.length < maxBuffer)
+                stderr += chunk;
+        });
+        child.on("error", (error) => {
+            finish({ ok: false, code: null, signal: null, stdout, stderr, timedOut, spawnError: error });
+        });
+        child.on("close", (code, closeSignal) => {
+            finish({
+                ok: !timedOut && code === 0,
+                code,
+                signal: closeSignal,
+                stdout,
+                stderr,
+                timedOut,
+            });
+        });
+        if (input !== undefined) {
+            child.stdin?.end(input);
+        }
+        else {
+            child.stdin?.end();
+        }
+    });
+}
+/** Convenience wrapper that returns trimmed stdout, or `null` when the command failed. */
+export async function execOutput(command, args = [], options = {}) {
+    const result = await exec(command, args, options);
+    return result.ok ? result.stdout.trim() : null;
+}
+/** True when `command --version` (or the given probe args) succeeds. */
+export async function commandExists(command, probeArgs = ["--version"]) {
+    const result = await exec(command, probeArgs, { timeoutMs: 3_000 });
+    return result.ok;
+}
+/** Open a TCP connection to check whether something is listening. */
+export function probeTcpPort(port, host = "127.0.0.1", timeoutMs = 700) {
+    return new Promise((resolve) => {
+        const socket = connect({ port, host });
+        let settled = false;
+        const done = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            socket.destroy();
+            resolve(value);
+        };
+        socket.setTimeout(timeoutMs);
+        socket.once("connect", () => done(true));
+        socket.once("timeout", () => done(false));
+        socket.once("error", () => done(false));
+    });
+}
+/** Resolve a promise to a fallback value when it takes too long. */
+export function withTimeout(promise, timeoutMs, fallback) {
+    return new Promise((resolve) => {
+        const timer = setTimeout(() => resolve(fallback), timeoutMs);
+        timer.unref?.();
+        promise
+            .then((value) => {
+            clearTimeout(timer);
+            resolve(value);
+        })
+            .catch(() => {
+            clearTimeout(timer);
+            resolve(fallback);
+        });
+    });
+}
+//# sourceMappingURL=exec.js.map

package/dist/devcc/utils/exec.js.map

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

package/dist/devcc/utils/format.d.ts

@@ -0,0 +1,18 @@
+/** Formatting helpers shared by the views. Pure functions, easy to test. */
+export declare function formatBytes(bytes: number, fractionDigits?: number): string;
+/** Bytes rendered in GB without a unit suffix, for `7.2 / 36 GB` style pairs. */
+export declare function toGigabytes(bytes: number, fractionDigits?: number): string;
+export declare function formatPercent(ratio: number, fractionDigits?: number): string;
+/** Compact duration: `4s`, `2m 10s`, `1h 04m`, `3d 02h`. */
+export declare function formatDuration(ms: number): string;
+export declare function formatClock(date: Date): string;
+export declare function formatTimestamp(date: Date): string;
+/** Pad or truncate to an exact display width. */
+export declare function fit(text: string, width: number): string;
+export declare function truncate(text: string, maxLength: number): string;
+/** Single-line preview of a possibly multi-line string. */
+export declare function singleLine(text: string, maxLength?: number): string;
+/** A small horizontal meter, e.g. `████░░░░░░`. */
+export declare function meter(ratio: number, width?: number, filledChar?: string, emptyChar?: string): string;
+export declare function pluralise(count: number, singular: string, plural?: string): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/devcc/utils/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/devcc/utils/format.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,SAAI,GAAG,MAAM,CAWrE;AAED,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,SAAI,GAAG,MAAM,CAErE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,SAAI,GAAG,MAAM,CAGvE;AAED,4DAA4D;AAC5D,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAUjD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE9C;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAOlD;AAED,iDAAiD;AACjD,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAKhE;AAED,2DAA2D;AAC3D,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,MAAM,CAEhE;AAED,mDAAmD;AACnD,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,UAAU,SAAM,EAAE,SAAS,SAAM,GAAG,MAAM,CAK1F;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAiB,GAAG,MAAM,CAE1F"}