@aquex/cmos-mcp 1.0.0

package/dist/tools/cmos/sync-pusher.js

@@ -0,0 +1,248 @@
+"use strict";
+/**
+ * Sync Pusher — Queue-Backed Event Push to Dashboard
+ *
+ * Registers as a sync hook listener and pushes events to the dashboard API
+ * via DashboardClient. When a SyncQueue is provided, events are persisted
+ * to SQLite before push, surviving MCP restarts.
+ *
+ * Key properties:
+ * - Non-blocking: push happens asynchronously, tool operations never wait
+ * - No-op when dashboard is not configured (DashboardClient.fromEnv() fails)
+ * - Error-resilient: network failures log a warning, never throw
+ * - Queue-backed: events survive MCP restarts when SyncQueue is provided
+ * - Backward-compatible: works without queue (fire-and-forget fallback)
+ * - Tracks push stats for diagnostics
+ *
+ * @module tools/cmos/sync-pusher
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SyncPusher = void 0;
+exports.setActiveSyncPusher = setActiveSyncPusher;
+exports.getSyncStatus = getSyncStatus;
+const dashboard_client_1 = require("./dashboard-client");
+const sync_hooks_1 = require("./sync-hooks");
+const sync_event_payloads_1 = require("./sync-event-payloads");
+/** Default retry configuration (used for direct push fallback) */
+const DEFAULT_MAX_RETRIES = 1;
+const DEFAULT_RETRY_DELAY_MS = 1000;
+/** Delay before auto-drain after enqueue (ms) — batches rapid writes */
+const DRAIN_DEBOUNCE_MS = 100;
+// ─── SyncPusher ──────────────────────────────────────────────────────────────
+class SyncPusher {
+    constructor(client, identity, options) {
+        this.dispose = null;
+        /** Drain timer for debouncing rapid enqueues */
+        this.drainTimer = null;
+        /** In-memory push statistics */
+        this.stats = {
+            totalPushed: 0,
+            totalFailed: 0,
+            totalRetried: 0,
+            lastPushAt: null,
+            lastFailureAt: null,
+            lastFailureMessage: null,
+        };
+        this.client = client;
+        this.identity = identity;
+        this.maxRetries = options?.maxRetries ?? DEFAULT_MAX_RETRIES;
+        this.retryDelayMs = options?.retryDelayMs ?? DEFAULT_RETRY_DELAY_MS;
+        this.queue = options?.queue ?? null;
+    }
+    /**
+     * Try to create a SyncPusher from environment variables.
+     * Returns null if dashboard is not configured (no-op path).
+     *
+     * @param identity - Project identity for the envelope
+     * @param queue - Optional persistent sync queue
+     * @returns SyncPusher instance or null
+     */
+    static fromEnv(identity, queue) {
+        const clientResult = dashboard_client_1.DashboardClient.fromEnv();
+        if (!clientResult.success || !clientResult.data) {
+            return null;
+        }
+        return new SyncPusher(clientResult.data, identity, { queue });
+    }
+    /**
+     * Register this pusher as a sync hook listener.
+     * Events will be queued (if queue available) or pushed fire-and-forget.
+     */
+    start() {
+        if (this.dispose)
+            return; // Already started
+        this.dispose = sync_hooks_1.syncHooks.register((event) => this.handleEvent(event));
+    }
+    /**
+     * Unregister from sync hooks and stop pushing.
+     */
+    stop() {
+        if (this.dispose) {
+            this.dispose();
+            this.dispose = null;
+        }
+        if (this.drainTimer) {
+            clearTimeout(this.drainTimer);
+            this.drainTimer = null;
+        }
+    }
+    /**
+     * Whether the pusher is currently active (registered as listener).
+     */
+    get isActive() {
+        return this.dispose !== null;
+    }
+    /**
+     * Whether the pusher is backed by a persistent queue.
+     */
+    get hasQueue() {
+        return this.queue !== null;
+    }
+    /**
+     * Drain pending events from the queue.
+     * Call this on startup to recover events from prior runs.
+     * Returns null if no queue is configured.
+     */
+    async drainQueue() {
+        if (!this.queue)
+            return null;
+        const result = await this.queue.drain(this.client);
+        // Update stats from drain result
+        this.stats.totalPushed += result.succeeded;
+        this.stats.totalFailed += result.failed;
+        if (result.succeeded > 0) {
+            this.stats.lastPushAt = new Date().toISOString();
+        }
+        if (result.failed > 0) {
+            this.stats.lastFailureAt = new Date().toISOString();
+            this.stats.lastFailureMessage = result.errors[result.errors.length - 1] ?? null;
+        }
+        return result;
+    }
+    /**
+     * Handle a sync event by building the payload and either queuing or pushing.
+     * This is the hook listener callback — it must never throw.
+     */
+    handleEvent(event) {
+        // Build typed payload from the event
+        const data = (0, sync_event_payloads_1.buildPayloadForEvent)(event.type, event.payload);
+        const envelope = {
+            projectId: this.identity.projectId,
+            projectName: this.identity.projectName,
+            eventType: event.type,
+            timestamp: event.timestamp,
+            data,
+        };
+        if (this.queue) {
+            // Queue-backed path: write to SQLite first (synchronous, <1ms)
+            try {
+                this.queue.enqueue(envelope);
+                this.scheduleDrain();
+            }
+            catch (error) {
+                // Queue write failed — fall back to direct push
+                console.warn(`[sync-pusher] Queue write failed for ${event.type}, falling back to direct push:`, error instanceof Error ? error.message : error);
+                this.pushAsync(envelope);
+            }
+        }
+        else {
+            // Legacy path: fire-and-forget direct push
+            this.pushAsync(envelope);
+        }
+    }
+    /**
+     * Schedule an async drain after a short debounce.
+     * Batches rapid enqueues to avoid per-event HTTP calls.
+     */
+    scheduleDrain() {
+        if (this.drainTimer)
+            return; // Already scheduled
+        this.drainTimer = setTimeout(() => {
+            this.drainTimer = null;
+            // Fire-and-forget drain
+            this.drainQueue().catch((error) => {
+                console.warn('[sync-pusher] Drain error:', error instanceof Error ? error.message : error);
+            });
+        }, DRAIN_DEBOUNCE_MS);
+    }
+    /**
+     * Async push with retry logic (legacy path). Not awaited by the caller.
+     * Retries on server errors (5xx) up to maxRetries times with delay.
+     */
+    pushAsync(envelope) {
+        this.pushWithRetry(envelope, 0);
+    }
+    pushWithRetry(envelope, attempt) {
+        this.client
+            .pushSyncEvent(envelope)
+            .then((result) => {
+            if (result.success) {
+                if (attempt > 0) {
+                    this.stats.totalRetried++;
+                }
+                this.stats.totalPushed++;
+                this.stats.lastPushAt = new Date().toISOString();
+            }
+            else if (this.isRetryable(result.error?.code) && attempt < this.maxRetries) {
+                console.warn(`[sync-pusher] Push failed for ${envelope.eventType} (attempt ${attempt + 1}/${this.maxRetries + 1}), retrying...`);
+                setTimeout(() => this.pushWithRetry(envelope, attempt + 1), this.retryDelayMs);
+            }
+            else {
+                this.stats.totalFailed++;
+                this.stats.lastFailureAt = new Date().toISOString();
+                this.stats.lastFailureMessage = result.error?.message ?? 'Unknown push error';
+                console.warn(`[sync-pusher] Push failed for ${envelope.eventType}:`, result.error?.message);
+            }
+        })
+            .catch((error) => {
+            if (attempt < this.maxRetries) {
+                console.warn(`[sync-pusher] Network error pushing ${envelope.eventType} (attempt ${attempt + 1}/${this.maxRetries + 1}), retrying...`);
+                setTimeout(() => this.pushWithRetry(envelope, attempt + 1), this.retryDelayMs);
+            }
+            else {
+                this.stats.totalFailed++;
+                this.stats.lastFailureAt = new Date().toISOString();
+                this.stats.lastFailureMessage = error instanceof Error ? error.message : 'Unknown error';
+                console.warn(`[sync-pusher] Unexpected error pushing ${envelope.eventType}:`, error instanceof Error ? error.message : error);
+            }
+        });
+    }
+    /** Determine if an error code is retryable (server errors, not client errors) */
+    isRetryable(code) {
+        if (!code)
+            return true; // Unknown errors are retryable
+        // Retry server errors, not client errors (auth, validation, not found)
+        const nonRetryable = [
+            'DASHBOARD_AUTH_FAILED',
+            'DASHBOARD_FORBIDDEN',
+            'DASHBOARD_NOT_FOUND',
+            'DASHBOARD_NOT_CONFIGURED',
+        ];
+        return !nonRetryable.includes(code);
+    }
+}
+exports.SyncPusher = SyncPusher;
+// ─── Module-level accessor for diagnostics ────────────────────────────────
+/** Active SyncPusher instance (set when started in main()). */
+let activePusher = null;
+/**
+ * Set the active SyncPusher instance.
+ * Called from main() after creating and starting the pusher.
+ */
+function setActiveSyncPusher(pusher) {
+    activePusher = pusher;
+}
+/**
+ * Get the sync status for diagnostics (used by cmos_agent_onboard).
+ * Returns null if sync is not configured (no dashboard env vars).
+ */
+function getSyncStatus() {
+    if (!activePusher)
+        return null;
+    return {
+        active: activePusher.isActive,
+        queueBacked: activePusher.hasQueue,
+        stats: { ...activePusher.stats },
+    };
+}
+//# sourceMappingURL=sync-pusher.js.map

