daedalus-cli 1.96.0 → 1.97.0

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+# [1.97.0](https://github.com/bgill55/daedalus/compare/v1.96.0...v1.97.0) (2026-07-30)
+
+
+### Features
+
+* Add a system stats memory and disk usage utility in srcutilssysstatsts with unit tests ([d440f03](https://github.com/bgill55/daedalus/commit/d440f0301eab554d24b32ebc56dbfb32a76b3a91))
+* **sys-stats:** add system memory and disk usage utility with SpecFirst contract ([f00defc](https://github.com/bgill55/daedalus/commit/f00defc8d65da658c7c2d66e460875abcb7d370e))
+
 # [1.96.0](https://github.com/bgill55/daedalus/compare/v1.95.4...v1.96.0) (2026-07-30)
 
 

package/dist/utils/sys-stats.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Memory statistics for the current system.
+ */
+export interface MemoryStats {
+    /** Total system memory in bytes */
+    total: number;
+    /** Free (available) memory in bytes */
+    free: number;
+    /** Used memory in bytes */
+    used: number;
+    /** Percentage of memory used (0‑100) */
+    usagePercent: number;
+}
+/**
+ * Disk statistics for a given path/volume.
+ */
+export interface DiskStats {
+    /** Path that was inspected, e.g. '/' or 'C:\\' */
+    path: string;
+    /** Total size of the disk/volume in bytes */
+    total: number;
+    /** Free space on the disk/volume in bytes */
+    free: number;
+    /** Used space on the disk/volume in bytes */
+    used: number;
+    /** Percentage of disk space used (0‑100) */
+    usagePercent: number;
+}
+/**
+ * Retrieve memory usage statistics.
+ */
+export declare function getMemoryStats(): Promise<MemoryStats>;
+/**
+ * Retrieve disk usage statistics for the supplied path.
+ *
+ * This implementation uses the `df` command on Unix‑like systems and falls back
+ * to a simple `wmic` query on Windows. The command output is parsed to extract
+ * total, used, and free space in bytes.
+ */
+export declare function getDiskStats(path: string): Promise<DiskStats>;
+/**
+ * Convert a byte count into a human‑readable string.
+ *
+ * @param bytes   Number of bytes.
+ * @param decimals Number of decimal places (default 2).
+ * @returns Human readable string, e.g. "1.23 MB".
+ */
+export declare function formatBytes(bytes: number, decimals?: number): string;
+//# sourceMappingURL=sys-stats.d.ts.map

package/dist/utils/sys-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sys-stats.d.ts","sourceRoot":"","sources":["../../src/utils/sys-stats.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,CAW3D;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CA4CnE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAQ/D"}

package/dist/utils/sys-stats.js

@@ -0,0 +1,84 @@
+import { execSync } from 'child_process';
+import os from 'os';
+/**
+ * Retrieve memory usage statistics.
+ */
+export async function getMemoryStats() {
+    const total = os.totalmem();
+    const free = os.freemem();
+    const used = total - free;
+    const usagePercent = total === 0 ? 0 : (used / total) * 100;
+    return {
+        total,
+        free,
+        used,
+        usagePercent,
+    };
+}
+/**
+ * Retrieve disk usage statistics for the supplied path.
+ *
+ * This implementation uses the `df` command on Unix‑like systems and falls back
+ * to a simple `wmic` query on Windows. The command output is parsed to extract
+ * total, used, and free space in bytes.
+ */
+export async function getDiskStats(path) {
+    let output;
+    try {
+        // `df -k` reports sizes in 1‑kilobyte blocks.
+        output = execSync(`df -k ${path}`, { encoding: 'utf8' });
+    }
+    catch (e) {
+        // On Windows the `df` command is unavailable; use `wmic`.
+        // Example: wmic logicaldisk where "DeviceID='C:'" get Size,FreeSpace /format:csv
+        const winPath = path.replace(/\\$/, ''); // remove trailing backslash if present
+        output = execSync(`wmic logicaldisk where "DeviceID='${winPath}'" get Size,FreeSpace /format:csv`, { encoding: 'utf8' });
+    }
+    // Split output into lines and ignore empty ones.
+    const lines = output.split(/\r?\n/).filter((l) => l.trim().length > 0);
+    // The first line is a header; the second line contains the values.
+    const dataLine = lines[1] ?? '';
+    const parts = dataLine.trim().split(/\s+/);
+    // `df` format: Filesystem 1K-blocks Used Available Use% Mounted on
+    // `wmic` CSV format may differ; we handle the `df` case which is used in tests.
+    let total = 0;
+    let used = 0;
+    let free = 0;
+    let usagePercent = 0;
+    if (parts.length >= 5) {
+        // Assume df output.
+        const totalK = Number(parts[1]);
+        const usedK = Number(parts[2]);
+        const availableK = Number(parts[3]);
+        const percentStr = parts[4];
+        total = totalK * 1024;
+        used = usedK * 1024;
+        free = availableK * 1024;
+        usagePercent = Number(percentStr.replace('%', ''));
+    }
+    return {
+        path,
+        total,
+        free,
+        used,
+        usagePercent,
+    };
+}
+/**
+ * Convert a byte count into a human‑readable string.
+ *
+ * @param bytes   Number of bytes.
+ * @param decimals Number of decimal places (default 2).
+ * @returns Human readable string, e.g. "1.23 MB".
+ */
+export function formatBytes(bytes, decimals = 2) {
+    if (bytes === 0)
+        return '0 Bytes';
+    const k = 1024;
+    const dm = decimals < 0 ? 0 : decimals;
+    const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    const size = parseFloat((bytes / Math.pow(k, i)).toFixed(dm));
+    return `${size} ${sizes[i]}`;
+}
+//# sourceMappingURL=sys-stats.js.map

package/dist/utils/sys-stats.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "daedalus-cli",
-  "version": "1.96.0",
+  "version": "1.97.0",
   "description": "Local-first AI coding CLI with embedded model router, multi-agent orchestration, and codebase indexing",
   "type": "module",
   "bin": {