@memnexus-ai/mx-agent-cli 0.1.166 → 0.1.168

package/dist/lib/coordination-client.d.ts

@@ -0,0 +1,74 @@
+/**
+ * coordination-client -- HTTP(S) client for the MX Agent Coordination Service.
+ *
+ * Talks to the standalone service's /enqueue, /drain, /ack endpoints over TLS
+ * with a per-team bearer token. Service URL + token are read from the mx-agent
+ * config store (same mechanism as observability-api-token) or the environment.
+ *
+ * Part of PR-B / FR-7 (CLI commands) of the agent coordination queue PRD.
+ */
+export type Priority = 'p0' | 'p1' | 'p2' | 'p3';
+export declare const CONFIG_KEY_URL = "coordination-service-url";
+export declare const CONFIG_KEY_TOKEN = "coordination-service-token";
+export interface EnqueueRequest {
+    to: string;
+    priority: Priority;
+    body: string;
+    from?: string;
+    idempotencyKey?: string;
+}
+export interface CoordinationMessage {
+    id: string;
+    from: string;
+    to: string;
+    priority: Priority;
+    body: string;
+    timestamp: string;
+}
+export interface DrainResponse {
+    messages: CoordinationMessage[];
+    remaining: number;
+    batchId: string;
+}
+/** The subset of service operations the CLI commands use. */
+export interface CoordinationClient {
+    enqueue(req: EnqueueRequest): Promise<{
+        messageId: string;
+        duplicate: boolean;
+    }>;
+    drain(opts: {
+        limit?: number;
+    }): Promise<DrainResponse>;
+    confirmDrain(batchId: string): Promise<void>;
+    ack(messageId: string): Promise<void>;
+}
+/** Thrown for a transport failure (service unreachable) — triggers the FR-8 fallback. */
+export declare class ServiceUnreachableError extends Error {
+    constructor(cause: unknown);
+}
+/** Thrown for an HTTP error response (the service answered, but non-2xx). */
+export declare class ServiceHttpError extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+export interface ClientConfig {
+    url: string;
+    token: string;
+}
+/** Resolve service URL + token from env (preferred) or the mx-agent config store. */
+export declare function resolveClientConfig(): ClientConfig;
+export declare class HttpCoordinationClient implements CoordinationClient {
+    private readonly config;
+    constructor(config: ClientConfig);
+    private request;
+    enqueue(req: EnqueueRequest): Promise<{
+        messageId: string;
+        duplicate: boolean;
+    }>;
+    drain(opts: {
+        limit?: number;
+    }): Promise<DrainResponse>;
+    confirmDrain(batchId: string): Promise<void>;
+    ack(messageId: string): Promise<void>;
+}
+//# sourceMappingURL=coordination-client.d.ts.map

package/dist/lib/coordination-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordination-client.d.ts","sourceRoot":"","sources":["../../src/lib/coordination-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEjD,eAAO,MAAM,cAAc,6BAA6B,CAAC;AACzD,eAAO,MAAM,gBAAgB,+BAA+B,CAAC;AAE7D,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,6DAA6D;AAC7D,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACjF,KAAK,CAAC,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACxD,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,yFAAyF;AACzF,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,KAAK,EAAE,OAAO;CAI3B;AAED,6EAA6E;AAC7E,qBAAa,gBAAiB,SAAQ,KAAK;aACb,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI5D;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qFAAqF;AACrF,wBAAgB,mBAAmB,IAAI,YAAY,CAUlD;AAED,qBAAa,sBAAuB,YAAW,kBAAkB;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,YAAY;YAEnC,OAAO;IAwBrB,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAIhF,KAAK,CAAC,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAIjD,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG5C"}

package/dist/lib/coordination-client.js