package/dist/tools/cmos/sync-pusher.js.map

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

package/dist/tools/cmos/sync-queue.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Persistent Sync Event Queue
+ *
+ * WAL-backed SQLite queue that persists sync events before HTTP push.
+ * Replaces fire-and-forget in-memory push with durable, restart-safe delivery.
+ *
+ * Key properties:
+ * - Events are written to SQLite before any push attempt (write-ahead)
+ * - Pending events survive MCP restarts and are drained on startup
+ * - Failed events stay in queue with attempt count and error info
+ * - Successfully pushed events are cleaned up automatically
+ * - Non-blocking: enqueue is synchronous SQLite write (<1ms), drain is async
+ *
+ * @module tools/cmos/sync-queue
+ */
+import type { SyncEventEnvelope } from './sync-event-payloads';
+import { DashboardClient } from './dashboard-client';
+export interface QueueEntry {
+    id: number;
+    event_type: string;
+    envelope: string;
+    status: 'pending' | 'pushed' | 'failed';
+    attempts: number;
+    created_at: string;
+    pushed_at: string | null;
+    last_error: string | null;
+}
+export interface QueueStats {
+    pending: number;
+    pushed: number;
+    failed: number;
+    total: number;
+    oldestPendingAt: string | null;
+}
+export interface DrainResult {
+    drained: number;
+    succeeded: number;
+    failed: number;
+    errors: string[];
+}
+export declare class SyncQueue {
+    private db;
+    private readonly stmts;
+    private readonly maxAttempts;
+    private readonly drainBatchSize;
+    private draining;
+    constructor(dbPath: string, options?: {
+        maxAttempts?: number;
+        drainBatchSize?: number;
+    });
+    /**
+     * Enqueue a sync event for durable delivery.
+     * Synchronous — SQLite write is <1ms, safe to call from hook listener.
+     */
+    enqueue(envelope: SyncEventEnvelope): number;
+    /**
+     * Drain pending events from the queue, pushing each to the dashboard.
+     * Returns when the batch is complete.
+     *
+     * Concurrency-safe: only one drain runs at a time.
+     */
+    drain(client: DashboardClient): Promise<DrainResult>;
+    /**
+     * Get count of pending events ready for drain.
+     */
+    getPendingCount(): number;
+    /**
+     * Get queue statistics for diagnostics.
+     */
+    getStats(): QueueStats;
+    /**
+     * Clean up old pushed/failed entries.
+     * Default: remove pushed events older than 24h and failed events older than 24h.
+     */
+    cleanup(maxAgeMs?: number): number;
+    /**
+     * Whether a drain is currently in progress.
+     */
+    get isDraining(): boolean;
+    /**
+     * Close the database connection.
+     */
+    close(): void;
+    /** Check if an error code is non-retryable (auth, not found, etc.) */
+    private isNonRetryable;
+}
+//# sourceMappingURL=sync-queue.d.ts.map

