@memnexus-ai/mx-agent-cli 0.1.208 → 0.1.209

package/dist/lib/startup-shipper.d.ts

@@ -0,0 +1,55 @@
+/**
+ * startup-shipper.ts — ships StartupReports to the central observability
+ * service (platform v2.58 Phase 2, #4350).
+ *
+ * Durability model mirrors the local JSONL from Phase 1: every report is first
+ * written to a spool dir (~/.mx-agent/logs/startup/spool/<uuid>.json), then a
+ * best-effort POST deletes it on success. A failed or token-less POST leaves the
+ * file spooled; the Stop-hook `mx-agent sync` flushes the backlog on the next
+ * session end.
+ *
+ * Discipline (identical to startup-report.ts): NOTHING here throws. Shipping is
+ * additive telemetry — it must never block, slow, or fail a session start. Every
+ * filesystem and network call is wrapped; the worst outcome of any failure is a
+ * report that stays spooled for a later retry.
+ *
+ *  - spoolReport(json)     — write one report to the spool. Drops files older
+ *                            than 14 days at write time (bounded disk/staleness).
+ *  - flushSpool(cfg)       — POST every spooled report, deleting each on 2xx.
+ *                            Enforces a 50-file cap (drops oldest beyond it) and
+ *                            skips entirely when no token is configured.
+ *  - postSpoolFile(p, cfg) — POST one spool file with a 3 s timeout.
+ */
+/** Absolute path to the spool directory. Computed at call time so tests that
+ *  repoint $HOME observe the change (matches startup-report.ts). */
+export declare function spoolDir(): string;
+export interface ShipConfig {
+    apiUrl: string;
+    apiToken?: string;
+    /** Optional dim-note logger (sync passes one; startup passes nothing). */
+    log?: (msg: string) => void;
+}
+/**
+ * Write a report JSON string to the spool. Never throws. Returns the file path,
+ * or null if the write could not be performed (e.g. a read-only spool dir).
+ * Drops files older than 14 days first.
+ */
+export declare function spoolReport(reportJson: string): string | null;
+/**
+ * POST one spool file to the observability service. Returns true and deletes the
+ * file on a 2xx response. Any non-2xx, network error, or timeout returns false
+ * and leaves the file spooled. Never throws.
+ */
+export declare function postSpoolFile(path: string, cfg: ShipConfig): Promise<boolean>;
+/**
+ * Flush the spool: POST every spooled report, deleting each on success.
+ *
+ * Enforces the 50-file cap first (drops the oldest beyond it, with a dim note if
+ * a logger is provided). If no token is configured the whole flush is skipped —
+ * files stay spooled so a later run with a token can retry. Never throws.
+ */
+export declare function flushSpool(cfg: ShipConfig): Promise<{
+    shipped: number;
+    remaining: number;
+}>;
+//# sourceMappingURL=startup-shipper.d.ts.map

package/dist/lib/startup-shipper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-shipper.d.ts","sourceRoot":"","sources":["../../src/lib/startup-shipper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAcH;oEACoE;AACpE,wBAAgB,QAAQ,IAAI,MAAM,CAEjC;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAY7D;AAwCD;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CA8BnF;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAgCjG"}

package/dist/lib/startup-shipper.js