@@ -0,0 +1,83 @@
+/**
+ * coordination-client -- HTTP(S) client for the MX Agent Coordination Service.
+ *
+ * Talks to the standalone service's /enqueue, /drain, /ack endpoints over TLS
+ * with a per-team bearer token. Service URL + token are read from the mx-agent
+ * config store (same mechanism as observability-api-token) or the environment.
+ *
+ * Part of PR-B / FR-7 (CLI commands) of the agent coordination queue PRD.
+ */
+import { getConfigValue } from './config.js';
+export const CONFIG_KEY_URL = 'coordination-service-url';
+export const CONFIG_KEY_TOKEN = 'coordination-service-token';
+/** Thrown for a transport failure (service unreachable) — triggers the FR-8 fallback. */
+export class ServiceUnreachableError extends Error {
+    constructor(cause) {
+        super(`coordination service unreachable: ${cause instanceof Error ? cause.message : String(cause)}`);
+        this.name = 'ServiceUnreachableError';
+    }
+}
+/** Thrown for an HTTP error response (the service answered, but non-2xx). */
+export class ServiceHttpError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+        this.name = 'ServiceHttpError';
+    }
+}
+/** Resolve service URL + token from env (preferred) or the mx-agent config store. */
+export function resolveClientConfig() {
+    const url = process.env.MX_COORD_SERVICE_URL || getConfigValue(CONFIG_KEY_URL);
+    const token = process.env.MX_COORD_SERVICE_TOKEN || getConfigValue(CONFIG_KEY_TOKEN);
+    if (!url) {
+        throw new Error(`coordination service URL not set. Run: mx-agent config set ${CONFIG_KEY_URL} <https-url> (or set MX_COORD_SERVICE_URL)`);
+    }
+    if (!token) {
+        throw new Error(`coordination service token not set. Run: mx-agent config set ${CONFIG_KEY_TOKEN} <token> (or set MX_COORD_SERVICE_TOKEN)`);
+    }
+    return { url: url.replace(/\/+$/, ''), token };
+}
+export class HttpCoordinationClient {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async request(method, path, body) {
+        let res;
+        try {
+            res = await fetch(`${this.config.url}${path}`, {
+                method,
+                headers: {
+                    authorization: `Bearer ${this.config.token}`,
+                    'content-type': 'application/json',
+                },
+                body: body === undefined ? undefined : JSON.stringify(body),
+            });
+        }
+        catch (err) {
+            // Network-level failure (DNS, refused, TLS) → the service is unreachable.
+            throw new ServiceUnreachableError(err);
+        }
+        const text = await res.text();
+        const parsed = text ? JSON.parse(text) : {};
+        if (!res.ok) {
+            const msg = parsed.error ?? `HTTP ${res.status}`;
+            throw new ServiceHttpError(res.status, msg);
+        }
+        return parsed;
+    }
+    enqueue(req) {
+        return this.request('POST', '/enqueue', req);
+    }
+    drain(opts) {
+        return this.request('POST', '/drain', opts.limit === undefined ? {} : { limit: opts.limit });
+    }
+    async confirmDrain(batchId) {
+        await this.request('POST', '/drain/confirm', { batchId });
+    }
+    async ack(messageId) {
+        await this.request('POST', '/ack', { messageId });
+    }
+}
+//# sourceMappingURL=coordination-client.js.map

package/dist/lib/coordination-client.js.map

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

package/dist/lib/coordination-fallback.d.ts