package/dist/tools/cmos/sync-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-queue.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/sync-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAIrD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AA+BD,qBAAa,SAAS;IACpB,OAAO,CAAC,EAAE,CAAe;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CASpB;IAEF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAS;gBAGvB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB;IAuDH;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM;IAO5C;;;;;OAKG;IACG,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IAwD1D;;OAEG;IACH,eAAe,IAAI,MAAM;IAOzB;;OAEG;IACH,QAAQ,IAAI,UAAU;IAsBtB;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM;IAOlC;;OAEG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb,sEAAsE;IACtE,OAAO,CAAC,cAAc;CAUvB"}

package/dist/tools/cmos/sync-queue.js

@@ -0,0 +1,208 @@
+"use strict";
+/**
+ * Persistent Sync Event Queue
+ *
+ * WAL-backed SQLite queue that persists sync events before HTTP push.
+ * Replaces fire-and-forget in-memory push with durable, restart-safe delivery.
+ *
+ * Key properties:
+ * - Events are written to SQLite before any push attempt (write-ahead)
+ * - Pending events survive MCP restarts and are drained on startup
+ * - Failed events stay in queue with attempt count and error info
+ * - Successfully pushed events are cleaned up automatically
+ * - Non-blocking: enqueue is synchronous SQLite write (<1ms), drain is async
+ *
+ * @module tools/cmos/sync-queue
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SyncQueue = void 0;
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+// ─── Constants ───────────────────────────────────────────────────────────────
+const CREATE_TABLE_SQL = `
+CREATE TABLE IF NOT EXISTS sync_event_queue (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  event_type TEXT NOT NULL,
+  envelope TEXT NOT NULL,
+  status TEXT NOT NULL DEFAULT 'pending',
+  attempts INTEGER NOT NULL DEFAULT 0,
+  created_at TEXT NOT NULL,
+  pushed_at TEXT,
+  last_error TEXT
+)`;
+const CREATE_INDEX_SQL = `
+CREATE INDEX IF NOT EXISTS idx_sync_queue_status
+ON sync_event_queue (status, created_at)`;
+/** Max events to drain in a single batch to avoid overwhelming the dashboard */
+const DEFAULT_DRAIN_BATCH_SIZE = 50;
+/** Max total attempts before marking as permanently failed */
+const DEFAULT_MAX_ATTEMPTS = 5;
+/** Events older than this (ms) are eligible for cleanup */
+const DEFAULT_CLEANUP_AGE_MS = 24 * 60 * 60 * 1000; // 24 hours
+// ─── SyncQueue ───────────────────────────────────────────────────────────────
+class SyncQueue {
+    constructor(dbPath, options) {
+        this.draining = false;
+        this.maxAttempts = options?.maxAttempts ?? DEFAULT_MAX_ATTEMPTS;
+        this.drainBatchSize = options?.drainBatchSize ?? DEFAULT_DRAIN_BATCH_SIZE;
+        this.db = new better_sqlite3_1.default(dbPath);
+        this.db.pragma('journal_mode = WAL');
+        this.db.pragma('foreign_keys = ON');
+        // Ensure table exists (idempotent)
+        this.db.exec(CREATE_TABLE_SQL);
+        this.db.exec(CREATE_INDEX_SQL);
+        // Prepare statements for performance
+        this.stmts = {
+            enqueue: this.db.prepare(`INSERT INTO sync_event_queue (event_type, envelope, status, attempts, created_at)
+         VALUES (?, ?, 'pending', 0, ?)`),
+            getPending: this.db.prepare(`SELECT id, event_type, envelope, status, attempts, created_at, pushed_at, last_error
+         FROM sync_event_queue
+         WHERE status = 'pending' AND attempts < ?
+         ORDER BY created_at ASC
+         LIMIT ?`),
+            markPushed: this.db.prepare(`UPDATE sync_event_queue
+         SET status = 'pushed', pushed_at = ?, attempts = attempts + 1
+         WHERE id = ?`),
+            markFailed: this.db.prepare(`UPDATE sync_event_queue
+         SET status = CASE WHEN attempts + 1 >= ? THEN 'failed' ELSE 'pending' END,
+             attempts = attempts + 1,
+             last_error = ?
+         WHERE id = ?`),
+            cleanup: this.db.prepare(`DELETE FROM sync_event_queue
+         WHERE (status = 'pushed' AND pushed_at < ?)
+            OR (status = 'failed' AND created_at < ?)`),
+            countByStatus: this.db.prepare(`SELECT status, COUNT(*) as count FROM sync_event_queue GROUP BY status`),
+            oldestPending: this.db.prepare(`SELECT MIN(created_at) as oldest FROM sync_event_queue WHERE status = 'pending'`),
+            totalCount: this.db.prepare(`SELECT COUNT(*) as count FROM sync_event_queue`),
+        };
+    }
+    /**
+     * Enqueue a sync event for durable delivery.
+     * Synchronous — SQLite write is <1ms, safe to call from hook listener.
+     */
+    enqueue(envelope) {
+        const json = JSON.stringify(envelope);
+        const now = new Date().toISOString();
+        const result = this.stmts.enqueue.run(envelope.eventType, json, now);
+        return Number(result.lastInsertRowid);
+    }
+    /**
+     * Drain pending events from the queue, pushing each to the dashboard.
+     * Returns when the batch is complete.
+     *
+     * Concurrency-safe: only one drain runs at a time.
+     */
+    async drain(client) {
+        if (this.draining) {
+            return { drained: 0, succeeded: 0, failed: 0, errors: ['Drain already in progress'] };
+        }
+        this.draining = true;
+        const result = { drained: 0, succeeded: 0, failed: 0, errors: [] };
+        try {
+            const pending = this.stmts.getPending.all(this.maxAttempts, this.drainBatchSize);
+            result.drained = pending.length;
+            for (const entry of pending) {
+                try {
+                    const envelope = JSON.parse(entry.envelope);
+                    const pushResult = await client.pushSyncEvent(envelope);
+                    if (pushResult.success) {
+                        this.stmts.markPushed.run(new Date().toISOString(), entry.id);
+                        result.succeeded++;
+                    }
+                    else {
+                        const errorMsg = pushResult.error?.message ?? 'Unknown push error';
+                        const errorCode = pushResult.error?.code;
+                        // Non-retryable errors get max attempts immediately
+                        if (this.isNonRetryable(errorCode)) {
+                            this.db.prepare(`UPDATE sync_event_queue SET status = 'failed', attempts = ?, last_error = ? WHERE id = ?`).run(this.maxAttempts, errorMsg, entry.id);
+                        }
+                        else {
+                            this.stmts.markFailed.run(this.maxAttempts, errorMsg, entry.id);
+                        }
+                        result.failed++;
+                        result.errors.push(`${entry.event_type}: ${errorMsg}`);
+                    }
+                }
+                catch (error) {
+                    const errorMsg = error instanceof Error ? error.message : 'Unknown error';
+                    this.stmts.markFailed.run(this.maxAttempts, errorMsg, entry.id);
+                    result.failed++;
+                    result.errors.push(`${entry.event_type}: ${errorMsg}`);
+                }
+            }
+        }
+        finally {
+            this.draining = false;
+        }
+        return result;
+    }
+    /**
+     * Get count of pending events ready for drain.
+     */
+    getPendingCount() {
+        const row = this.db.prepare(`SELECT COUNT(*) as count FROM sync_event_queue WHERE status = 'pending' AND attempts < ?`).get(this.maxAttempts);
+        return row.count;
+    }
+    /**
+     * Get queue statistics for diagnostics.
+     */
+    getStats() {
+        const counts = this.stmts.countByStatus.all();
+        const oldest = this.stmts.oldestPending.get();
+        const total = this.stmts.totalCount.get();
+        const stats = {
+            pending: 0,
+            pushed: 0,
+            failed: 0,
+            total: total.count,
+            oldestPendingAt: oldest.oldest,
+        };
+        for (const row of counts) {
+            if (row.status === 'pending')
+                stats.pending = row.count;
+            else if (row.status === 'pushed')
+                stats.pushed = row.count;
+            else if (row.status === 'failed')
+                stats.failed = row.count;
+        }
+        return stats;
+    }
+    /**
+     * Clean up old pushed/failed entries.
+     * Default: remove pushed events older than 24h and failed events older than 24h.
+     */
+    cleanup(maxAgeMs) {
+        const age = maxAgeMs ?? DEFAULT_CLEANUP_AGE_MS;
+        const cutoff = new Date(Date.now() - age).toISOString();
+        const result = this.stmts.cleanup.run(cutoff, cutoff);
+        return result.changes;
+    }
+    /**
+     * Whether a drain is currently in progress.
+     */
+    get isDraining() {
+        return this.draining;
+    }
+    /**
+     * Close the database connection.
+     */
+    close() {
+        this.db.close();
+    }
+    /** Check if an error code is non-retryable (auth, not found, etc.) */
+    isNonRetryable(code) {
+        if (!code)
+            return false;
+        const nonRetryable = [
+            'DASHBOARD_AUTH_FAILED',
+            'DASHBOARD_FORBIDDEN',
+            'DASHBOARD_NOT_FOUND',
+            'DASHBOARD_NOT_CONFIGURED',
+        ];
+        return nonRetryable.includes(code);
+    }
+}
+exports.SyncQueue = SyncQueue;
+//# sourceMappingURL=sync-queue.js.map