@@ -0,0 +1,177 @@
+/**
+ * startup-shipper.ts — ships StartupReports to the central observability
+ * service (platform v2.58 Phase 2, #4350).
+ *
+ * Durability model mirrors the local JSONL from Phase 1: every report is first
+ * written to a spool dir (~/.mx-agent/logs/startup/spool/<uuid>.json), then a
+ * best-effort POST deletes it on success. A failed or token-less POST leaves the
+ * file spooled; the Stop-hook `mx-agent sync` flushes the backlog on the next
+ * session end.
+ *
+ * Discipline (identical to startup-report.ts): NOTHING here throws. Shipping is
+ * additive telemetry — it must never block, slow, or fail a session start. Every
+ * filesystem and network call is wrapped; the worst outcome of any failure is a
+ * report that stays spooled for a later retry.
+ *
+ *  - spoolReport(json)     — write one report to the spool. Drops files older
+ *                            than 14 days at write time (bounded disk/staleness).
+ *  - flushSpool(cfg)       — POST every spooled report, deleting each on 2xx.
+ *                            Enforces a 50-file cap (drops oldest beyond it) and
+ *                            skips entirely when no token is configured.
+ *  - postSpoolFile(p, cfg) — POST one spool file with a 3 s timeout.
+ */
+import { mkdirSync, writeFileSync, readdirSync, statSync, unlinkSync, readFileSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+import { randomUUID } from 'crypto';
+/** Drop spooled files older than this at write time (bounded disk / staleness). */
+const MAX_SPOOL_AGE_MS = 14 * 24 * 60 * 60 * 1000; // 14 days
+/** Flush keeps at most this many files; the oldest beyond it are dropped. */
+const MAX_SPOOL_FILES = 50;
+/** Per-POST timeout — a single ship attempt must never stall longer than this. */
+const POST_TIMEOUT_MS = 3000;
+/** Absolute path to the spool directory. Computed at call time so tests that
+ *  repoint $HOME observe the change (matches startup-report.ts). */
+export function spoolDir() {
+    return join(homedir(), '.mx-agent', 'logs', 'startup', 'spool');
+}
+/**
+ * Write a report JSON string to the spool. Never throws. Returns the file path,
+ * or null if the write could not be performed (e.g. a read-only spool dir).
+ * Drops files older than 14 days first.
+ */
+export function spoolReport(reportJson) {
+    try {
+        const dir = spoolDir();
+        mkdirSync(dir, { recursive: true });
+        dropAgedFiles(dir);
+        const path = join(dir, `${randomUUID()}.json`);
+        writeFileSync(path, reportJson);
+        return path;
+    }
+    catch {
+        // Spooling is best-effort — a failure here is silently tolerated.
+        return null;
+    }
+}
+/** Remove spool files whose mtime is older than the age cap. Never throws. */
+function dropAgedFiles(dir) {
+    try {
+        const now = Date.now();
+        for (const f of readdirSync(dir)) {
+            if (!f.endsWith('.json'))
+                continue;
+            const p = join(dir, f);
+            try {
+                if (now - statSync(p).mtimeMs > MAX_SPOOL_AGE_MS)
+                    unlinkSync(p);
+            }
+            catch {
+                /* individual file error — skip it */
+            }
+        }
+    }
+    catch {
+        /* dir unreadable / absent — nothing to age out */
+    }
+}
+/** List spool files (basenames), oldest-first by mtime. Never throws. */
+function listSpoolFilesOldestFirst(dir) {
+    let names;
+    try {
+        names = readdirSync(dir).filter((f) => f.endsWith('.json'));
+    }
+    catch {
+        return [];
+    }
+    return names
+        .map((f) => {
+        try {
+            return { f, m: statSync(join(dir, f)).mtimeMs };
+        }
+        catch {
+            return { f, m: 0 };
+        }
+    })
+        .sort((a, b) => a.m - b.m)
+        .map((x) => x.f);
+}
+/**
+ * POST one spool file to the observability service. Returns true and deletes the
+ * file on a 2xx response. Any non-2xx, network error, or timeout returns false
+ * and leaves the file spooled. Never throws.
+ */
+export async function postSpoolFile(path, cfg) {
+    if (!cfg.apiToken)
+        return false; // no token → cannot ship
+    let body;
+    try {
+        body = readFileSync(path, 'utf-8');
+    }
+    catch {
+        return false; // file vanished (concurrent flush) — nothing to do
+    }
+    try {
+        const res = await fetch(`${cfg.apiUrl}/v1/startup-reports`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${cfg.apiToken}`,
+            },
+            body,
+            signal: AbortSignal.timeout(POST_TIMEOUT_MS),
+        });
+        if (res.ok) {
+            try {
+                unlinkSync(path);
+            }
+            catch {
+                /* already removed — fine */
+            }
+            return true;
+        }
+        return false; // 4xx/5xx — leave spooled for a later retry
+    }
+    catch {
+        return false; // network / timeout / abort — leave spooled
+    }
+}
+/**
+ * Flush the spool: POST every spooled report, deleting each on success.
+ *
+ * Enforces the 50-file cap first (drops the oldest beyond it, with a dim note if
+ * a logger is provided). If no token is configured the whole flush is skipped —
+ * files stay spooled so a later run with a token can retry. Never throws.
+ */
+export async function flushSpool(cfg) {
+    const dir = spoolDir();
+    let files = listSpoolFilesOldestFirst(dir);
+    // 50-file cap: drop the oldest beyond the cap so disk stays bounded.
+    if (files.length > MAX_SPOOL_FILES) {
+        const drop = files.slice(0, files.length - MAX_SPOOL_FILES);
+        for (const f of drop) {
+            try {
+                unlinkSync(join(dir, f));
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        if (cfg.log) {
+            cfg.log(`startup-report spool exceeded ${MAX_SPOOL_FILES} files — dropped ${drop.length} oldest`);
+        }
+        files = files.slice(files.length - MAX_SPOOL_FILES);
+    }
+    // No token → cannot ship anything. Leave the backlog for a later sync.
+    if (!cfg.apiToken) {
+        return { shipped: 0, remaining: files.length };
+    }
+    let shipped = 0;
+    for (const f of files) {
+        if (await postSpoolFile(join(dir, f), cfg))
+            shipped++;
+    }
+    const remaining = listSpoolFilesOldestFirst(dir).length;
+    return { shipped, remaining };
+}
+//# sourceMappingURL=startup-shipper.js.map

package/dist/lib/startup-shipper.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memnexus-ai/mx-agent-cli",
-  "version": "0.1.208",
+  "version": "0.1.209",
   "description": "CLI for creating and managing AI agent teams",
   "type": "module",
   "bin": {