@@ -0,0 +1,75 @@
+/**
+ * coordination-fallback -- FR-8 degraded-mode durable fallback for enqueue.
+ *
+ * When the coordination service is unreachable, `mx-agent escalate` writes the
+ * message ONLY to a local durable file in the worktree (never a network call),
+ * so the entry is non-lossy. On the next successful CLI invocation the file is
+ * flushed into the service under a single-flusher lease, each entry carrying an
+ * idempotency key so a re-run (or interrupted flush) is a server-side no-op.
+ *
+ * Hardening (KI-COORD-SF2): the fallback file is opened O_NOFOLLOW + O_CREAT,
+ * mode 0600, with per-entry atomic append (one line < PIPE_BUF under O_APPEND is
+ * atomic on POSIX). A pre-planted symlink is rejected (ELOOP).
+ *
+ * Part of PR-B / FR-8 of the agent coordination queue PRD.
+ */
+import type { CoordinationClient, Priority } from './coordination-client.js';
+export declare const FALLBACK_FILENAME = ".mx-coordination-fallback.jsonl";
+export declare const LEASE_FILENAME = ".mx-coordination-fallback.lock";
+export declare const CORRUPT_FILENAME = ".mx-coordination-fallback.corrupt.jsonl";
+export declare function corruptPath(root?: string): string;
+/** A queued-locally entry. `idempotencyKey` dedups a re-flush server-side. */
+export interface FallbackEntry {
+    team: string;
+    to: string;
+    priority: Priority;
+    body: string;
+    from?: string;
+    localTimestamp: string;
+    idempotencyKey: string;
+}
+export declare function worktreeRoot(): string;
+export declare function fallbackPath(root?: string): string;
+export declare function leasePath(root?: string): string;
+/** Idempotency key = team + localTimestamp + contentHash (matches the flush spec). */
+export declare function idempotencyKeyFor(team: string, localTimestamp: string, body: string): string;
+/**
+ * Append one entry to the fallback file with a single atomic write. Opens
+ * O_NOFOLLOW so a pre-planted symlink is rejected, O_CREAT|O_APPEND mode 0600.
+ */
+export declare function appendFallbackEntry(entry: Omit<FallbackEntry, 'localTimestamp' | 'idempotencyKey'> & {
+    localTimestamp?: string;
+}, path?: string): FallbackEntry;
+/**
+ * Read fallback entries, SKIP-AND-QUARANTINE corrupt lines (MAJOR-4): a single
+ * JSON-invalid line must not wedge the whole queue. Bad lines are appended to a
+ * sibling `.corrupt.jsonl` (0600) for manual inspection and a warning is printed
+ * to stderr; valid lines are returned. `corruptFile` is injectable for tests.
+ */
+export declare function readFallbackEntries(path?: string, corruptFile?: string): FallbackEntry[];
+/**
+ * Acquire the single-flusher lease (exclusive create). If a lease exists but is
+ * stale (older than staleMs), steal it — a crashed flusher must not wedge the
+ * queue. Returns true if acquired.
+ */
+export declare function acquireLease(path?: string, staleMs?: number): boolean;
+export declare function releaseLease(path?: string): void;
+export interface FlushResult {
+    flushed: number;
+    remaining: number;
+    skipped: boolean;
+}
+/**
+ * Flush queued-locally entries into the service under the single-flusher lease.
+ * Each entry is enqueued with its idempotency key; a re-flush of an already-sent
+ * entry is a server-side dedup no-op (the service treats dedup as
+ * fail-open-with-audit, which makes re-flush safe by design). Stops early if the
+ * service is still unreachable, leaving remaining entries on disk.
+ */
+export declare function flushFallback(client: CoordinationClient, opts?: {
+    fallbackPath?: string;
+    leasePath?: string;
+    corruptPath?: string;
+    staleMs?: number;
+}): Promise<FlushResult>;
+//# sourceMappingURL=coordination-fallback.d.ts.map

package/dist/lib/coordination-fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordination-fallback.d.ts","sourceRoot":"","sources":["../../src/lib/coordination-fallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAiBH,OAAO,KAAK,EAAE,kBAAkB,EAAkB,QAAQ,EAA2B,MAAM,0BAA0B,CAAC;AAEtH,eAAO,MAAM,iBAAiB,oCAAoC,CAAC;AACnE,eAAO,MAAM,cAAc,mCAAmC,CAAC;AAC/D,eAAO,MAAM,gBAAgB,4CAA4C,CAAC;AAE1E,wBAAgB,WAAW,CAAC,IAAI,GAAE,MAAuB,GAAG,MAAM,CAEjE;AAED,8EAA8E;AAC9E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,YAAY,CAAC,IAAI,GAAE,MAAuB,GAAG,MAAM,CAElE;AAED,wBAAgB,SAAS,CAAC,IAAI,GAAE,MAAuB,GAAG,MAAM,CAE/D;AAED,sFAAsF;AACtF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG5F;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,gBAAgB,GAAG,gBAAgB,CAAC,GAAG;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,EAC7F,IAAI,GAAE,MAAuB,GAC5B,aAAa,CAmBf;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,GAAE,MAAuB,EAC7B,WAAW,GAAE,MAAsB,GAClC,aAAa,EAAE,CAqCjB;AAUD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,GAAE,MAAoB,EAAE,OAAO,SAAS,GAAG,OAAO,CAyBlF;AAED,wBAAgB,YAAY,CAAC,IAAI,GAAE,MAAoB,GAAG,IAAI,CAM7D;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,kBAAkB,EAC1B,IAAI,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/F,OAAO,CAAC,WAAW,CAAC,CA+CtB"}