package/dist/tools/cmos/sync-queue.js.map

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

package/dist/tools/cmos/tier-config.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Tier Config Loader
+ *
+ * Reads and parses tier configuration files from cmos/tiers/{tierName}.md.
+ * Returns structured frontmatter + prose body for injection into onboard payload.
+ *
+ * @module tools/cmos/tier-config
+ */
+export interface TierConfig {
+    tier: string;
+    label: string;
+    description: string;
+    toolsUse: string[];
+    toolsSkip: string[];
+    vocabulary: Record<string, string | null>;
+    sessionTypes: string[];
+    onboardFieldsShow: string[];
+    onboardFieldsHide: string[];
+    guide: string;
+}
+/**
+ * Load a tier config from cmos/tiers/{tierName}.md.
+ *
+ * Parses YAML frontmatter for structured fields and returns the prose body as guide.
+ * Falls back to build.md if the requested tier file doesn't exist.
+ *
+ * @param tierName - 'general', 'managed', or 'build'
+ * @param serverRoot - Root directory of the server (defaults to __dirname/../../..)
+ * @returns Parsed tier config or null if even fallback fails
+ */
+export declare function loadTierConfig(tierName: string, serverRoot?: string): TierConfig | null;
+//# sourceMappingURL=tier-config.d.ts.map

package/dist/tools/cmos/tier-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier-config.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/tier-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IAC1C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAoBvF"}