package/dist/lib/coordination-fallback.js

@@ -0,0 +1,224 @@
+/**
+ * coordination-fallback -- FR-8 degraded-mode durable fallback for enqueue.
+ *
+ * When the coordination service is unreachable, `mx-agent escalate` writes the
+ * message ONLY to a local durable file in the worktree (never a network call),
+ * so the entry is non-lossy. On the next successful CLI invocation the file is
+ * flushed into the service under a single-flusher lease, each entry carrying an
+ * idempotency key so a re-run (or interrupted flush) is a server-side no-op.
+ *
+ * Hardening (KI-COORD-SF2): the fallback file is opened O_NOFOLLOW + O_CREAT,
+ * mode 0600, with per-entry atomic append (one line < PIPE_BUF under O_APPEND is
+ * atomic on POSIX). A pre-planted symlink is rejected (ELOOP).
+ *
+ * Part of PR-B / FR-8 of the agent coordination queue PRD.
+ */
+import { openSync, writeSync, closeSync, fstatSync, fchmodSync, readFileSync, writeFileSync, existsSync, statSync, unlinkSync, constants as fsConstants, } from 'fs';
+import { join } from 'path';
+import { createHash } from 'crypto';
+export const FALLBACK_FILENAME = '.mx-coordination-fallback.jsonl';
+export const LEASE_FILENAME = '.mx-coordination-fallback.lock';
+export const CORRUPT_FILENAME = '.mx-coordination-fallback.corrupt.jsonl';
+export function corruptPath(root = worktreeRoot()) {
+    return join(root, CORRUPT_FILENAME);
+}
+export function worktreeRoot() {
+    return process.env.CLAUDE_WORKTREE_PATH || process.cwd();
+}
+export function fallbackPath(root = worktreeRoot()) {
+    return join(root, FALLBACK_FILENAME);
+}
+export function leasePath(root = worktreeRoot()) {
+    return join(root, LEASE_FILENAME);
+}
+/** Idempotency key = team + localTimestamp + contentHash (matches the flush spec). */
+export function idempotencyKeyFor(team, localTimestamp, body) {
+    const contentHash = createHash('sha256').update(body, 'utf8').digest('hex');
+    return `${team}:${localTimestamp}:${contentHash}`;
+}
+/**
+ * Append one entry to the fallback file with a single atomic write. Opens
+ * O_NOFOLLOW so a pre-planted symlink is rejected, O_CREAT|O_APPEND mode 0600.
+ */
+export function appendFallbackEntry(entry, path = fallbackPath()) {
+    const localTimestamp = entry.localTimestamp ?? new Date().toISOString();
+    const full = {
+        ...entry,
+        localTimestamp,
+        idempotencyKey: idempotencyKeyFor(entry.team, localTimestamp, entry.body),
+    };
+    const flags = fsConstants.O_WRONLY | fsConstants.O_CREAT | fsConstants.O_APPEND | fsConstants.O_NOFOLLOW;
+    const fd = openSync(path, flags, 0o600);
+    try {
+        // Tighten a pre-existing loose file (MINOR-5): if the file existed with
+        // group/other bits, fchmod it back to 0600 before writing the secret body.
+        const mode = fstatSync(fd).mode & 0o777;
+        if (mode & 0o077)
+            fchmodSync(fd, 0o600);
+        writeSync(fd, `${JSON.stringify(full)}\n`);
+    }
+    finally {
+        closeSync(fd);
+    }
+    return full;
+}
+/**
+ * Read fallback entries, SKIP-AND-QUARANTINE corrupt lines (MAJOR-4): a single
+ * JSON-invalid line must not wedge the whole queue. Bad lines are appended to a
+ * sibling `.corrupt.jsonl` (0600) for manual inspection and a warning is printed
+ * to stderr; valid lines are returned. `corruptFile` is injectable for tests.
+ */
+export function readFallbackEntries(path = fallbackPath(), corruptFile = corruptPath()) {
+    if (!existsSync(path))
+        return [];
+    const raw = readFileSync(path, 'utf8');
+    const good = [];
+    const corrupt = [];
+    for (const line of raw.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            good.push(JSON.parse(trimmed));
+        }
+        catch {
+            corrupt.push(trimmed);
+        }
+    }
+    if (corrupt.length > 0) {
+        const noun = `corrupt fallback entr${corrupt.length === 1 ? 'y' : 'ies'}`;
+        try {
+            // Same O_NOFOLLOW protection as the main file: never follow a pre-planted
+            // symlink at the quarantine path.
+            const flags = fsConstants.O_WRONLY | fsConstants.O_CREAT | fsConstants.O_APPEND | fsConstants.O_NOFOLLOW;
+            const fd = openSync(corruptFile, flags, 0o600);
+            try {
+                const mode = fstatSync(fd).mode & 0o777;
+                if (mode & 0o077)
+                    fchmodSync(fd, 0o600);
+                writeSync(fd, corrupt.join('\n') + '\n');
+            }
+            finally {
+                closeSync(fd);
+            }
+            process.stderr.write(`WARNING: ${corrupt.length} ${noun} quarantined to ${corruptFile} — inspect manually\n`);
+        }
+        catch (err) {
+            // Quarantine path is a symlink or unwritable — never follow, never crash.
+            // Surface the lost lines INLINE so nothing is silently dropped.
+            const code = err.code ?? 'error';
+            process.stderr.write(`WARNING: could not quarantine ${corrupt.length} ${noun} (${code}) to ${corruptFile} — NOT written; inline: ${corrupt.join(' | ')}\n`);
+        }
+    }
+    return good;
+}
+function writeFallbackEntries(entries, path) {
+    if (entries.length === 0) {
+        if (existsSync(path))
+            unlinkSync(path);
+        return;
+    }
+    writeFileSync(path, entries.map((e) => JSON.stringify(e)).join('\n') + '\n', { mode: 0o600 });
+}
+/**
+ * Acquire the single-flusher lease (exclusive create). If a lease exists but is
+ * stale (older than staleMs), steal it — a crashed flusher must not wedge the
+ * queue. Returns true if acquired.
+ */
+export function acquireLease(path = leasePath(), staleMs = 30_000) {
+    const flags = fsConstants.O_WRONLY | fsConstants.O_CREAT | fsConstants.O_EXCL | fsConstants.O_NOFOLLOW;
+    const tryCreate = () => {
+        try {
+            const fd = openSync(path, flags, 0o600);
+            writeSync(fd, JSON.stringify({ pid: process.pid, ts: new Date().toISOString() }));
+            closeSync(fd);
+            return true;
+        }
+        catch (err) {
+            if (err.code === 'EEXIST')
+                return false;
+            throw err;
+        }
+    };
+    if (tryCreate())
+        return true;
+    // Lease exists — steal it if stale.
+    try {
+        const age = Date.now() - statSync(path).mtimeMs;
+        if (age > staleMs) {
+            unlinkSync(path);
+            return tryCreate();
+        }
+    }
+    catch {
+        /* raced away — fall through to not-acquired */
+    }
+    return false;
+}
+export function releaseLease(path = leasePath()) {
+    try {
+        if (existsSync(path))
+            unlinkSync(path);
+    }
+    catch {
+        /* best effort */
+    }
+}
+/**
+ * Flush queued-locally entries into the service under the single-flusher lease.
+ * Each entry is enqueued with its idempotency key; a re-flush of an already-sent
+ * entry is a server-side dedup no-op (the service treats dedup as
+ * fail-open-with-audit, which makes re-flush safe by design). Stops early if the
+ * service is still unreachable, leaving remaining entries on disk.
+ */
+export async function flushFallback(client, opts = {}) {
+    const fp = opts.fallbackPath ?? fallbackPath();
+    const lp = opts.leasePath ?? leasePath();
+    const cp = opts.corruptPath ?? `${fp.replace(/\.jsonl$/, '')}.corrupt.jsonl`;
+    const entries = readFallbackEntries(fp, cp);
+    if (entries.length === 0)
+        return { flushed: 0, remaining: 0, skipped: false };
+    if (!acquireLease(lp, opts.staleMs)) {
+        return { flushed: 0, remaining: entries.length, skipped: true };
+    }
+    let flushed = 0;
+    try {
+        // Re-read under the lease so we do not clobber entries a prior holder wrote.
+        const held = readFallbackEntries(fp, cp);
+        const remaining = [];
+        let stillDown = false;
+        for (const entry of held) {
+            if (stillDown) {
+                remaining.push(entry);
+                continue;
+            }
+            try {
+                const req = {
+                    to: entry.to,
+                    priority: entry.priority,
+                    body: entry.body,
+                    from: entry.from ?? entry.team,
+                    idempotencyKey: entry.idempotencyKey,
+                };
+                await client.enqueue(req);
+                flushed++;
+            }
+            catch (err) {
+                if (err?.name === 'ServiceUnreachableError') {
+                    // Still down — keep this and all following entries for the next flush.
+                    stillDown = true;
+                    remaining.push(entry);
+                }
+                else {
+                    throw err; // a real HTTP error is not a transient outage
+                }
+            }
+        }
+        writeFallbackEntries(remaining, fp);
+        return { flushed, remaining: remaining.length, skipped: false };
+    }
+    finally {
+        releaseLease(lp);
+    }
+}
+//# sourceMappingURL=coordination-fallback.js.map

package/dist/lib/coordination-fallback.js.map

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

package/dist/lib/project-config.d.ts

@@ -24,6 +24,13 @@ export interface ProjectConfig {
      * Default: '' (no prefix — backwards compatible with the MemNexus monorepo).
      */
     projectSlug?: string;
+    /**
+     * Project-appropriate observability API URL (e.g. the dev observability
+     * endpoint). When set, `mx-agent config-sync --apply` seeds the operator's
+     * `observability-api-url` config from it if that key is not already set.
+     * Default: '' (unset — the CLI falls back to its own default).
+     */
+    observabilityApiUrl?: string;
 }
 export declare const PROJECT_CONFIG_DEFAULTS: Required<ProjectConfig>;
 /**

package/dist/lib/project-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-config.d.ts","sourceRoot":"","sources":["../../src/lib/project-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qGAAqG;IACrG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iGAAiG;IACjG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,aAAa,CAO3D,CAAC;AA4BF;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAqB3E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,CASrF"}
+{"version":3,"file":"project-config.d.ts","sourceRoot":"","sources":["../../src/lib/project-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qGAAqG;IACrG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iGAAiG;IACjG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,aAAa,CAQ3D,CAAC;AA4BF;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAsB3E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,CAUrF"}

package/dist/lib/project-config.js

@@ -15,6 +15,7 @@ export const PROJECT_CONFIG_DEFAULTS = {
     teamsDir: 'mx-agent-system/teams',
     roleguidesDir: 'mx-agent-system/roleguides',
     projectSlug: '',
+    observabilityApiUrl: '',
 };
 /** Characters that must not appear in config values used in shell commands */
 const SHELL_UNSAFE_RE = /[;|&`$(){}!#\\<>\n\r\x00]/;
@@ -66,6 +67,8 @@ export function loadProjectConfig(projectRoot) {
             config.roleguidesDir = parsed.roleguidesDir;
         if (typeof parsed.projectSlug === 'string')
             config.projectSlug = parsed.projectSlug;
+        if (typeof parsed.observabilityApiUrl === 'string')
+            config.observabilityApiUrl = parsed.observabilityApiUrl;
     }
     catch {
         return null;
@@ -89,6 +92,7 @@ export function resolveProjectConfig(c) {
         teamsDir: c?.teamsDir ?? PROJECT_CONFIG_DEFAULTS.teamsDir,
         roleguidesDir: c?.roleguidesDir ?? PROJECT_CONFIG_DEFAULTS.roleguidesDir,
         projectSlug: c?.projectSlug ?? PROJECT_CONFIG_DEFAULTS.projectSlug,
+        observabilityApiUrl: c?.observabilityApiUrl ?? PROJECT_CONFIG_DEFAULTS.observabilityApiUrl,
     };
 }
 //# sourceMappingURL=project-config.js.map

package/dist/lib/project-config.js.map

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

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@memnexus-ai/mx-agent-cli",
-  "version": "0.1.166",
+  "version": "0.1.168",
   "description": "CLI for creating and managing AI agent teams",
   "type": "module",
   "bin": {
     "mx-agent": "./dist/index.js"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && node scripts/bundle-config.mjs",
     "dev": "tsc --watch",
     "start": "node dist/index.js",
     "prepublishOnly": "npm run build",